Content Pool — MCP & AgencyOS
Stand: 2026-10-17 · Status: MVP + Batch-Import (Phase 2, mandantenübergreifend)
Nutzer-Doku: Content Pool im Dashboard (Organisations-Filter, Import-Dialog mit OK/Fehler, mandantenübergreifende Replikation)
REST
Basis Dashboard-Session: /api/content-pool
AgencyOS v1: {ORIGIN}/api/agencyos/v1/content-pool (Bearer API-Key)
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /content-pool/schema | JSON-Schema (nur AgencyOS) |
| GET | /content-pool | Liste (Filter siehe unten) |
| POST | /content-pool | Anlegen |
| GET | /content-pool/{packageId} | Detail inkl. Assets |
| PATCH | /content-pool/{packageId} | Partial Update |
| DELETE | /content-pool/{packageId} | Paket löschen (Mediathek bleibt) |
| POST | /content-pool/{packageId}/assets | Medien anhängen |
| POST | /content-pool/import | Batch-Import (CSV, JSONL, packages[], optional manifest) — dryRun default true; importTarget: org (Standard) oder catalog (globaler Katalog, Plattform-Rollen / globaler Key); optional replicateToAllOrgsWithChain nur bei org |
Globaler Katalog (Phase 0, ohne organizationId)
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /content-pool/catalog | Liste (chainId, centerId, activeOn, q, status, limit, offset) |
| GET | /content-pool/catalog/{entryId} | Detail inkl. Assets und Center-Scope |
| PATCH | /content-pool/catalog/{entryId} | Partial Update |
| DELETE | /content-pool/catalog/{entryId} | Löschen — gleiche Rollen wie Anlegen |
| POST | /content-pool/catalog | Anlegen — Dashboard: SUPER_ADMIN, PLATFORM_ADMIN, DEVELOPER; AgencyOS: nur globaler API-Key |
- Lesen: Plattform-Rollen / globaler Key sehen alle Status; Org-Rollen und Org-/User-Keys nur
status=active(Entwürfe liefern 404). centerId: Kette hat mindestens eine Filiale im Center (org-übergreifend) oder Center steht inexplicit_centers. Filial-Aktivität am Stichtag (wie LegacyactiveOn) folgt in Phase 1.- Medien:
assets[]miturl(CDN); Mediathek-IDs sind org-gebunden — Medien-Strategie in Phase 1/2. - Legacy:
/content-pool(Org-Pakete) und News mitcontentPoolPackageIdbleiben unverändert. - Schema für Agenten: Abschnitt
cataloginGET /content-pool/schema.
Query-Parameter (Liste)
| Parameter | Beschreibung |
|---|---|
organizationId | Org-UUID |
chainId | Shop-Kette |
centerId | Wirksamkeit für Center (Scope + Filiale) |
activeOn | ISO-Datum |
q | Titel/Text |
status | draft | active | archived |
MCP-Tools
Kategorie: content-pool
cockpit_content_pool_schemacockpit_content_pool_listcockpit_content_pool_getcockpit_content_pool_createcockpit_content_pool_updatecockpit_content_pool_attach_assetscockpit_content_pool_import_batchcockpit_content_pool_catalog_list/_get/_create— SMG-globaler Katalog
Medien: zuerst cockpit_upload_media, dann attach_assets.
Noco Mietercontent: lokale Skripte unter scripts/content-pool/ (siehe README dort).
Import-Body (Beispiel)
{
"organizationId": "uuid",
"dryRun": true,
"csv": "Id;Titel;Marke;…",
"manifest": { "version": 1, "entries": [] },
"defaultStatus": "draft"
}
Mandantenübergreifend (globaler API-Key, replicateToAllOrgsWithChain: true):
{
"dryRun": true,
"replicateToAllOrgsWithChain": true,
"csv": "Id;Titel;Marke;…"
}
Globaler Katalog (globaler API-Key, importTarget: "catalog"):
{
"importTarget": "catalog",
"dryRun": true,
"csv": "Id;Titel;Marke;…"
}
organizationId optional — Primär-Mandant nur für Ketten-Mapping/Vorschau (Org-Import). Antwort: summary, rows[] (bei Replikation replicateTargets[]; bei Katalog duplicateOfCatalogEntryId), createdCatalogEntryIds[] nach Live-Import.
Datenmodell
| Tabelle | Zweck |
|---|---|
content_pool_packages | Org, Titel, shop_chain_id, center_scope, Gültigkeit, Status |
content_pool_assets | Medien-Referenzen (media_file_id, URL, Rolle) |
content_pool_package_centers | M:N bei explicit_centers |
content_pool_catalog_entries | Globaler Katalog-Eintrag (ohne Org), Kette, Gültigkeit, Status, version |
content_pool_catalog_assets | Katalog-Medien (URL, optional media_file_id) |
content_pool_catalog_entry_centers | M:N bei explicit_centers |
content_pool_packages hat zusätzlich nullable catalog_entry_id / catalog_snapshot_version (Phase 0 ungenutzt, kein Backfill).
Migrationen: packages/database/migrations/20261015180000_add_content_pool_SAFE.sql, …/20261017120000_content_pool_catalog_phase0_SAFE.sql (expand-only)
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /developer-guide/content-pool-mcp