Skip to main content
Glama

Contentful MCP Server

Schmiedeabzeichen

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 inspect aus, 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 ändern

  • Visuelle 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

  1. Erstellen Sie ein Contentful-Konto bei Contentful

  2. 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-Token

  • ENABLE_HTTP_SERVER / --http : Auf „true“ setzen, um den HTTP/SSE-Modus zu aktivieren

  • HTTP_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 mit app_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 claude

Entwickeln und Verwenden von Claude Desktop

Wenn Sie mitwirken und testen möchten, was Claude mit Ihren Beiträgen macht;

  • Führen Sie npm run dev aus. Dadurch wird der Watcher gestartet, der den MCP-Server bei jeder Änderung neu aufbaut.

  • Aktualisieren Sie claude_desktop_config.json um 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_TOKEN

StreamableHTTP-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 3000

StreamableHTTP-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 tools
bulk_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

    C2.9/5.0

    Scored across 40 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers