Contentstack MCP Server

Der Contentstack MCP Server verbindet Ihren KI-Assistenten mit Contentstack, einem Headless CMS für Unternehmen. MCP, das Model Context Protocol, ist ein offener Standard, über den Assistenten wie Claude, Cursor, Codex oder ChatGPT externe Dienste ansprechen. Ein Headless CMS verwaltet Inhalte zentral und liefert sie über eine Schnittstelle an Websites und Apps aus. Hinter dem Server steht Contentstack selbst. Es gibt ihn in zwei Formen: als gehostetes MCP Profile Hub und als lokales npm-Paket. Contentstack empfiehlt inzwischen den gehosteten Weg und schreibt auf seiner Entwicklerseite, dass der Profile Hub das lokale Paket ablöst.

Wofür ist der Contentstack MCP Server nützlich?

In einem großen CMS steckt viel Klickarbeit. Ein neues Feld in mehreren Content-Typen anlegen, Einträge für ein Release sammeln, eine Übersetzung prüfen oder nachsehen, warum ein Deployment fehlgeschlagen ist: Solche Aufgaben beschreiben Sie dem Assistenten in normaler Sprache, und er erledigt sie über die Schnittstellen von Contentstack. Entwickler sparen sich den Wechsel zwischen Code, Dokumentation und Weboberfläche. Content-Architekten können Modelle im Gespräch entwerfen und anpassen. Redaktionsteams lassen sich Einträge zusammenfassen oder Entwürfe nach Vorgaben erstellen.

MCP Profile Hub: der gehostete Weg

Der Profile Hub ist eine App aus dem Contentstack Marketplace. Darin legen Sie Profile an. Ein Profil ist eine eigene MCP-Verbindung, die nur die Werkzeuge zeigt, die Sie dafür auswählen. Nach dem Veröffentlichen bekommen Sie eine Connector-URL, die Sie in Ihren Client eintragen. Beim ersten Verbinden melden Sie sich per OAuth im Browser bei Contentstack an. OAuth ist ein Anmeldeverfahren, bei dem Sie den Zugriff bestätigen, ohne ein Passwort oder einen Schlüssel weiterzugeben. Die URL selbst enthält deshalb keine Geheimnisse.

Alle Aufrufe laufen mit den Rechten Ihrer bestehenden Contentstack-Rolle. Laut Contentstack kann ein schreibgeschütztes Profil nichts veröffentlichen. Jeder Werkzeugaufruf landet im Bereich Executions, samt Profil, Werkzeug, Client, Zeit, Eingabe und Ergebnis. Executions nennt allerdings nur den Client, nicht die Person. Für die Zuordnung zu einzelnen Nutzern verweist Contentstack auf das Audit-Log der Organisation. Praktisch ist außerdem, dass die Werkzeugbeschreibungen die echten Content-Typen, Sprachen, Branches und Umgebungen Ihres Stacks enthalten. Der Assistent rät also weniger und wählt eher gültige Werte.

Das lokale npm-Paket

Das Paket @contentstack/mcp läuft per npx auf Ihrem Rechner und spricht den Client über stdio an, also über die Standard-Ein- und Ausgabe. Es bündelt laut Dokumentation zehn Werkzeuggruppen: Content Management mit Einträgen, Assets, Content-Typen, Branches, Releases und Taxonomien, dazu Content Delivery für veröffentlichte Inhalte, Analytics, Automations, Brand Kit, Launch, Developer Hub, Lytics und Personalize. Standardmäßig ist nur die Gruppe cma aktiv. Sie melden sich einmalig mit npx @contentstack/mcp --auth an oder nutzen einen Management Token. Laut npm-Registry steht das Paket unter der MIT-Lizenz, das dort verlinkte Repository ist derzeit aber nicht öffentlich erreichbar.

Grenzen und Risiken

Beide Wege können schreiben, und manche Werkzeuge des lokalen Pakets löschen dauerhaft, etwa Umgebungen, globale Felder oder Asset-Ordner. Wählen Sie deshalb nur die Werkzeuge oder Gruppen, die Sie wirklich brauchen. Das verbessert laut Contentstack auch die Genauigkeit des Modells, weil es aus weniger Werkzeugen wählen muss. Im Profile Hub sind eingespielte Listen auf 50 Werte begrenzt, und neue Content-Typen erscheinen durch einen Cache erst nach bis zu fünf Minuten.

Clients

Contentstack nennt Claude, Claude Code, Cursor, Codex und ChatGPT. Claude Code laufe am zuverlässigsten, Claude Desktop verbinde sich teils unregelmäßig. Bei Claude.ai hängt die Nutzung von den Connector-Einstellungen Ihrer Organisation ab, bei Codex sollten Sie ein aktuelles Modell wählen. Clients ohne HTTP-Unterstützung binden den Profile Hub über das Hilfsprogramm mcp-remote mit Node.js ein.

Kosten und Lizenz

Für den MCP-Zugang selbst nennt Contentstack keine eigene Gebühr. Contentstack bietet laut Preisseite einen kostenlosen Free-Plan ohne Ablaufdatum, kostenpflichtige Pläne und Enterprise-Tarife. Agent OS ist in jedem Tarif enthalten. Der Profile Hub ist ein gehosteter Dienst ohne veröffentlichten Quellcode, das lokale Paket steht unter MIT.

Für wen lohnt sich der Contentstack MCP Server?

