Skip to main content

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)

MethodePfadBeschreibung
GET/content-pool/schemaJSON-Schema (nur AgencyOS)
GET/content-poolListe (Filter siehe unten)
POST/content-poolAnlegen
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}/assetsMedien anhängen
POST/content-pool/importBatch-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)​

MethodePfadBeschreibung
GET/content-pool/catalogListe (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/catalogAnlegen — 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 in explicit_centers. Filial-Aktivität am Stichtag (wie Legacy activeOn) folgt in Phase 1.
  • Medien: assets[] mit url (CDN); Mediathek-IDs sind org-gebunden — Medien-Strategie in Phase 1/2.
  • Legacy: /content-pool (Org-Pakete) und News mit contentPoolPackageId bleiben unverändert.
  • Schema für Agenten: Abschnitt catalog in GET /content-pool/schema.

Query-Parameter (Liste)​

ParameterBeschreibung
organizationIdOrg-UUID
chainIdShop-Kette
centerIdWirksamkeit für Center (Scope + Filiale)
activeOnISO-Datum
qTitel/Text
statusdraft | active | archived

MCP-Tools​

Kategorie: content-pool

  • cockpit_content_pool_schema
  • cockpit_content_pool_list
  • cockpit_content_pool_get
  • cockpit_content_pool_create
  • cockpit_content_pool_update
  • cockpit_content_pool_attach_assets
  • cockpit_content_pool_import_batch
  • cockpit_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​

TabelleZweck
content_pool_packagesOrg, Titel, shop_chain_id, center_scope, Gültigkeit, Status
content_pool_assetsMedien-Referenzen (media_file_id, URL, Rolle)
content_pool_package_centersM:N bei explicit_centers
content_pool_catalog_entriesGlobaler Katalog-Eintrag (ohne Org), Kette, Gültigkeit, Status, version
content_pool_catalog_assetsKatalog-Medien (URL, optional media_file_id)
content_pool_catalog_entry_centersM: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: /en/developer-guide/content-pool-mcp