contentful-mcp
Contentful MCP Server
Eine MCP-Serverimplementierung, die sich in die Content Management API von Contentful integrieren lässt und umfassende Content-Management-Funktionen bietet.
Bitte beachten Sie *; wenn Sie nicht am Code interessiert sind und dieses MCP nur in Claude Desktop (oder einem anderen Tool, das MCP-Server verwenden kann) verwenden möchten, müssen Sie dieses Repo nicht klonen, sondern können es einfach in Claude Desktop einrichten. Anweisungen zur Installation finden Sie im Abschnitt „Verwendung mit Claude Desktop“.
Merkmale
Inhaltsverwaltung : Vollständige CRUD-Operationen für Einträge und Assets
Raumverwaltung : Erstellen, aktualisieren und verwalten Sie Räume und Umgebungen
Inhaltstypen : Inhaltstypdefinitionen verwalten
Lokalisierung : Unterstützung für mehrere Gebietsschemas
Veröffentlichen : Kontrollieren Sie den Workflow zur Inhaltsveröffentlichung
Massenvorgänge : Führen Sie Massenveröffentlichungen, -aufhebungen und -validierungen für mehrere Einträge und Assets durch
Intelligente Paginierung : Listenoperationen geben maximal 3 Elemente pro Anfrage zurück, um einen Überlauf des Kontextfensters zu verhindern, mit integrierter Paginierungsunterstützung
Related MCP server: Storyblok MCP Server
Pagination
Um einen Überlauf des Kontextfensters in LLMs zu verhindern, sind Listenoperationen (wie search_entries und list_assets) auf drei Elemente pro Anfrage begrenzt. Jede Antwort enthält:
Gesamtzahl der verfügbaren Artikel
Aktuelle Artikelseite (max. 3)
Anzahl der verbleibenden Artikel
Wert für die nächste Seite überspringen
Meldung, die den LLM auffordert, das Abrufen weiterer Elemente anzubieten
Dieses Paginierungssystem ermöglicht dem LLM die effiziente Verarbeitung großer Datensätze unter Einhaltung der Kontextfenstergrenzen.
Massenvorgänge
Die Funktion für Massenvorgänge ermöglicht die effiziente Verwaltung mehrerer Inhaltselemente gleichzeitig:
Asynchrone Verarbeitung : Vorgänge werden asynchron ausgeführt und liefern Statusaktualisierungen
Effizientes Content Management : Verarbeiten Sie mehrere Einträge oder Assets in einem einzigen API-Aufruf
Statusverfolgung : Überwachen Sie den Fortschritt mit Erfolgs- und Fehlerzählungen
Ressourcenoptimierung : Reduzieren Sie API-Aufrufe und verbessern Sie die Leistung für Batchvorgänge
Diese Tools für Massenvorgänge eignen sich ideal für Inhaltsmigrationen, Massenaktualisierungen oder Batch-Veröffentlichungs-Workflows.
Werkzeuge
Einlassmanagement
search_entries : Suche nach Einträgen mithilfe von Abfrageparametern
create_entry : Neue Einträge erstellen
get_entry : Vorhandene Einträge abrufen
update_entry : Eintragsfelder aktualisieren
delete_entry : Einträge entfernen
publish_entry : Einträge veröffentlichen
unpublish_entry : Einträge rückgängig machen
Massenvorgänge
bulk_publish : Veröffentlichen Sie mehrere Einträge und Assets in einem einzigen Vorgang. Akzeptiert ein Array von Entitäten (Einträge und Assets) und verarbeitet deren Veröffentlichung als Stapel.
bulk_unpublish : Hebt die Veröffentlichung mehrerer Einträge und Assets in einem einzigen Vorgang auf. Ähnlich wie bulk_publish, entfernt jedoch Inhalte aus der Bereitstellungs-API.
bulk_validate : Überprüft mehrere Einträge auf Inhaltskonsistenz, Referenzen und Pflichtfelder. Gibt Validierungsergebnisse zurück, ohne den Inhalt zu ändern.
Vermögensverwaltung
list_assets : Assets mit Seitennummerierung auflisten (3 Elemente pro Seite)
upload_asset : Neue Assets mit Metadaten hochladen
get_asset : Assetdetails und -informationen abrufen
update_asset : Asset-Metadaten und -Dateien aktualisieren
delete_asset : Assets aus dem Speicherplatz entfernen
publish_asset : Veröffentlichen Sie Assets in der Bereitstellungs-API
unpublish_asset : Hebt die Veröffentlichung von Assets aus der Bereitstellungs-API auf
Raum- und Umweltmanagement
list_spaces : Listet verfügbare Plätze auf
get_space : Raumdetails abrufen
list_environments : Umgebungen in einem Bereich auflisten
create_environment : Neue Umgebung erstellen
delete_environment : Umgebung entfernen
Inhaltstypverwaltung
list_content_types : Listet verfügbare Inhaltstypen auf
get_content_type : Details zum Inhaltstyp abrufen
create_content_type : Neuen Inhaltstyp erstellen
update_content_type : Inhaltstyp aktualisieren
delete_content_type : Inhaltstyp entfernen
publish_content_type : Einen Inhaltstyp veröffentlichen
Entwicklungstools
MCP-Inspektor
Das Projekt umfasst ein MCP Inspector-Tool, das bei der Entwicklung und beim Debuggen hilft:
Inspektionsmodus : Führen Sie
npm run inspectaus, um den Inspektor zu starten. Sie können den Inspektor öffnen, indem Sie zu http://localhost:5173 gehen.Überwachungsmodus : Verwenden Sie
npm run inspect:watch, um den Inspektor automatisch neu zu starten, wenn sich Dateien ändernVisuelle Schnittstelle : Der Inspector bietet eine Webschnittstelle zum Testen und Debuggen von MCP-Tools
Echtzeittests : Testen Sie Tools und sehen Sie sich ihre Reaktionen sofort an
Testen von Massenvorgängen : Testen und überwachen Sie Massenvorgänge mit visuellem Feedback zu Fortschritt und Ergebnissen
Das Projekt enthält außerdem einen npm run dev -Befehl, der den MCP-Server bei jeder Änderung neu erstellt und neu lädt.
Konfiguration
Voraussetzungen
Erstellen Sie ein Contentful-Konto bei Contentful
Generieren Sie ein Content Management API-Token aus Ihren Kontoeinstellungen
Umgebungsvariablen
Diese Variablen können auch als Argumente gesetzt werden
CONTENTFUL_HOST/--host: Contentful Management API-Endpunkt (standardmäßig https://api.contentful.com )CONTENTFUL_MANAGEMENT_ACCESS_TOKEN/--management-token: Ihr Content Management API-TokenENABLE_HTTP_SERVER/--http: Auf „true“ setzen, um den HTTP/SSE-Modus zu aktivierenHTTP_PORT/--port: Port für HTTP-Server (Standard: 3000)HTTP_HOST/--http-host: Host für HTTP-Server (Standard: localhost)
Raum- und Umweltabgrenzung
Sie können die Space-ID und die Environment-ID festlegen, um sicherzustellen, dass der LLM nur Operationen mit den definierten Space-/Env-IDs durchführt. Dies dient hauptsächlich der Unterstützung von Agenten, die in bestimmten Spaces arbeiten. Wenn sowohl die Umgebungsvariablen SPACE_ID als auch ENVIRONMENT_ID gesetzt sind, melden die Tools diese Werte nicht, und die Handler verwenden die Umgebungsvariablen für CMA-Operationen. Sie verlieren außerdem den Zugriff auf die Tools im Space-Handler, da diese bereichsübergreifend sind. Sie können die SPACE_ID und ENVIRONMENT_ID auch mit den Argumenten --space-id und --environment-id hinzufügen.
Verwenden der App-Identität
Anstatt ein Management-Token bereitzustellen, können Sie auch App Identity für die Authentifizierung nutzen. Dazu müssen Sie eine Contentful App einrichten und installieren und beim Aufruf des MCP-Servers die folgenden Parameter festlegen:
--app-id= die App-ID, die das Apptoken bereitstellt--private-key= der private Schlüssel, den Sie in der Benutzeroberfläche Ihrer App erstellt haben, verknüpft mitapp_id--space-id= die SpaceId, in der die App installiert ist--environment-id= die Umgebungs-ID (innerhalb des Bereichs), in dem die App installiert ist.
Mit diesen Werten fordert der MCP-Server einen temporären AppToken an, um Inhaltsoperationen in der definierten Space/Environment-ID durchzuführen. Dies ist besonders nützlich, wenn dieser MCP-Server in Backend-Systemen verwendet wird, die als MCP-Client fungieren (z. B. Chat-Agenten).
Verwendung mit Claude Desktop
Sie müssen dieses Repo nicht klonen, um dieses MCP zu verwenden. Sie können es einfach zu Ihrer claude_desktop_config.json hinzufügen:
Fügen Sie ~/Library/Application Support/Claude/claude_desktop_config.json hinzu oder bearbeiten Sie es und fügen Sie die folgenden Zeilen hinzu:
{
"mcpServers": {
"contentful": {
"command": "npx",
"args": ["-y", "@ivotoby/contentful-management-mcp-server"],
"env": {
"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
}
}
}
}Wenn Ihr MCPClient das Festlegen von Umgebungsvariablen nicht unterstützt, können Sie das Verwaltungstoken auch mit einem Argument wie dem folgenden festlegen:
{
"mcpServers": {
"contentful": {
"command": "npx",
"args": [
"-y",
"@ivotoby/contentful-management-mcp-server",
"--management-token",
"<your token>",
"--host",
"http://api.contentful.com"
]
}
}
}Installation über Smithery
So installieren Sie Contentful Management Server für Claude Desktop automatisch über Smithery :
npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claudeEntwickeln und Verwenden von Claude Desktop
Wenn Sie mitwirken und testen möchten, was Claude mit Ihren Beiträgen macht;
Führen Sie
npm run devaus. Dadurch wird der Watcher gestartet, der den MCP-Server bei jeder Änderung neu aufbaut.Aktualisieren Sie
claude_desktop_config.jsonum direkt auf das Projekt zu verweisen, d. h.
{
"mcpServers": {
"contentful": {
"command": "node",
"args": ["/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js"],
"env": {
"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA Token>"
}
}
}
}Dadurch können Sie alle Änderungen am MCP-Server direkt mit Claude testen. Wenn Sie jedoch neue Tools/Ressourcen hinzufügen, müssen Sie Claude Desktop neu starten.
Verkehrsmittel
Der MCP-Server unterstützt zwei Transportmodi:
stdio Transport
Der Standardtransportmodus verwendet Standard-Ein-/Ausgabeströme für die Kommunikation. Dies ist ideal für die Integration mit MCP-Clients, die Standardtransport unterstützen, wie beispielsweise Claude Desktop.
Um den stdio-Modus zu verwenden, führen Sie den Server einfach ohne das Flag --http aus:
npx -y contentful-mcp --management-token YOUR_TOKEN
# or alternatively
npx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKENStreamableHTTP-Transport
Der Server unterstützt außerdem den im MCP-Protokoll definierten StreamableHTTP-Transport. Dieser Modus ist nützlich für webbasierte Integrationen oder wenn der Server als eigenständiger Dienst ausgeführt wird.
Um den StreamableHTTP-Modus zu verwenden, führen Sie mit dem Flag --http Folgendes aus:
npx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000
# or alternatively
npx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000StreamableHTTP-Details
Verwendet den offiziellen MCP StreamableHTTP-Transport
Unterstützt Standard-MCP-Protokollvorgänge
Beinhaltet Sitzungsverwaltung zur Aufrechterhaltung des Status
Behandelt Initialisierungs-/Benachrichtigungsmuster ordnungsgemäß
Kompatibel mit Standard-MCP-Clients
Ersetzt den veralteten SSE-Transport durch den modernen Ansatz
Die Implementierung folgt der Standardspezifikation des MCP-Protokolls und ermöglicht jedem MCP-Client die Verbindung zum Server ohne besondere Behandlung.
Fehlerbehandlung
Der Server implementiert eine umfassende Fehlerbehandlung für:
Authentifizierungsfehler
Ratenbegrenzung
Ungültige Anfragen
Netzwerkprobleme
API-spezifische Fehler
Lizenz
MIT-Lizenz
Kleingedrucktes
Dieser MCP-Server ermöglicht es Claude (oder anderen Agenten, die MCP-Ressourcen nutzen können), Inhalte, Bereiche und Inhaltsmodelle zu aktualisieren und zu löschen. Stellen Sie daher sicher, was Sie Claude mit Ihren Contentful-Bereichen erlauben!
Dieser MCP-Server wird von Contentful (noch) nicht offiziell unterstützt
Available Tools
40 toolsbulk_validateC
Validate multiple entries at once
Inputs: entryIds (required), spaceId (required), environmentId (required).
create_ai_actionC
Create a new AI Action
Inputs: name (required), description (required), instruction (required), configuration (required), +3 more.
create_commentA
Create a new comment on an entry. The comment will be created with the specified body and status. To create a threaded conversation (reply to an existing comment), provide the parent comment ID. This allows you to work around the 512-character limit by creating threaded replies.
Inputs: entryId (required), body (required), spaceId (required), environmentId (required), +2 more.
create_content_typeD
Create a new content type
Inputs: name (required), fields (required), spaceId (required), environmentId (required), +2 more.
create_entryA
Create a new entry in Contentful. Before executing this function, you need to know the contentTypeId (not the content type NAME) and the fields of that contentType. You can get the fields definition by using the GET_CONTENT_TYPE tool. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Title' } }. Every field in Contentful requires a locale even for single-language content.
Inputs: contentTypeId (required), fields (required), spaceId (required), environmentId (required).
create_environmentD
Create a new environment
Inputs: spaceId (required), environmentId (required), name (required).
delete_ai_actionB
Delete an AI Action
Inputs: aiActionId (required), spaceId (required), environmentId (required).
delete_assetC
Delete an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
delete_commentC
Delete a specific comment from an entry.
Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required).
delete_content_typeC
Delete a content type
Inputs: contentTypeId (required), spaceId (required), environmentId (required).
delete_entryC
Delete an entry
Inputs: entryId (required), spaceId (required), environmentId (required).
delete_environmentC
Delete an environment
Inputs: spaceId (required), environmentId (required).
get_ai_actionB
Get a specific AI Action by ID
Inputs: aiActionId (required), spaceId (required), environmentId (required).
get_ai_action_invocationB
Get the result of a previous AI Action invocation
Inputs: aiActionId (required), invocationId (required), spaceId (required), environmentId (required).
get_assetC
Retrieve an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
get_commentsB
Retrieve comments for an entry with pagination support. Returns comments with their status and body content.
Inputs: entryId (required), spaceId (required), environmentId (required), bodyFormat, +3 more.
get_content_typeB
Get details of a specific content type
Inputs: contentTypeId (required), spaceId (required), environmentId (required).
get_entryC
Retrieve an existing entry
Inputs: entryId (required), spaceId (required), environmentId (required).
get_single_commentB
Retrieve a specific comment by its ID for an entry.
Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required), +1 more.
get_spaceC
Get details of a space
Inputs: spaceId (required).
invoke_ai_actionC
Invoke an AI Action with variables
Inputs: aiActionId (required), spaceId (required), environmentId (required), variables, +3 more.
list_ai_actionsC
List all AI Actions in a space
Inputs: spaceId (required), environmentId (required), limit, skip, +1 more.
list_assetsA
List assets in a space. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.
Inputs: limit (required), skip (required), spaceId (required), environmentId (required).
list_content_typesB
List content types in a space. Returns a maximum of 10 items per request. Use skip parameter to paginate through results.
Inputs: limit (required), skip (required), spaceId (required), environmentId (required).
list_environmentsC
List all environments in a space
Inputs: spaceId (required).
list_spacesA
List all available spaces
Inputs: no named parameters.
publish_ai_actionC
Publish an AI Action
Inputs: aiActionId (required), spaceId (required), environmentId (required).
publish_assetC
Publish an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
publish_content_typeC
Publish a content type
Inputs: contentTypeId (required), spaceId (required), environmentId (required).
publish_entryA
Publish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard publish operation. For multiple entries, it automatically uses bulk publishing.
Inputs: entryId (required), spaceId (required), environmentId (required).
search_entriesA
Search for entries using query parameters. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.
Inputs: query (required), spaceId (required), environmentId (required).
unpublish_ai_actionC
Unpublish an AI Action
Inputs: aiActionId (required), spaceId (required), environmentId (required).
unpublish_assetC
Unpublish an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
unpublish_entryA
Unpublish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard unpublish operation. For multiple entries, it automatically uses bulk unpublishing.
Inputs: entryId (required), spaceId (required), environmentId (required).
update_ai_actionC
Update an existing AI Action
Inputs: aiActionId (required), name (required), description (required), instruction (required), +4 more.
update_assetD
Update an asset
Inputs: assetId (required), spaceId (required), environmentId (required), title, +2 more.
update_commentA
Update an existing comment on an entry. The handler will merge your updates with the existing comment data.
Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required), +3 more.
update_content_typeB
Update an existing content type. The handler will merge your field updates with existing content type data, so you only need to provide the fields and properties you want to change.
Inputs: contentTypeId (required), fields (required), spaceId (required), environmentId (required), +3 more.
update_entryA
Update an existing entry. The handler will merge your field updates with the existing entry fields, so you only need to provide the fields and locales you want to change. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Updated Title' } }. Every field in Contentful requires a locale even for single-language content.
Inputs: entryId (required), fields (required), spaceId (required), environmentId (required).
upload_assetC
Upload a new asset
Inputs: title (required), file (required), spaceId (required), environmentId (required), +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Each tool targets a distinct resource and action (e.g., create_entry vs. get_entry, publish_asset vs. unpublish_asset). There is no overlap in purpose, and descriptions clearly differentiate similar operations like get_ai_action vs. get_ai_action_invocation.
All tools follow a consistent verb_noun snake_case pattern (e.g., create_entry, list_assets, update_comment). No mixing of conventions like camelCase or different verb styles.
With 40 tools, the count exceeds the typical well-scoped range (3-15) and the '25+' threshold for too many. Even considering Contentful's complexity, the number feels heavy and may overwhelm agents.
The tool set covers full CRUD plus publish/unpublish, search, and validation for entries; CRUD plus upload for assets; lifecycle for comments, environments, AI actions; and space listing. No obvious gaps such as missing delete for content types or bulk operations.
Maintenance
Related MCP Connectors
Headless CMS. Search the docs and read, draft, publish, and schedule entries via OAuth.
Run read-only GraphQL queries and list documents and media assets in Caisy.
Manage repositories, users, releases, and automate GitHub workflows
Hosted Kontent.ai MCP server to manage content, types, taxonomies, and workflows
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for interacting with Contentstack's Content Management API1511 npm2TypeScriptMIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive management of Storyblok CMS through natural language interactions. Supports story creation and publishing, asset management, component schema updates, release workflows, and content discovery across all major Storyblok APIs.8 npm-
- AlicenseAqualityDmaintenanceEnables efficient content retrieval from Contentful's Content Delivery API using GraphQL queries. Supports schema exploration, query generation, and flexible data fetching with read-only access.69 npm1MIT
- AlicenseAqualityNot gradedmaintenanceEnables AI agents to manage Contentrain CMS content, models, and assets with automatic git branch synchronization across different environments. It provides standardized tools for performing CRUD operations on git-based headless CMS projects through natural language.14-