Contentful MCP Server

Der Contentful MCP Server verbindet das Headless-CMS Contentful mit KI-Assistenten wie Claude Code, Codex oder Cursor. Statt im Webinterface von Eintrag zu Eintrag zu klicken, beschreiben Sie in natürlicher Sprache, was geschehen soll, und der Assistent führt die passenden Aufrufe der Contentful Management API aus. Der Server wird von Contentful selbst als Open-Source-Projekt unter MIT-Lizenz entwickelt und gepflegt, das Repository war am Prüftag aktiv und nicht archiviert.

Was ist der Contentful MCP Server?

Contentful ist ein Headless-CMS: Inhalte liegen als strukturierte Einträge vor, deren Aufbau durch Content-Typen festgelegt wird, und werden per API an beliebige Frontends geliefert. Der MCP-Server öffnet genau diese Verwaltungsebene für Sprachmodelle. Er wird lokal per npx als Node.js-Prozess gestartet und spricht mit der Management API Ihres Spaces. Der Assistent arbeitet damit nicht mit einem Export, sondern direkt mit den echten Inhalten und Modellen.

Was kann der Server?

Laut README umfasst das Werkzeugset deutlich mehr als vierzig Funktionen in mehreren Bereichen. Für Content-Typen gibt es Anlegen, Ändern, Veröffentlichen und Löschen. Bei Einträgen lassen sich Suche, Bearbeitung, Veröffentlichung, Rücknahme der Veröffentlichung und Löschung ausführen, auch als Sammelvorgang, dazu eine semantische Suche nach Bedeutung und der Abruf von Versionsständen. Assets können hochgeladen, beschrieben und veröffentlicht werden. Weitere Bereiche sind Spaces und Environments, Locales für mehrsprachige Inhalte, Tags, Content-Vorschau-URLs sowie Releases samt Validierung und zeitgesteuerter Veröffentlichung. Hinzu kommen AI Actions, also von Contentful bereitgestellte KI-Workflows, die der Assistent anlegen und aufrufen kann, und eine Abfrage der Nutzungsmetriken einer Organisation.

Typische Einsatzszenarien

Besonders hilfreich ist der Server bei Aufgaben, die im Webinterface viele gleichförmige Klicks bedeuten: einem Content-Typ ein Feld hinzufügen und bestehende Einträge anpassen, einen Entwurf für eine Produkteinführung anlegen, Bilder hochladen und nach Kampagne ordnen oder Inhalte für ein neues Locale vorbereiten. Entwicklerteams können Content-Modelle aus dem Chat heraus entwerfen und prüfen, bevor sie im Code verwendet werden. Redaktionen profitieren davon, Veröffentlichungen als Release zu bündeln und vorab validieren zu lassen.

Einrichtung und Voraussetzungen

Sie benötigen Node.js und npm, eine Contentful-Space-ID und ein persönliches Zugriffstoken (Personal Access Token) für die Management API. Der Server wird als Befehl npx -y @contentful/mcp-server eingetragen; Token, Space-ID, Environment und Host übergeben Sie als Umgebungsvariablen. Für Cursor gibt es einen Ein-Klick-Link, für Claude Desktop eine .dxt-Datei in den GitHub-Releases und für Codex einen fertigen codex mcp add-Befehl.

Sicherheit und geschützte Environments

Weil der Server schreiben und löschen kann, ist die Option PROTECTED_ENVIRONMENTS wichtig: Ist sie gesetzt, blockiert der Server schreibende und löschende Aufrufe in den genannten Environments, etwa master, bevor sie die API erreichen. Laut README gilt der Schutz nur innerhalb dieses Servers und ersetzt keine rollenbasierten Berechtigungen. Arbeiten Sie deshalb möglichst in einem eigenen Test-Environment und verwenden Sie ein Token mit knappen Rechten.

Kosten und Lizenz

Der MCP-Server selbst ist kostenlos und quelloffen unter MIT-Lizenz. Voraussetzung ist jedoch ein Contentful-Konto; welche Funktionen in welchem Tarif enthalten sind, etwa AI Actions, regelt die offizielle Preisseite von Contentful. Ob und in welchem Umfang ein kostenloser Einstieg besteht, entnehmen Sie bitte dort.