Er lohnt sich vor allem für Teams, die Contentstack bereits produktiv nutzen und Modellpflege, Releases oder Launch-Deployments schneller erledigen wollen. Im Vergleich zu MCP-Servern anderer Headless CMS wie Contentful, Sanity, Storyblok oder Hygraph fallen die frei zusammenstellbaren Profile und das Protokoll jedes Aufrufs auf. Wer Zugriffe fein begrenzen und nachvollziehen muss, findet hier gute Werkzeuge.

Ein Contentstack-Konto mit Zugriff auf einen Stack und ein MCP-fähiger Client wie Claude Code, Claude, Cursor, Codex oder ChatGPT. Für den Profile Hub die installierte Marketplace-App und ein veröffentlichtes Profil; für das lokale Paket Node.js ab 18 und den Stack API Key.

Mit dem Contentstack MCP Server arbeitet Ihr KI-Assistent direkt mit Einträgen, Content-Typen und Releases in Contentstack. Contentstack empfiehlt dafür das gehostete MCP Profile Hub. Dieser Ratgeber zeigt die Einrichtung und den lokalen Weg als Alternative.

Schritt 1: Profile Hub installieren

Öffnen Sie in Contentstack den Marketplace und installieren Sie die App MCP Profile Hub. Darin verwalten Sie Profile. Ein Profil ist eine eigene MCP-Verbindung mit genau den Werkzeugen, die Sie freigeben. Passt eines der vorbereiteten Systemprofile, können Sie es direkt verwenden.

Eigenes Profil anlegen

Legen Sie ein neues Profil an und wählen Sie die Werkzeuge aus. Nehmen Sie nur, was die Aufgabe braucht: Weniger Werkzeuge machen die Auswahl für das Modell genauer und sparen Kontext. Konfigurieren Sie dann den Stack und veröffentlichen Sie das Profil. Sie erhalten eine Connector-URL der Form https://mcp-profile-hub.contentstack.com/api/mcp?profile_id=<PROFILE_ID>&org_uid=<ORG_UID>. Sie enthält keine Geheimnisse.

Claude Code

Führen Sie claude mcp add --transport http contentstack "<Connector-URL>" aus. Setzen Sie die URL in Anführungszeichen, weil sie ein &-Zeichen enthält. Beim ersten Aufruf öffnet sich der Browser, Sie melden sich bei Contentstack an und bestätigen die angefragten Berechtigungen. Laut Contentstack läuft Claude Code von allen Clients am zuverlässigsten.

Cursor, Claude, Codex und ChatGPT

Für Cursor und Claude gibt es die Schaltflächen Add to Cursor und Add to Claude. Alternativ tragen Sie die URL als Remote-Server ein. In Claude.ai hängt die Nutzung von den Connector-Einstellungen Ihrer Organisation ab. In Codex wählen Sie ein aktuelles Modell. Clients, die nur stdio beherrschen, binden die URL über das Hilfsprogramm mcp-remote ein, dafür brauchen Sie Node.js.

Lokaler Weg mit npm-Paket

Wer lieber lokal arbeitet, nutzt das Paket @contentstack/mcp. Melden Sie sich einmalig mit npx @contentstack/mcp --auth an. Danach tragen Sie im Client den Befehl npx -y @contentstack/mcp ein und setzen CONTENTSTACK_API_KEY sowie GROUPS als Umgebungsvariablen, etwa GROUPS=cma. Für Server ohne Browser gibt es den Management Token, dann müssen Sie die Region ausdrücklich setzen. Contentstack nennt den Profile Hub als Nachfolger dieses Pakets.

Sicher arbeiten

Alle Aufrufe laufen mit den Rechten Ihrer Contentstack-Rolle. Für Auswertungen eignet sich ein schreibgeschütztes Profil, das nichts veröffentlichen kann. Prüfen Sie regelmäßig den Bereich Executions, dort steht jeder Werkzeugaufruf mit Eingabe und Ergebnis.

claude mcp add --transport http contentstack "https://mcp-profile-hub.contentstack.com/api/mcp?profile_id=<PROFILE_ID>&org_uid=<ORG_UID>"

Profile Hub: OAuth im Browser beim ersten Verbinden, die URL enthält keine Geheimnisse. Lokales Paket: OAuth per npx @contentstack/mcp --auth oder ein Management Token für Content Management; Content Delivery nutzt einen Delivery Token, Lytics einen eigenen Access Token.

Je nach Profil oder Werkzeuggruppe Lesen, Anlegen, Ändern und Veröffentlichen von Einträgen und Assets, Verwaltung von Content-Typen, Branches, Releases und Umgebungen sowie Launch-, Personalize- und Analytics-Funktionen. Alle Aufrufe laufen mit den Rechten der eigenen Contentstack-Rolle; ein schreibgeschütztes Profil kann nicht veröffentlichen.

Beim Profile Hub laufen Anfragen über den von Contentstack gehosteten Dienst, jeder Aufruf wird mit Eingabe und Ergebnis unter Executions protokolliert. Das lokale Paket speichert OAuth-Tokens auf dem eigenen Rechner. Inhalte, die im Chat erscheinen, gehen zusätzlich an den KI-Anbieter des Clients.

Mittel bis hoch, je nach Auswahl. Der Assistent kann Inhalte ändern und veröffentlichen, im lokalen Paket teils auch dauerhaft löschen. Ein präparierter Text mit versteckten Anweisungen kann ungewollte Aktionen auslösen. Nur nötige Werkzeuge freigeben, schreibgeschützte Profile für Auswertungen nutzen und Executions regelmäßig prüfen.