Für wen lohnt sich der Contentful MCP Server?

Er lohnt sich für Teams, die Contentful bereits einsetzen und wiederkehrende Pflegearbeiten, Migrationen oder Modellierungsaufgaben beschleunigen möchten. Für Einsteiger ohne Contentful-Konto bietet er keinen Nutzen. Wer ihn einsetzt, sollte Änderungen an produktiven Inhalten stets prüfen, denn ein Sprachmodell kann Felder falsch befüllen oder zu viele Einträge auf einmal ändern.

Häufige Fragen

Kann der Server Inhalte versehentlich löschen? Ja, er besitzt Lösch-Werkzeuge. Schützen Sie wichtige Environments über PROTECTED_ENVIRONMENTS und nutzen Sie ein Token mit begrenzten Rechten.

Brauche ich Programmierkenntnisse? Grundkenntnisse in der Konfiguration eines MCP-Clients genügen; die eigentliche Arbeit erfolgt in natürlicher Sprache.

Ist das ein offizielles Produkt? Ja, das Repository liegt in der GitHub-Organisation von Contentful.

Node.js und npm, ein Contentful-Konto mit Space-ID und persönlichem Management-API-Zugriffstoken sowie ein MCP-Client wie Claude Code, Codex, Cursor oder Claude Desktop.

Mit dem Contentful MCP Server verwaltet ein KI-Assistent Inhalte und Content-Modelle Ihres Spaces. Dieser Ratgeber führt von den Voraussetzungen bis zur ersten sicheren Anfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen Node.js mit npm, ein Contentful-Konto, die Space-ID und einen MCP-Client wie Claude Code, Codex oder Cursor. Die Space-ID finden Sie in den Einstellungen Ihres Spaces.

Schritt 2: Zugriffstoken erzeugen

Erstellen Sie in Contentful ein persönliches Zugriffstoken für die Management API. Es erbt Ihre Rechte, deshalb sollte es nur für Spaces verwendet werden, in denen der Assistent arbeiten darf. Bewahren Sie das Token nur in der Konfiguration Ihres Clients auf.

Schritt 3: Server eintragen

Tragen Sie den Server als Befehl npx -y @contentful/mcp-server ein und setzen Sie die Umgebungsvariablen CONTENTFUL_MANAGEMENT_ACCESS_TOKEN und SPACE_ID. Mit ENVIRONMENT_ID legen Sie fest, in welchem Environment gearbeitet wird; Standard ist master. Für Codex gibt das README einen fertigen codex mcp add-Befehl vor, für Cursor einen Ein-Klick-Link.

npx -y @contentful/mcp-server
codex mcp add

Produktive Environments schützen

Setzen Sie PROTECTED_ENVIRONMENTS auf eine kommagetrennte Liste wie master,staging. Schreibende und löschende Aufrufe in diesen Environments werden dann blockiert, Lesezugriffe bleiben möglich. Beachten Sie, dass dieser Schutz nur innerhalb des Servers gilt.

Schritt 4: Verbindung testen

Beginnen Sie mit einer lesenden Anfrage, etwa „Liste alle Content-Typen auf“. Lassen Sie danach in einem Test-Environment einen Entwurf anlegen und prüfen Sie ihn im Webinterface.

Arbeitsweise im Alltag

Bitten Sie den Assistenten, vor größeren Änderungen zuerst aufzulisten, welche Einträge betroffen wären. Bündeln Sie Veröffentlichungen als Release und lassen Sie diesen vorab validieren.

Persönliches Contentful-Management-API-Zugriffstoken (CONTENTFUL_MANAGEMENT_ACCESS_TOKEN) als Umgebungsvariable.

Lese- und Schreibzugriff auf Content-Typen, Einträge, Assets, Locales, Tags, Releases, Environments und AI Actions im konfigurierten Space, begrenzt durch die Rechte des verwendeten Tokens.

Der Server läuft lokal und ruft die Contentful-API auf. Inhalte, die der Assistent abruft, gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Versehentliches Überschreiben, Veröffentlichen oder Löschen von Inhalten und Modellen, zu weit gefasste Token-Rechte sowie das Löschen ganzer Environments; Schutz nur innerhalb dieses Servers über PROTECTED_ENVIRONMENTS.