[{"_1":2,"_421":-5,"_422":-5},"loaderData",{"_3":4,"_22":23,"_283":284},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",18046839,"membership","referenceId","0199d013-274b-71c7-9a22-d23226418aee","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_77":-5,"_78":38,"_27":79,"_198":199,"_281":282},"availableLocales",[26,38,44,51,58,64,71],{"_27":28,"_31":35,"_36":37},"mcpServer",{"_29":30,"_31":32,"_33":34},"description","Aktualisieren, erstellen und löschen Sie Inhalte, Inhaltsmodelle und Assets in Ihrem Contentful Space","name","contentful-mcp","readme","# Contentful MCP Server\n\n[![Schmiedeabzeichen](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nEine MCP-Serverimplementierung, die sich in die Content Management API von Contentful integrieren lässt und umfassende Content-Management-Funktionen bietet.\n\n* 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“.\n\n## Merkmale\n\n* **Inhaltsverwaltung** : Vollständige CRUD-Operationen für Einträge und Assets\n* **Raumverwaltung** : Erstellen, aktualisieren und verwalten Sie Räume und Umgebungen\n* **Inhaltstypen** : Inhaltstypdefinitionen verwalten\n* **Lokalisierung** : Unterstützung für mehrere Gebietsschemas\n* **Veröffentlichen** : Kontrollieren Sie den Workflow zur Inhaltsveröffentlichung\n* **Massenvorgänge** : Führen Sie Massenveröffentlichungen, -aufhebungen und -validierungen für mehrere Einträge und Assets durch\n* **Intelligente Paginierung** : Listenoperationen geben maximal 3 Elemente pro Anfrage zurück, um einen Überlauf des Kontextfensters zu verhindern, mit integrierter Paginierungsunterstützung\n\n## Pagination\n\nUm 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:\n\n* Gesamtzahl der verfügbaren Artikel\n* Aktuelle Artikelseite (max. 3)\n* Anzahl der verbleibenden Artikel\n* Wert für die nächste Seite überspringen\n* Meldung, die den LLM auffordert, das Abrufen weiterer Elemente anzubieten\n\nDieses Paginierungssystem ermöglicht dem LLM die effiziente Verarbeitung großer Datensätze unter Einhaltung der Kontextfenstergrenzen.\n\n## Massenvorgänge\n\nDie Funktion für Massenvorgänge ermöglicht die effiziente Verwaltung mehrerer Inhaltselemente gleichzeitig:\n\n* **Asynchrone Verarbeitung** : Vorgänge werden asynchron ausgeführt und liefern Statusaktualisierungen\n* **Effizientes Content Management** : Verarbeiten Sie mehrere Einträge oder Assets in einem einzigen API-Aufruf\n* **Statusverfolgung** : Überwachen Sie den Fortschritt mit Erfolgs- und Fehlerzählungen\n* **Ressourcenoptimierung** : Reduzieren Sie API-Aufrufe und verbessern Sie die Leistung für Batchvorgänge\n\nDiese Tools für Massenvorgänge eignen sich ideal für Inhaltsmigrationen, Massenaktualisierungen oder Batch-Veröffentlichungs-Workflows.\n\n## Werkzeuge\n\n### Einlassmanagement\n\n* **search\\_entries** : Suche nach Einträgen mithilfe von Abfrageparametern\n* **create\\_entry** : Neue Einträge erstellen\n* **get\\_entry** : Vorhandene Einträge abrufen\n* **update\\_entry** : Eintragsfelder aktualisieren\n* **delete\\_entry** : Einträge entfernen\n* **publish\\_entry** : Einträge veröffentlichen\n* **unpublish\\_entry** : Einträge rückgängig machen\n\n### Massenvorgänge\n\n* **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.\n* **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.\n* **bulk\\_validate** : Überprüft mehrere Einträge auf Inhaltskonsistenz, Referenzen und Pflichtfelder. Gibt Validierungsergebnisse zurück, ohne den Inhalt zu ändern.\n\n### Vermögensverwaltung\n\n* **list\\_assets** : Assets mit Seitennummerierung auflisten (3 Elemente pro Seite)\n* **upload\\_asset** : Neue Assets mit Metadaten hochladen\n* **get\\_asset** : Assetdetails und -informationen abrufen\n* **update\\_asset** : Asset-Metadaten und -Dateien aktualisieren\n* **delete\\_asset** : Assets aus dem Speicherplatz entfernen\n* **publish\\_asset** : Veröffentlichen Sie Assets in der Bereitstellungs-API\n* **unpublish\\_asset** : Hebt die Veröffentlichung von Assets aus der Bereitstellungs-API auf\n\n### Raum- und Umweltmanagement\n\n* **list\\_spaces** : Listet verfügbare Plätze auf\n* **get\\_space** : Raumdetails abrufen\n* **list\\_environments** : Umgebungen in einem Bereich auflisten\n* **create\\_environment** : Neue Umgebung erstellen\n* **delete\\_environment** : Umgebung entfernen\n\n### Inhaltstypverwaltung\n\n* **list\\_content\\_types** : Listet verfügbare Inhaltstypen auf\n* **get\\_content\\_type** : Details zum Inhaltstyp abrufen\n* **create\\_content\\_type** : Neuen Inhaltstyp erstellen\n* **update\\_content\\_type** : Inhaltstyp aktualisieren\n* **delete\\_content\\_type** : Inhaltstyp entfernen\n* **publish\\_content\\_type** : Einen Inhaltstyp veröffentlichen\n\n## Entwicklungstools\n\n### MCP-Inspektor\n\nDas Projekt umfasst ein MCP Inspector-Tool, das bei der Entwicklung und beim Debuggen hilft:\n\n* **Inspektionsmodus** : Führen Sie `npm run inspect` aus, um den Inspektor zu starten. Sie können den Inspektor öffnen, indem Sie zu gehen.\n* **Überwachungsmodus** : Verwenden Sie `npm run inspect:watch` , um den Inspektor automatisch neu zu starten, wenn sich Dateien ändern\n* **Visuelle Schnittstelle** : Der Inspector bietet eine Webschnittstelle zum Testen und Debuggen von MCP-Tools\n* **Echtzeittests** : Testen Sie Tools und sehen Sie sich ihre Reaktionen sofort an\n* **Testen von Massenvorgängen** : Testen und überwachen Sie Massenvorgänge mit visuellem Feedback zu Fortschritt und Ergebnissen\n\nDas Projekt enthält außerdem einen `npm run dev` -Befehl, der den MCP-Server bei jeder Änderung neu erstellt und neu lädt.\n\n## Konfiguration\n\n### Voraussetzungen\n\n1. Erstellen Sie ein Contentful-Konto bei [Contentful](https://www.contentful.com/)\n2. Generieren Sie ein Content Management API-Token aus Ihren Kontoeinstellungen\n\n### Umgebungsvariablen\n\nDiese Variablen können auch als Argumente gesetzt werden\n\n* `CONTENTFUL_HOST` / `--host` : Contentful Management API-Endpunkt (standardmäßig )\n* `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token` : Ihr Content Management API-Token\n* `ENABLE_HTTP_SERVER` / `--http` : Auf „true“ setzen, um den HTTP/SSE-Modus zu aktivieren\n* `HTTP_PORT` / `--port` : Port für HTTP-Server (Standard: 3000)\n* `HTTP_HOST` / `--http-host` : Host für HTTP-Server (Standard: localhost)\n\n### Raum- und Umweltabgrenzung\n\nSie 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.\n\n#### Verwenden der App-Identität\n\nAnstatt ein Management-Token bereitzustellen, können Sie auch [App Identity](https://www.contentful.com/developers/docs/extensibility/app-framework/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:\n\n* `--app-id` = die App-ID, die das Apptoken bereitstellt\n* `--private-key` = der private Schlüssel, den Sie in der Benutzeroberfläche Ihrer App erstellt haben, verknüpft mit `app_id`\n* `--space-id` = die SpaceId, in der die App installiert ist\n* `--environment-id` = die Umgebungs-ID (innerhalb des Bereichs), in dem die App installiert ist.\n\nMit 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).\n\n### Verwendung mit Claude Desktop\n\nSie müssen dieses Repo nicht klonen, um dieses MCP zu verwenden. Sie können es einfach zu Ihrer `claude_desktop_config.json` hinzufügen:\n\nFügen Sie `~/Library/Application Support/Claude/claude_desktop_config.json` hinzu oder bearbeiten Sie es und fügen Sie die folgenden Zeilen hinzu:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@ivotoby/contentful-management-mcp-server\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nWenn Ihr MCPClient das Festlegen von Umgebungsvariablen nicht unterstützt, können Sie das Verwaltungstoken auch mit einem Argument wie dem folgenden festlegen:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### Installation über Smithery\n\nSo installieren Sie Contentful Management Server für Claude Desktop automatisch über [Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server) :\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### Entwickeln und Verwenden von Claude Desktop\n\nWenn Sie mitwirken und testen möchten, was Claude mit Ihren Beiträgen macht;\n\n* Führen Sie `npm run dev` aus. Dadurch wird der Watcher gestartet, der den MCP-Server bei jeder Änderung neu aufbaut.\n* Aktualisieren Sie `claude_desktop_config.json` um direkt auf das Projekt zu verweisen, d. h.\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nDadurch 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.\n\n## Verkehrsmittel\n\nDer MCP-Server unterstützt zwei Transportmodi:\n\n### stdio Transport\n\nDer 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.\n\nUm den stdio-Modus zu verwenden, führen Sie den Server einfach ohne das Flag `--http` aus:\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### StreamableHTTP-Transport\n\nDer 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.\n\nUm den StreamableHTTP-Modus zu verwenden, führen Sie mit dem Flag `--http` Folgendes aus:\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### StreamableHTTP-Details\n\n* Verwendet den offiziellen MCP StreamableHTTP-Transport\n* Unterstützt Standard-MCP-Protokollvorgänge\n* Beinhaltet Sitzungsverwaltung zur Aufrechterhaltung des Status\n* Behandelt Initialisierungs-/Benachrichtigungsmuster ordnungsgemäß\n* Kompatibel mit Standard-MCP-Clients\n* Ersetzt den veralteten SSE-Transport durch den modernen Ansatz\n\nDie Implementierung folgt der Standardspezifikation des MCP-Protokolls und ermöglicht jedem MCP-Client die Verbindung zum Server ohne besondere Behandlung.\n\n## Fehlerbehandlung\n\nDer Server implementiert eine umfassende Fehlerbehandlung für:\n\n* Authentifizierungsfehler\n* Ratenbegrenzung\n* Ungültige Anfragen\n* Netzwerkprobleme\n* API-spezifische Fehler\n\n[![MseeP.ai-Sicherheitsbewertungsabzeichen](https://mseep.net/pr/ivo-toby-contentful-mcp-badge.png)](https://mseep.ai/app/ivo-toby-contentful-mcp)\n\n## Lizenz\n\nMIT-Lizenz\n\n## Kleingedrucktes\n\nDieser 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!\n\nDieser MCP-Server wird von Contentful (noch) nicht offiziell unterstützt","German","tag","de-DE",{"_27":39,"_31":42,"_36":43},{"_29":40,"_31":32,"_33":41},"Update, create, delete content, content-models and assets in your Contentful Space"," $\"Contentful$ \n\n# Contentful MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nAn MCP server implementation that integrates with Contentful's Content Management API, providing comprehensive content management capabilities.\n\n- Please note \\*; if you are not interested in the code, and just want to use this MCP in\n Claude Desktop (or any other tool that is able to use MCP servers) you don't have to\n clone this repo, you can just set it up in Claude desktop, refer to the section\n \"Usage with Claude Desktop\" for instructions on how to install it.\n\n $\"contentful-mcp$ \n\n## Features\n\n- **Content Management**: Full CRUD operations for entries and assets\n- **Space Management**: Create, update, and manage spaces and environments\n- **Content Types**: Manage content type definitions\n- **Localization**: Support for multiple locales\n- **Publishing**: Control content publishing workflow\n- **Bulk Operations**: Execute bulk publishing, unpublishing, and validation across multiple entries and assets\n- **Smart Pagination**: List operations return maximum 3 items per request to prevent context window overflow, with built-in pagination support\n\n## Pagination\n\nTo prevent context window overflow in LLMs, list operations (like search_entries and list_assets) are limited to 3 items per request. Each response includes:\n\n- Total number of available items\n- Current page of items (max 3)\n- Number of remaining items\n- Skip value for the next page\n- Message prompting the LLM to offer retrieving more items\n\nThis pagination system allows the LLM to efficiently handle large datasets while maintaining context window limits.\n\n## Bulk Operations\n\nThe bulk operations feature provides efficient management of multiple content items simultaneously:\n\n- **Asynchronous Processing**: Operations run asynchronously and provide status updates\n- **Efficient Content Management**: Process multiple entries or assets in a single API call\n- **Status Tracking**: Monitor progress with success and failure counts\n- **Resource Optimization**: Reduce API calls and improve performance for batch operations\n\nThese bulk operation tools are ideal for content migrations, mass updates, or batch publishing workflows.\n\n## Tools\n\n### Entry Management\n\n- **search_entries**: Search for entries using query parameters\n- **create_entry**: Create new entries\n- **get_entry**: Retrieve existing entries\n- **update_entry**: Update entry fields\n- **delete_entry**: Remove entries\n- **publish_entry**: Publish entries\n- **unpublish_entry**: Unpublish entries\n\n### Bulk Operations\n\n- **bulk_publish**: Publish multiple entries and assets in a single operation. Accepts an array of entities (entries and assets) and processes their publication as a batch.\n- **bulk_unpublish**: Unpublish multiple entries and assets in a single operation. Similar to bulk_publish but removes content from the delivery API.\n- **bulk_validate**: Validate multiple entries for content consistency, references, and required fields. Returns validation results without modifying content.\n\n### Asset Management\n\n- **list_assets**: List assets with pagination (3 items per page)\n- **upload_asset**: Upload new assets with metadata\n- **get_asset**: Retrieve asset details and information\n- **update_asset**: Update asset metadata and files\n- **delete_asset**: Remove assets from space\n- **publish_asset**: Publish assets to delivery API\n- **unpublish_asset**: Unpublish assets from delivery API\n\n### Space & Environment Management\n\n- **list_spaces**: List available spaces\n- **get_space**: Get space details\n- **list_environments**: List environments in a space\n- **create_environment**: Create new environment\n- **delete_environment**: Remove environment\n\n### Content Type Management\n\n- **list_content_types**: List available content types\n- **get_content_type**: Get content type details\n- **create_content_type**: Create new content type\n- **update_content_type**: Update content type\n- **delete_content_type**: Remove content type\n- **publish_content_type**: Publish a content type\n\n## Development Tools\n\n### MCP Inspector\n\nThe project includes an MCP Inspector tool that helps with development and debugging:\n\n- **Inspect Mode**: Run `npm run inspect` to start the inspector, you can open the inspector by going to http://localhost:5173\n- **Watch Mode**: Use `npm run inspect:watch` to automatically restart the inspector when files change\n- **Visual Interface**: The inspector provides a web interface to test and debug MCP tools\n- **Real-time Testing**: Try out tools and see their responses immediately\n- **Bulk Operations Testing**: Test and monitor bulk operations with visual feedback on progress and results\n\nThe project also contains a `npm run dev` command which rebuilds and reloads the MCP server on every change.\n\n## Configuration\n\n### Prerequisites\n\n1. Create a Contentful account at [Contentful](https://www.contentful.com/)\n2. Generate a Content Management API token from your account settings\n\n### Environment Variables\n\nThese variables can also be set as arguments\n\n- `CONTENTFUL_HOST` / `--host`: Contentful Management API Endpoint (defaults to https://api.contentful.com)\n- `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token`: Your Content Management API token\n- `ENABLE_HTTP_SERVER` / `--http`: Set to \"true\" to enable HTTP/SSE mode\n- `HTTP_PORT` / `--port`: Port for HTTP server (default: 3000)\n- `HTTP_HOST` / `--http-host`: Host for HTTP server (default: localhost)\n\n### Space and Environment Scoping\n\nYou can scope the spaceId and EnvironmentId to ensure the LLM will only do operations on the defined space/env ID's.\nThis is mainly to support agents that are to operate within specific spaces. If both `SPACE_ID` and `ENVIRONMENT_ID` env-vars are set\nthe tools will not report needing these values and the handlers will use the environment vars to do CMA operations.\nYou will also loose access to the tools in the space-handler, since these tools are across spaces.\nYou can also add the `SPACE_ID` and `ENVIRONMENT_ID` by using arguments `--space-id` and `--environment-id`\n\n#### Using App Identity\n\nInstead of providing a Management token you can also leverage [App Identity](https://www.contentful.com/developers/docs/extensibility/app-framework/app-identity/)\nfor handling authentication. You would have to setup and install a Contentful App and set the following parameters when calling the MCP-server:\n\n- `--app-id` = the app Id which is providing the Apptoken\n- `--private-key` = the private key you created in the user-interface with your app, tied to `app_id`\n- `--space-id` = the spaceId in which the app is installed\n- `--environment-id` = the environmentId (within the space) in which the app is installed.\n\nWith these values the MCP server will request a temporary AppToken to do content operation in the defined space/environment-id. This especially useful when using this MCP server in backend systems that act as MCP-client (like chat-agents)\n\n### Usage with Claude Desktop\n\nYou do not need to clone this repo to use this MCP, you can simply add it to\nyour `claude_desktop_config.json`:\n\nAdd or edit `~/Library/Application Support/Claude/claude_desktop_config.json`\nand add the following lines:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@ivotoby/contentful-management-mcp-server\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nIf your MCPClient does not support setting environment variables you can also set the management token using an argument like this:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### Installing via Smithery\n\nTo install Contentful Management Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### Developing and using Claude desktop\n\nIf you want to contribute and test what Claude does with your contributions;\n\n- run `npm run dev`, this will start the watcher that rebuilds the MCP server on every change\n- update `claude_desktop_config.json` to reference the project directly, ie;\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nThis will allow you to test any modification in the MCP server with Claude directly, however; if you add new tools/resources you will need to restart Claude Desktop\n\n## Transport Modes\n\nThe MCP server supports two transport modes:\n\n### stdio Transport\n\nThe default transport mode uses standard input/output streams for communication. This is ideal for integration with MCP clients that support stdio transport, like Claude Desktop.\n\nTo use stdio mode, simply run the server without the `--http` flag:\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### StreamableHTTP Transport\n\nThe server also supports the StreamableHTTP transport as defined in the MCP protocol. This mode is useful for web-based integrations or when running the server as a standalone service.\n\nTo use StreamableHTTP mode, run with the `--http` flag:\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### StreamableHTTP Details\n\n- Uses the official MCP StreamableHTTP transport\n- Supports standard MCP protocol operations\n- Includes session management for maintaining state\n- Properly handles initialize/notify patterns\n- Compatible with standard MCP clients\n- Replaces the deprecated SSE transport with the modern approach\n\nThe implementation follows the standard MCP protocol specification, allowing any MCP client to connect to the server without special handling.\n\n## Error Handling\n\nThe server implements comprehensive error handling for:\n\n- Authentication failures\n- Rate limiting\n- Invalid requests\n- Network issues\n- API-specific errors\n\n[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/ivo-toby-contentful-mcp-badge.png)](https://mseep.ai/app/ivo-toby-contentful-mcp)\n\n## License\n\nMIT License\n\n## Fine print\n\nThis MCP Server enables Claude (or other agents that can consume MCP resources) to update, delete content, spaces and content-models. So be sure what you allow Claude to do with your Contentful spaces!\n\nThis MCP-server is not officially supported by Contentful (yet)\n","English","en-US",{"_27":45,"_31":49,"_36":50},{"_29":46,"_31":47,"_33":48},"Actualice, cree y elimine contenido, modelos de contenido y activos en su Contentful Space","contenido-mcp","# Servidor MCP de Contentful\n\n[![insignia de herrería](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nUna implementación de servidor MCP que se integra con la API de administración de contenido de Contentful, proporcionando capacidades integrales de administración de contenido.\n\n* Tenga en cuenta \\*; si no está interesado en el código y solo desea usar este MCP en Claude Desktop (o cualquier otra herramienta que pueda usar servidores MCP), no tiene que clonar este repositorio, simplemente puede configurarlo en Claude Desktop, consulte la sección \"Uso con Claude Desktop\" para obtener instrucciones sobre cómo instalarlo.\n\n## Características\n\n* **Gestión de contenido** : Operaciones CRUD completas para entradas y activos\n* **Gestión de espacios** : crear, actualizar y gestionar espacios y entornos\n* **Tipos de contenido** : Administrar definiciones de tipos de contenido\n* **Localización** : Compatibilidad con múltiples configuraciones regionales\n* **Publicación** : Controlar el flujo de trabajo de publicación de contenido\n* **Operaciones masivas** : ejecute publicaciones, cancelaciones de publicaciones y validaciones masivas en múltiples entradas y activos\n* **Paginación inteligente** : las operaciones de lista devuelven un máximo de 3 elementos por solicitud para evitar el desbordamiento de la ventana de contexto, con soporte de paginación integrado\n\n## Paginación\n\nPara evitar el desbordamiento de la ventana de contexto en los LLM, las operaciones de lista (como search\\_entries y list\\_assets) se limitan a 3 elementos por solicitud. Cada respuesta incluye:\n\n* Número total de artículos disponibles\n* Página actual de artículos (máximo 3)\n* Número de artículos restantes\n* Saltar valor para la página siguiente\n* Mensaje que solicita al LLM que ofrezca recuperar más elementos\n\nEste sistema de paginación permite al LLM gestionar de manera eficiente grandes conjuntos de datos manteniendo los límites de la ventana de contexto.\n\n## Operaciones a granel\n\nLa función de operaciones masivas proporciona una gestión eficiente de varios elementos de contenido simultáneamente:\n\n* **Procesamiento asincrónico** : las operaciones se ejecutan de forma asincrónica y proporcionan actualizaciones de estado\n* **Gestión eficiente de contenido** : procese múltiples entradas o activos en una sola llamada API\n* **Seguimiento del estado** : supervise el progreso con recuentos de éxitos y fracasos\n* **Optimización de recursos** : reduzca las llamadas a la API y mejore el rendimiento de las operaciones por lotes\n\nEstas herramientas de operación masiva son ideales para migraciones de contenido, actualizaciones masivas o flujos de trabajo de publicación por lotes.\n\n## Herramientas\n\n### Gestión de entradas\n\n* **search\\_entries** : busca entradas utilizando parámetros de consulta\n* **create\\_entry** : Crea nuevas entradas\n* **get\\_entry** : Recuperar entradas existentes\n* **update\\_entry** : Actualizar campos de entrada\n* **delete\\_entry** : Eliminar entradas\n* **publish\\_entry** : Publicar entradas\n* **unpublish\\_entry** : Anular la publicación de entradas\n\n### Operaciones a granel\n\n* **bulk\\_publish** : Publica varias entradas y recursos en una sola operación. Acepta un conjunto de entidades (entradas y recursos) y procesa su publicación por lotes.\n* **bulk\\_unpublish** : Anula la publicación de varias entradas y recursos en una sola operación. Similar a bulk\\_publish, pero elimina el contenido de la API de entrega.\n* **bulk\\_validate** : Valida múltiples entradas para verificar la consistencia del contenido, las referencias y los campos obligatorios. Devuelve los resultados de la validación sin modificar el contenido.\n\n### Gestión de activos\n\n* **list\\_assets** : Lista de activos con paginación (3 elementos por página)\n* **upload\\_asset** : Cargar nuevos activos con metadatos\n* **get\\_asset** : recupera detalles e información del activo\n* **update\\_asset** : Actualizar metadatos y archivos de activos\n* **delete\\_asset** : Eliminar activos del espacio\n* **publish\\_asset** : Publicar activos en la API de entrega\n* **unpublish\\_asset** : Anular la publicación de activos de la API de entrega\n\n### Gestión del espacio y el medio ambiente\n\n* **list\\_spaces** : Lista de espacios disponibles\n* **get\\_space** : Obtener detalles del espacio\n* **list\\_environments** : Lista de entornos en un espacio\n* **create\\_environment** : Crear nuevo entorno\n* **delete\\_environment** : Eliminar entorno\n\n### Gestión de tipos de contenido\n\n* **list\\_content\\_types** : Lista de tipos de contenido disponibles\n* **get\\_content\\_type** : Obtener detalles del tipo de contenido\n* **create\\_content\\_type** : Crea un nuevo tipo de contenido\n* **update\\_content\\_type** : Actualizar el tipo de contenido\n* **delete\\_content\\_type** : Eliminar el tipo de contenido\n* **publish\\_content\\_type** : Publicar un tipo de contenido\n\n## Herramientas de desarrollo\n\n### Inspector de MCP\n\nEl proyecto incluye una herramienta MCP Inspector que ayuda con el desarrollo y la depuración:\n\n* **Modo de inspección** : ejecute `npm run inspect` para iniciar el inspector. Puede abrirlo yendo a \n* **Modo de observación** : use `npm run inspect:watch` para reiniciar automáticamente el inspector cuando cambien los archivos\n* **Interfaz visual** : el inspector proporciona una interfaz web para probar y depurar herramientas MCP\n* **Pruebas en tiempo real** : Pruebe las herramientas y vea sus respuestas inmediatamente\n* **Pruebas de operaciones masivas** : pruebe y supervise las operaciones masivas con comentarios visuales sobre el progreso y los resultados.\n\nEl proyecto también contiene un comando `npm run dev` que reconstruye y recarga el servidor MCP en cada cambio.\n\n## Configuración\n\n### Prerrequisitos\n\n1. Crea una cuenta Contentful en [Contentful](https://www.contentful.com/)\n2. Genere un token de API de gestión de contenido desde la configuración de su cuenta\n\n### Variables de entorno\n\nEstas variables también se pueden configurar como argumentos.\n\n* `CONTENTFUL_HOST` / `--host` : Punto final de la API de administración de Contentful (el valor predeterminado es )\n* `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token` : Su token de API de administración de contenido\n* `ENABLE_HTTP_SERVER` / `--http` : Establézcalo en \"verdadero\" para habilitar el modo HTTP/SSE\n* `HTTP_PORT` / `--port` : Puerto para el servidor HTTP (predeterminado: 3000)\n* `HTTP_HOST` / `--http-host` : Host para el servidor HTTP (predeterminado: localhost)\n\n### Alcance del espacio y el medio ambiente\n\nPuede definir el alcance de spaceId y EnvironmentId para garantizar que el LLM solo realice operaciones en los ID de espacio/entorno definidos. Esto se hace principalmente para dar soporte a los agentes que operan en espacios específicos. Si se configuran las variables de entorno `SPACE_ID` y `ENVIRONMENT_ID` , las herramientas no informarán que necesitan estos valores y los controladores usarán las variables de entorno para realizar operaciones de CMA. También perderá el acceso a las herramientas del controlador de espacio, ya que estas herramientas se encuentran en diferentes espacios. También puede agregar `SPACE_ID` y `ENVIRONMENT_ID` mediante los argumentos `--space-id` y `--environment-id`\n\n#### Uso de la identidad de la aplicación\n\nEn lugar de proporcionar un token de administración, también puede usar [App Identity](https://www.contentful.com/developers/docs/extensibility/app-framework/app-identity/) para gestionar la autenticación. Deberá configurar e instalar una aplicación Contentful y configurar los siguientes parámetros al llamar al servidor MCP:\n\n* `--app-id` = el Id. de la aplicación que proporciona el Apptoken\n* `--private-key` = la clave privada que creó en la interfaz de usuario con su aplicación, vinculada a `app_id`\n* `--space-id` = el spaceId en el que está instalada la aplicación\n* `--environment-id` = el environmentId (dentro del espacio) en el que está instalada la aplicación.\n\nCon estos valores, el servidor MCP solicitará un AppToken temporal para realizar operaciones de contenido en el espacio/ID de entorno definido. Esto resulta especialmente útil al usar este servidor MCP en sistemas backend que actúan como clientes MCP (como agentes de chat).\n\n### Uso con Claude Desktop\n\nNo necesitas clonar este repositorio para usar este MCP, simplemente puedes agregarlo a tu `claude_desktop_config.json` :\n\nAgregue o edite `~/Library/Application Support/Claude/claude_desktop_config.json` y agregue las siguientes líneas:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@ivotoby/contentful-management-mcp-server\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nSi su MCPClient no admite la configuración de variables de entorno, también puede configurar el token de administración utilizando un argumento como este:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### Instalación mediante herrería\n\nPara instalar Contentful Management Server para Claude Desktop automáticamente a través de [Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server) :\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### Desarrollo y uso del escritorio Claude\n\nSi quieres contribuir y probar lo que Claude hace con tus contribuciones;\n\n* Ejecute `npm run dev` , esto iniciará el observador que reconstruye el servidor MCP en cada cambio\n* actualice `claude_desktop_config.json` para hacer referencia al proyecto directamente, es decir;\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nEsto le permitirá probar cualquier modificación en el servidor MCP con Claude directamente, sin embargo; si agrega nuevas herramientas/recursos necesitará reiniciar Claude Desktop\n\n## Modos de transporte\n\nEl servidor MCP admite dos modos de transporte:\n\n### Transporte de stdio\n\nEl modo de transporte predeterminado utiliza flujos de entrada/salida estándar para la comunicación. Esto es ideal para la integración con clientes MCP compatibles con el transporte stdio, como Claude Desktop.\n\nPara utilizar el modo stdio, simplemente ejecute el servidor sin el indicador `--http` :\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### Transporte HTTP Streamable\n\nEl servidor también admite el transporte StreamableHTTP, tal como se define en el protocolo MCP. Este modo es útil para integraciones web o al ejecutar el servidor como un servicio independiente.\n\nPara utilizar el modo StreamableHTTP, ejecute con el indicador `--http` :\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### Detalles de StreamableHTTP\n\n* Utiliza el transporte oficial MCP StreamableHTTP\n* Admite operaciones del protocolo MCP estándar\n* Incluye gestión de sesiones para mantener el estado.\n* Maneja adecuadamente los patrones de inicialización/notificación\n* Compatible con clientes MCP estándar\n* Reemplaza el transporte SSE obsoleto con el enfoque moderno\n\nLa implementación sigue la especificación del protocolo MCP estándar, lo que permite que cualquier cliente MCP se conecte al servidor sin un manejo especial.\n\n## Manejo de errores\n\nEl servidor implementa un manejo integral de errores para:\n\n* Errores de autenticación\n* Limitación de velocidad\n* Solicitudes no válidas\n* Problemas de red\n* Errores específicos de la API\n\n[![Insignia de evaluación de seguridad de MseeP.ai](https://mseep.net/pr/ivo-toby-contentful-mcp-badge.png)](https://mseep.ai/app/ivo-toby-contentful-mcp)\n\n## Licencia\n\nLicencia MIT\n\n## Letra pequeña\n\nEste servidor MCP permite a Claude (u otros agentes que puedan consumir recursos MCP) actualizar y eliminar contenido, espacios y modelos de contenido. ¡Así que asegúrese de lo que permite a Claude hacer con sus espacios Contentful!\n\nEste servidor MCP no cuenta con soporte oficial de Contentful (aún)","Spanish","es-ES",{"_27":52,"_31":56,"_36":57},{"_29":53,"_31":54,"_33":55},"Contentful Space 内のコンテンツ、コンテンツモデル、アセットを更新、作成、削除します","コンテンツフルMCP","# コンテンツフル MCP サーバー\n\n[![鍛冶屋のバッジ](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nContentful のコンテンツ管理 API と統合し、包括的なコンテンツ管理機能を提供する MCP サーバー実装。\n\n* ご注意ください \\*; コードに興味がなく、この MCP を Claude Desktop (または MCP サーバーを使用できるその他のツール) で使用したいだけの場合は、このリポジトリを複製する必要はなく、Claude Desktop でセットアップするだけで済みます。インストール方法については、「Claude Desktop での使用」セクションを参照してください。\n\n## 特徴\n\n* **コンテンツ管理**: エントリとアセットの完全なCRUD操作\n* **スペース管理**: スペースと環境を作成、更新、管理します\n* **コンテンツタイプ**: コンテンツタイプの定義を管理する\n* **ローカライズ**: 複数のロケールのサポート\n* **公開**: コンテンツ公開ワークフローを制御する\n* **一括操作**: 複数のエントリとアセットにわたって一括公開、非公開、検証を実行します。\n* **スマートページネーション**: リスト操作は、コンテキストウィンドウのオーバーフローを防ぐために、組み込みのページネーションサポートを使用して、リクエストごとに最大3つのアイテムを返します。\n\n## ページネーション\n\nLLMにおけるコンテキストウィンドウのオーバーフローを防ぐため、リスト操作（search\\_entriesやlist\\_assetsなど）はリクエストごとに3項目までに制限されています。各レスポンスには以下が含まれます。\n\n* 利用可能なアイテムの合計数\n* 現在のアイテムページ（最大 3 件）\n* 残りのアイテム数\n* 次のページのスキップ値\n* LLMにさらなるアイテムの取得を提案するよう促すメッセージ\n\nこのページ区切りシステムにより、LLM はコンテキストウィンドウの制限を維持しながら大規模なデータセットを効率的に処理できます。\n\n## 一括操作\n\n一括操作機能により、複数のコンテンツ項目を同時に効率的に管理できます。\n\n* **非同期処理**: 操作は非同期的に実行され、ステータスの更新が提供されます\n* **効率的なコンテンツ管理**: 1回のAPI呼び出しで複数のエントリまたはアセットを処理\n* **ステータス追跡**: 成功と失敗の数で進捗状況を監視\n* **リソースの最適化**: API呼び出しを減らし、バッチ操作のパフォーマンスを向上\n\nこれらの一括操作ツールは、コンテンツの移行、大量更新、バッチ公開ワークフローに最適です。\n\n## ツール\n\n### 入場管理\n\n* **search\\_entries** : クエリパラメータを使用してエントリを検索する\n* **create\\_entry** : 新しいエントリを作成する\n* **get\\_entry** : 既存のエントリを取得する\n* **update\\_entry** : エントリフィールドを更新する\n* **delete\\_entry** : エントリを削除する\n* **publish\\_entry** : エントリを公開する\n* **unpublish\\_entry** : エントリを非公開にする\n\n### 一括操作\n\n* **bulk\\_publish** : 複数のエントリとアセットを1回の操作で公開します。エンティティ（エントリとアセット）の配列を受け取り、それらの公開を一括処理します。\n* **bulk\\_unpublish** : 複数のエントリとアセットを1回の操作で非公開にします。bulk\\_publish と似ていますが、配信APIからコンテンツを削除します。\n* **bulk\\_validate** : 複数のエントリのコンテンツの一貫性、参照、必須フィールドを検証します。コンテンツを変更せずに検証結果を返します。\n\n### 資産運用管理\n\n* **list\\_assets** : ページ区切りでアセットを一覧表示します（1 ページあたり 3 項目）\n* **upload\\_asset** : メタデータを含む新しいアセットをアップロードする\n* **get\\_asset** : 資産の詳細と情報を取得する\n* **update\\_asset** : アセットのメタデータとファイルを更新する\n* **delete\\_asset** : スペースからアセットを削除する\n* **publish\\_asset** : アセットを配信APIに公開する\n* **unpublish\\_asset** : 配信 API からアセットを非公開にする\n\n### 宇宙と環境管理\n\n* **list\\_spaces** : 利用可能なスペースを一覧表示する\n* **get\\_space** : スペースの詳細を取得する\n* **list\\_environments** : スペース内の環境を一覧表示する\n* **create\\_environment** : 新しい環境を作成する\n* **delete\\_environment** : 環境を削除する\n\n### コンテンツタイプ管理\n\n* **list\\_content\\_types** : 利用可能なコンテンツタイプを一覧表示する\n* **get\\_content\\_type** : コンテンツタイプの詳細を取得する\n* **create\\_content\\_type** : 新しいコンテンツタイプを作成する\n* **update\\_content\\_type** : コンテンツタイプの更新\n* **delete\\_content\\_type** : コンテンツタイプを削除する\n* **publish\\_content\\_type** : コンテンツタイプを公開する\n\n## 開発ツール\n\n### MCP検査官\n\nこのプロジェクトには、開発とデバッグに役立つ MCP Inspector ツールが含まれています。\n\n* **インスペクターモード**: `npm run inspect`を実行してインスペクターを起動します。http [://localhost:5173](http://localhost:5173)にアクセスしてインスペクターを開くことができます。\n* **ウォッチモード**: `npm run inspect:watch`を使用すると、ファイルが変更されたときにインスペクターが自動的に再起動されます。\n* **ビジュアルインターフェース**: インスペクターは、MCPツールをテストおよびデバッグするためのWebインターフェースを提供します。\n* **リアルタイムテスト**: ツールを試して、その反応をすぐに確認します\n* **一括操作のテスト**: 進捗状況と結果の視覚的なフィードバックを使用して一括操作をテストおよび監視します。\n\nこのプロジェクトには、変更のたびに MCP サーバーを再構築して再ロードする`npm run dev`コマンドも含まれています。\n\n## 構成\n\n### 前提条件\n\n1. [Contentful](https://www.contentful.com/)でContentfulアカウントを作成する\n2. アカウント設定からコンテンツ管理APIトークンを生成する\n\n### 環境変数\n\nこれらの変数は引数として設定することもできる\n\n* `CONTENTFUL_HOST` / `--host` : Contentful 管理 API エンドポイント (デフォルトは )\n* `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token` : コンテンツ管理APIトークン\n* `ENABLE_HTTP_SERVER` / `--http` : HTTP/SSEモードを有効にするには「true」に設定します\n* `HTTP_PORT` / `--port` : HTTPサーバーのポート（デフォルト: 3000）\n* `HTTP_HOST` / `--http-host` : HTTPサーバーのホスト（デフォルト: localhost）\n\n### 宇宙と環境のスコープ\n\nspaceIdとEnvironmentIdのスコープを設定することで、LLMが定義された空間/環境IDに対してのみ操作`SPACE_ID`実行するようにすることができます。これは主に、特定の空間内で動作するエージェントをサポートするためです。SPACE\\_IDと`ENVIRONMENT_ID`両方の環境変数が設定されている場合、ツールはこれらの値が必要であることを報告せず、ハンドラーは環境変数を使用してCMA操作を実行します。また、これらのツールは複数の空間にまたがるため、空間ハンドラー内のツールへのアクセスも失われます。-- `--space-id`および`--environment-id`引数を使用して、 `SPACE_ID`と`ENVIRONMENT_ID`を追加することもできます。\n\n#### アプリIDの使用\n\n管理トークンを提供する代わりに、 [App Identity](https://www.contentful.com/developers/docs/extensibility/app-framework/app-identity/)を利用して認証を処理することもできます。Contentfulアプリをセットアップしてインストールし、MCPサーバーを呼び出す際に以下のパラメータを設定する必要があります。\n\n* `--app-id` = Apptokenを提供しているアプリID\n* `--private-key` = アプリのユーザーインターフェースで作成した、 `app_id`に紐付けられた秘密鍵\n* `--space-id` = アプリがインストールされているスペースID\n* `--environment-id` = アプリがインストールされている環境 ID (スペース内)。\n\nこれらの値により、MCPサーバーは定義された空間/環境IDでコンテンツ操作を行うために一時的なAppTokenを要求します。これは、MCPクライアント（チャットエージェントなど）として機能するバックエンドシステムでこのMCPサーバーを使用する場合に特に便利です。\n\n### Claude Desktopでの使用\n\nこの MCP を使用するためにこのリポジトリをクローンする必要はありません`claude_desktop_config.json`に追加するだけです。\n\n`~/Library/Application Support/Claude/claude_desktop_config.json`を追加または編集し、次の行を追加します。\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@ivotoby/contentful-management-mcp-server\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nMCPClient が環境変数の設定をサポートしていない場合は、次のような引数を使用して管理トークンを設定することもできます。\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### Smithery経由でインストール\n\n[Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)経由で Claude Desktop 用の Contentful Management Server を自動的にインストールするには:\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### Claudeデスクトップの開発と使用\n\nあなたが貢献して、Claude があなたの貢献によって何を行うかをテストしたい場合;\n\n* `npm run dev`を実行すると、変更ごとに MCP サーバーを再構築するウォッチャーが起動します。\n* プロジェクトを直接参照するように`claude_desktop_config.json`を更新します。\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nこれにより、MCPサーバーの変更をClaudeで直接テストできるようになります。ただし、新しいツール/リソースを追加する場合は、Claude Desktopを再起動する必要があります。\n\n## 輸送モード\n\nMCP サーバーは、次の 2 つのトランスポートモードをサポートしています。\n\n### stdioトランスポート\n\nデフォルトのトランスポートモードでは、通信に標準入出力ストリームを使用します。これは、Claude Desktop などの標準入出力トランスポートをサポートする MCP クライアントとの統合に最適です。\n\nstdio モードを使用するには、 `--http`フラグなしでサーバーを実行するだけです。\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### ストリーミング可能なHTTPトランスポート\n\nサーバーは、MCPプロトコルで定義されているStreamableHTTPトランスポートもサポートしています。このモードは、Webベースの統合や、サーバーをスタンドアロンサービスとして実行する場合に役立ちます。\n\nStreamableHTTP モードを使用するには、 `--http`フラグを付けて実行します。\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### StreamableHTTPの詳細\n\n* 公式MCP StreamableHTTPトランスポートを使用\n* 標準MCPプロトコル操作をサポート\n* 状態を維持するためのセッション管理が含まれています\n* 初期化/通知パターンを適切に処理します\n* 標準MCPクライアントと互換性あり\n* 廃止されたSSEトランスポートを最新のアプローチに置き換えます\n\n実装は標準の MCP プロトコル仕様に準拠しており、特別な処理なしで任意の MCP クライアントがサーバーに接続できます。\n\n## エラー処理\n\nサーバーは、以下に対する包括的なエラー処理を実装します。\n\n* 認証失敗\n* レート制限\n* 無効なリクエスト\n* ネットワークの問題\n* API固有のエラー\n\n[![MseeP.ai セキュリティ評価バッジ](https://mseep.net/pr/ivo-toby-contentful-mcp-badge.png)](https://mseep.ai/app/ivo-toby-contentful-mcp)\n\n## ライセンス\n\nMITライセンス\n\n## 細則\n\nこのMCPサーバーは、Claude（またはMCPリソースを消費できる他のエージェント）がコンテンツ、スペース、コンテンツモデルを更新、削除できるようにします。そのため、ContentfulスペースでClaudeにどのような操作を許可するかは慎重に検討してください。\n\nこのMCPサーバーはContentfulによって公式にサポートされていません（まだ）","Japanese","ja-JP",{"_27":59,"_31":62,"_36":63},{"_29":60,"_31":32,"_33":61},"Contentful Space에서 콘텐츠, 콘텐츠 모델 및 자산을 업데이트, 생성, 삭제합니다.","# 콘텐츠가 풍부한 MCP 서버\n\n[![대장간 배지](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nContentful의 콘텐츠 관리 API와 통합되어 포괄적인 콘텐츠 관리 기능을 제공하는 MCP 서버 구현입니다.\n\n* 주의 사항 \\*; 코드에 관심이 없고 Claude Desktop(또는 MCP 서버를 사용할 수 있는 다른 도구)에서 이 MCP를 사용하려는 경우 이 저장소를 복제할 필요가 없으며 Claude Desktop에서 설정하기만 하면 됩니다. 설치 방법에 대한 지침은 \"Claude Desktop 사용\" 섹션을 참조하세요.\n\n## 특징\n\n* **콘텐츠 관리** : 항목 및 자산에 대한 전체 CRUD 작업\n* **공간 관리** : 공간과 환경을 생성, 업데이트 및 관리합니다.\n* **콘텐츠 유형** : 콘텐츠 유형 정의 관리\n* **현지화** : 여러 로캘 지원\n* **게시** : 콘텐츠 게시 워크플로 제어\n* **대량 작업** : 여러 항목 및 자산에 대한 대량 게시, 게시 취소 및 검증을 실행합니다.\n* **스마트 페이징** : 목록 작업은 컨텍스트 창 오버플로를 방지하기 위해 요청당 최대 3개 항목을 반환하며, 내장된 페이징 지원이 제공됩니다.\n\n## 쪽수 매기기\n\nLLM에서 컨텍스트 창 오버플로를 방지하기 위해 목록 작업(예: search\\_entries 및 list\\_assets)은 요청당 3개 항목으로 제한됩니다. 각 응답에는 다음이 포함됩니다.\n\n* 사용 가능한 항목의 총 수\n* 현재 항목 페이지(최대 3개)\n* 남은 항목 수\n* 다음 페이지로 건너뛰기 값\n* LLM에 추가 항목 검색을 제안하는 메시지\n\n이 페이지 분할 시스템을 사용하면 LLM이 컨텍스트 창 제한을 유지하면서도 대규모 데이터 세트를 효율적으로 처리할 수 있습니다.\n\n## 대량 작업\n\n대량 작업 기능은 여러 콘텐츠 항목을 동시에 효율적으로 관리할 수 있도록 해줍니다.\n\n* **비동기 처리** : 작업이 비동기적으로 실행되고 상태 업데이트를 제공합니다.\n* **효율적인 콘텐츠 관리** : 단일 API 호출로 여러 항목 또는 자산 처리\n* **상태 추적** : 성공 및 실패 횟수를 통해 진행 상황을 모니터링합니다.\n* **리소스 최적화** : API 호출을 줄이고 일괄 작업의 성능을 향상시킵니다.\n\n이러한 대량 작업 도구는 콘텐츠 마이그레이션, 대량 업데이트 또는 일괄 게시 워크플로에 이상적입니다.\n\n## 도구\n\n### 출입 관리\n\n* **search\\_entries** : 쿼리 매개변수를 사용하여 항목 검색\n* **create\\_entry** : 새 항목 만들기\n* **get\\_entry** : 기존 항목 검색\n* **update\\_entry** : 항목 필드 업데이트\n* **delete\\_entry** : 항목 제거\n* **publish\\_entry** : 항목 게시\n* **unpublish\\_entry** : 항목 게시 취소\n\n### 대량 작업\n\n* **bulk\\_publish** : 단일 작업으로 여러 항목과 에셋을 게시합니다. 엔터티(항목 및 에셋) 배열을 받아서 일괄적으로 게시합니다.\n* **bulk\\_unpublish** : 여러 항목과 에셋을 한 번에 게시 취소합니다. bulk\\_publish와 유사하지만 전송 API에서 콘텐츠를 제거합니다.\n* **bulk\\_validate** : 콘텐츠 일관성, 참조 및 필수 필드에 대해 여러 항목의 유효성을 검사합니다. 콘텐츠를 수정하지 않고 유효성 검사 결과를 반환합니다.\n\n### 자산 관리\n\n* **list\\_assets** : 페이지별로 자산 목록 표시(페이지당 3개 항목)\n* **upload\\_asset** : 메타데이터를 포함한 새로운 자산 업로드\n* **get\\_asset** : 자산 세부 정보 및 정보를 검색합니다.\n* **update\\_asset** : 자산 메타데이터 및 파일 업데이트\n* **delete\\_asset** : 공간에서 자산 제거\n* **publish\\_asset** : 전달 API에 자산 게시\n* **unpublish\\_asset** : 전달 API에서 자산 게시 취소\n\n### 우주 및 환경 관리\n\n* **list\\_spaces** : 사용 가능한 공간 나열\n* **get\\_space** : 공간 세부 정보 가져오기\n* **list\\_environments** : 공간의 환경 나열\n* **create\\_environment** : 새로운 환경을 생성합니다\n* **delete\\_environment** : 환경 제거\n\n### 콘텐츠 유형 관리\n\n* **list\\_content\\_types** : 사용 가능한 콘텐츠 유형 나열\n* **get\\_content\\_type** : 콘텐츠 유형 세부 정보 가져오기\n* **create\\_content\\_type** : 새로운 콘텐츠 유형을 만듭니다.\n* **update\\_content\\_type** : 콘텐츠 유형 업데이트\n* **delete\\_content\\_type** : 콘텐츠 유형 제거\n* **publish\\_content\\_type** : 콘텐츠 유형을 게시합니다.\n\n## 개발 도구\n\n### MCP 검사관\n\n이 프로젝트에는 개발 및 디버깅에 도움이 되는 MCP Inspector 도구가 포함되어 있습니다.\n\n* **검사 모드** : `npm run inspect` 실행하여 검사기를 시작합니다. 으로 이동하여 검사기를 열 수 있습니다.\n* **감시 모드** : `npm run inspect:watch` 사용하여 파일이 변경될 때 검사기를 자동으로 다시 시작합니다.\n* **시각적 인터페이스** : 검사기는 MCP 도구를 테스트하고 디버깅하기 위한 웹 인터페이스를 제공합니다.\n* **실시간 테스트** : 도구를 사용해 보고 즉각적인 반응을 확인하세요\n* **대량 작업 테스트** : 진행 상황 및 결과에 대한 시각적 피드백을 통해 대량 작업을 테스트하고 모니터링합니다.\n\n이 프로젝트에는 모든 변경 사항에서 MCP 서버를 다시 빌드하고 다시 로드하는 `npm run dev` 명령도 포함되어 있습니다.\n\n## 구성\n\n### 필수 조건\n\n1. [Contentful](https://www.contentful.com/) 에서 Contentful 계정을 만드세요\n2. 계정 설정에서 콘텐츠 관리 API 토큰을 생성합니다.\n\n### 환경 변수\n\n이러한 변수는 인수로 설정할 수도 있습니다.\n\n* `CONTENTFUL_HOST` / `--host` : Contentful 관리 API 엔드포인트(기본값은 )\n* `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token` : 콘텐츠 관리 API 토큰\n* `ENABLE_HTTP_SERVER` / `--http` : HTTP/SSE 모드를 활성화하려면 \"true\"로 설정합니다.\n* `HTTP_PORT` / `--port` : HTTP 서버의 포트(기본값: 3000)\n* `HTTP_HOST` / `--http-host` : HTTP 서버의 호스트(기본값: localhost)\n\n### 우주 및 환경 범위\n\nLLM이 정의된 공간/환경 ID에 대해서만 작업을 수행하도록 spaceId와 EnvironmentId의 범위를 지정할 수 있습니다. 이는 주로 특정 공간 내에서 작업하는 에이전트를 지원하기 위한 것입니다. `SPACE_ID` 와 `ENVIRONMENT_ID` 환경 변수가 모두 설정된 경우, 도구는 이러한 값이 필요하지 않다고 보고하고 핸들러는 환경 변수를 사용하여 CMA 작업을 수행합니다. 또한 이러한 도구는 여러 공간에 분산되어 있으므로 공간 핸들러의 도구에 대한 액세스 권한을 잃게 됩니다. `--space-id` 및 `--environment-id` 인수를 사용하여 `SPACE_ID` 와 `ENVIRONMENT_ID` 추가할 수도 있습니다.\n\n#### 앱 ID 사용\n\n관리 토큰을 제공하는 대신 [앱 ID를](https://www.contentful.com/developers/docs/extensibility/app-framework/app-identity/) 활용하여 인증을 처리할 수도 있습니다. Contentful 앱을 설정하고 설치한 후 MCP 서버를 호출할 때 다음 매개변수를 설정해야 합니다.\n\n* `--app-id` = Apptoken을 제공하는 앱 ID\n* `--private-key` = 앱의 사용자 인터페이스에서 생성한 개인 키로 `app_id` 에 연결됨\n* `--space-id` = 앱이 설치된 spaceId\n* `--environment-id` = 앱이 설치된 환경 ID(공간 내)입니다.\n\n이러한 값을 사용하면 MCP 서버는 정의된 공간/환경 ID에서 콘텐츠 작업을 수행하기 위해 임시 AppToken을 요청합니다. 이는 특히 MCP 클라이언트(예: 채팅 에이전트) 역할을 하는 백엔드 시스템에서 이 MCP 서버를 사용할 때 유용합니다.\n\n### Claude Desktop과 함께 사용\n\n이 MCP를 사용하려면 이 저장소를 복제할 필요가 없습니다. 간단히 `claude_desktop_config.json` 에 추가하면 됩니다.\n\n`~/Library/Application Support/Claude/claude_desktop_config.json` 추가하거나 편집하고 다음 줄을 추가합니다.\n\n지엑스피1\n\nMCPClient가 환경 변수 설정을 지원하지 않는 경우 다음과 같은 인수를 사용하여 관리 토큰을 설정할 수도 있습니다.\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### Smithery를 통해 설치\n\n[Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server) 를 통해 Claude Desktop용 Contentful Management Server를 자동으로 설치하려면:\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### Claude 데스크톱 개발 및 사용\n\n만약 당신이 기여하고 클로드가 당신의 기여로 무엇을 하는지 시험하고 싶다면;\n\n* `npm run dev` 실행하면 모든 변경 사항에서 MCP 서버를 다시 빌드하는 감시자가 시작됩니다.\n* 프로젝트를 직접 참조하도록 `claude_desktop_config.json` 업데이트합니다. 즉,\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n이렇게 하면 Claude를 사용하여 MCP 서버에서 수정 사항을 직접 테스트할 수 있습니다. 그러나 새 도구/리소스를 추가하는 경우 Claude Desktop을 다시 시작해야 합니다.\n\n## 운송 모드\n\nMCP 서버는 두 가지 전송 모드를 지원합니다.\n\n### stdio 전송\n\n기본 전송 모드는 통신에 표준 입출력 스트림을 사용합니다. 이는 Claude Desktop처럼 stdio 전송을 지원하는 MCP 클라이언트와의 통합에 이상적입니다.\n\nstdio 모드를 사용하려면 `--http` 플래그 없이 서버를 실행하기만 하면 됩니다.\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### 스트리밍 가능한 HTTP 전송\n\n서버는 MCP 프로토콜에 정의된 StreamableHTTP 전송 방식도 지원합니다. 이 모드는 웹 기반 통합이나 서버를 독립형 서비스로 실행할 때 유용합니다.\n\nStreamableHTTP 모드를 사��하려면 `--http` 플래그와 함께 실행하세요.\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### StreamableHTTP 세부 정보\n\n* 공식 MCP StreamableHTTP 전송을 사용합니다.\n* 표준 MCP 프로토콜 작업을 지원합니다.\n* 상태 유지를 위한 세션 관리 포함\n* 초기화/알림 패턴을 적절히 처리합니다.\n* 표준 MCP 클라이언트와 호환 가능\n* 더 이상 사용되지 않는 SSE 전송을 최신 접근 방식으로 대체합니다.\n\n구현은 표준 MCP 프로토콜 사양을 따르므로 모든 MCP 클라이언트가 특별한 처리 없이 서버에 연결할 수 있습니다.\n\n## 오류 처리\n\n서버는 다음에 대한 포괄적인 오류 처리를 구현합니다.\n\n* 인증 실패\n* 속도 제한\n* 잘못된 요청\n* 네트워크 문제\n* API 관련 오류\n\n[![MseeP.ai 보안 평가 배지](https://mseep.net/pr/ivo-toby-contentful-mcp-badge.png)](https://mseep.ai/app/ivo-toby-contentful-mcp)\n\n## 특허\n\nMIT 라이센스\n\n## 세부 사항\n\n이 MCP 서버는 Claude(또는 MCP 리소스를 사용할 수 있는 다른 에이전트)가 콘텐츠, 스페이스 및 콘텐츠 모델을 업데이트하고 삭제할 수 있도록 합니다. 따라서 Claude가 Contentful 스페이스에서 어떤 작업을 할 수 있는지 신중하게 고려해야 합니다!\n\n이 MCP 서버는 아직 Contentful에서 공식적으로 지원되지 않습니다.","Korean","ko-KR",{"_27":65,"_31":69,"_36":70},{"_29":66,"_31":67,"_33":68},"Обновляйте, создавайте, удаляйте контент, модели контента и активы в вашем Contentful Space","содержательный-mcp","# Контентный MCP-сервер\n\n[![значок кузнеца](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nРеализация сервера MCP, которая интегрируется с API управления контентом Contentful, предоставляя комплексные возможности управления контентом.\n\n* Обратите внимание \\*; если вас не интересует код, а вы просто хотите использовать этот MCP в Claude Desktop (или любом другом инструменте, который может использовать серверы MCP), вам не нужно клонировать этот репозиторий, вы можете просто настроить его в Claude Desktop, инструкции по его установке см. в разделе «Использование с Claude Desktop».\n\n## Функции\n\n* **Управление контентом** : полный цикл операций CRUD для записей и активов\n* **Управление пространством** : создание, обновление и управление пространствами и средами.\n* **Типы контента** : управление определениями типов контента\n* **Локализация** : Поддержка нескольких локалей\n* **Публикация** : управление процессом публикации контента\n* **Массовые операции** : выполнение массовой публикации, отмены публикации и проверки нескольких записей и активов.\n* **Умная пагинация** : операции со списками возвращают максимум 3 элемента на запрос, чтобы предотвратить переполнение контекстного окна, со встроенной поддержкой пагинации.\n\n## Пагинация\n\nЧтобы предотвратить переполнение контекстного окна в LLM, операции со списками (например, search\\_entries и list\\_assets) ограничены 3 элементами на запрос. Каждый ответ включает:\n\n* Общее количество доступных предметов\n* Текущая страница элементов (макс. 3)\n* Количество оставшихся предметов\n* Пропустить значение для следующей страницы\n* Сообщение, побуждающее LLM предложить извлечь больше элементов\n\nЭта система пагинации позволяет LLM эффективно обрабатывать большие наборы данных, сохраняя при этом ограничения контекстного окна.\n\n## Массовые операции\n\nФункция массовых операций обеспечивает эффективное управление несколькими элементами контента одновременно:\n\n* **Асинхронная обработка** : операции выполняются асинхронно и предоставляют обновления статуса.\n* **Эффективное управление контентом** : обработка нескольких записей или активов за один вызов API\n* **Отслеживание статуса** : отслеживайте прогресс с помощью счетчиков успешных и неудачных операций.\n* **Оптимизация ресурсов** : сокращение числа вызовов API и повышение производительности пакетных операций.\n\nЭти инструменты для массовых операций идеально подходят для миграции контента, массовых обновлений или пакетных публикаций.\n\n## Инструменты\n\n### Управление входом\n\n* **search\\_entries** : Поиск записей с использованием параметров запроса\n* **create\\_entry** : Создать новые записи\n* **get\\_entry** : Извлечь существующие записи\n* **update\\_entry** : Обновить поля ввода\n* **delete\\_entry** : Удалить записи\n* **publish\\_entry** : Публикация записей\n* **unpublish\\_entry** : Отменить публикацию записей\n\n### Массовые операции\n\n* **bulk\\_publish** : Публикация нескольких записей и активов за одну операцию. Принимает массив сущностей (записей и активов) и обрабатывает их публикацию как пакет.\n* **bulk\\_unpublish** : Отменить публикацию нескольких записей и активов за одну операцию. Аналогично bulk\\_publish, но удаляет контент из API доставки.\n* **bulk\\_validate** : Проверка нескольких записей на предмет согласованности содержимого, ссылок и обязательных полей. Возвращает результаты проверки без изменения содержимого.\n\n### Управление активами\n\n* **list\\_assets** : Список активов с разбивкой на страницы (3 элемента на странице)\n* **upload\\_asset** : Загрузить новые активы с метаданными\n* **get\\_asset** : Получить сведения и информацию об активах\n* **update\\_asset** : Обновление метаданных и файлов активов\n* **delete\\_asset** : Удалить активы из пространства\n* **publish\\_asset** : публикация ресурсов в API доставки\n* **unpublish\\_asset** : Отменить публикацию ресурсов из API доставки\n\n### Управление пространством и окружающей средой\n\n* **list\\_spaces** : Список доступных пространств\n* **get\\_space** : Получить сведения о пространстве\n* **list\\_environments** : Список сред в пространстве\n* **create\\_environment** : Создать новую среду\n* **delete\\_environment** : Удалить среду\n\n### Управление типом контента\n\n* **list\\_content\\_types** : Список доступных типов контента\n* **get\\_content\\_type** : Получить сведения о типе контента\n* **create\\_content\\_type** : Создать новый тип контента\n* **update\\_content\\_type** : Обновить тип контента\n* **delete\\_content\\_type** : Уд��лить тип контента\n* **publish\\_content\\_type** : Опубликовать тип контента\n\n## Инструменты разработки\n\n### Инспектор МКП\n\nПроект включает в себя инструмент MCP Inspector, который помогает в разработке и отладке:\n\n* **Режим проверки** : запустите `npm run inspect` , чтобы запустить инспектор. Вы можете открыть инспектор, перейдя по адресу [http://localhost:5173.](http://localhost:5173)\n* **Режим наблюдения** : используйте `npm run inspect:watch` для автоматического перезапуска инспектора при изменении файлов.\n* **Визуальный интерфейс** : инспектор предоставляет веб-интерфейс для тестирования и отладки инструментов MCP.\n* **Тестирование в реальном времени** : попробуйте инструменты и сразу же увидите результаты.\n* **Тестирование массовых операций** : тестирование и мониторинг массовых операций с визуальной обратной связью о ходе выполнения и результатах.\n\nПроект также содержит команду `npm run dev` , которая перестраивает и перезагружает сервер MCP при каждом изменении.\n\n## Конфигурация\n\n### Предпосылки\n\n1. Создайте учетную запись Contentful на [Contentful](https://www.contentful.com/)\n2. Создайте токен API управления контентом из настроек вашего аккаунта.\n\n### Переменные среды\n\nЭти переменные также могут быть заданы как аргументы.\n\n* `CONTENTFUL_HOST` / `--host` : Конечная точка API управления контентом (по умолчанию )\n* `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token` : Ваш токен API управления контентом\n* `ENABLE_HTTP_SERVER` / `--http` : Установите значение «true», чтобы включить режим HTTP/SSE\n* `HTTP_PORT` / `--port` : Порт для HTTP-сервера (по умолчанию: 3000)\n* `HTTP_HOST` / `--http-host` : Хост для HTTP-сервера (по умолчанию: localhost)\n\n### Исследование космоса и окружающей среды\n\nВы можете ограничить spaceId и EnvironmentId, чтобы гарантировать, что LLM будет выполнять операции только с определенными идентификаторами пространства/среды. Это в основном необходимо для поддержки агентов, которые должны работать в определенных пространствах. Если заданы как `SPACE_ID` , так и `ENVIRONMENT_ID` env-vars, инструменты не будут сообщать о необходимости этих значений, а обработчики будут использовать переменные среды для выполнения операций CMA. Вы также потеряете доступ к инструментам в обработчике пространства, поскольку эти инструменты находятся в разных пространствах. Вы также можете добавить `SPACE_ID` и `ENVIRONMENT_ID` , используя аргументы `--space-id` и `--environment-id`\n\n#### Использование идентификатора приложения\n\nВместо предоставления токена управления вы также можете использовать [App Identity](https://www.contentful.com/developers/docs/extensibility/app-framework/app-identity/) для обработки аутентификации. Вам придется настроить и установить Contentful App и задать следующие параметры при вызове MCP-сервера:\n\n* `--app-id` = идентификатор приложения, предоставляющего Apptoken\n* `--private-key` = закрытый ключ, созданный вами в пользовательском интерфейсе вашего приложения, привязанный к `app_id`\n* `--space-id` = spaceId, в котором установлено приложение\n* `--environment-id` = environmentId (внутри пространства), в котором установлено приложение.\n\nС этими значениями сервер MCP запросит временный AppToken для выполнения операции с контентом в определенном пространстве/идентификаторе среды. Это особенно полезно при использовании этого сервера MCP в бэкэнд-системах, которые действуют как MCP-клиент (например, чат-агенты)\n\n### Использование с Claude Desktop\n\nВам не нужно клонировать этот репозиторий, чтобы использовать этот MCP, вы можете просто добавить его в свой `claude_desktop_config.json` :\n\nДобавьте или отредактируйте `~/Library/Application Support/Claude/claude_desktop_config.json` и добавьте следующие строки:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@ivotoby/contentful-management-mcp-server\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nЕсли ваш MCPClient не поддерживает настройку переменных среды, вы также можете установить токен управления, используя следующий аргумент:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### Установка через Smithery\n\nЧтобы автоматически установить Contentful Management Server для Claude Desktop через [Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server) :\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### Разработка и использование Claude Desktop\n\nЕсли вы хотите внести свой вклад и проверить, что Клод сделает с вашим вкладом;\n\n* запустите `npm run dev` , это запустит наблюдателя, который перестраивает сервер MCP при каждом изменении\n* обновите `claude_desktop_config.json` , чтобы он напрямую ссылался на проект, т. е.:\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nЭто позволит вам протестировать любые изменения на сервере MCP напрямую с помощью Claude. Однако если вы добавите новые инструменты/ресурсы, вам потребуется перезапустить Claude Desktop.\n\n## Виды транспорта\n\nСервер MCP поддерживает два режима транспортировки:\n\n### stdio транспорт\n\nРежим транспорта по умолчанию использует стандартные потоки ввода/вывода для связи. Это идеально подходит для интеграции с клиентами MCP, поддерживающими транспорт stdio, такими как Claude Desktop.\n\nЧтобы использовать режим stdio, просто запустите сервер без флага `--http` :\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### Потоковый HTTP-транспорт\n\nСервер также поддерживает транспорт StreamableHTTP, как определено в протоколе MCP. Этот режим полезен для веб-интеграций или при запуске сервера как автономной службы.\n\nЧтобы использовать режим StreamableHTTP, запустите с флагом `--http` :\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### Подробности о потоковом HTTP\n\n* Использует официальный транспорт MCP StreamableHTTP\n* Поддерживает стандартные операции протокола MCP\n* Включает управление сеансами для поддержания состояния\n* Правильно обрабатывает шаблоны инициализации/уведомления\n* Совместимость со стандартными клиентами MCP\n* Заменяет устаревший транспорт SSE на современный подход.\n\nРеализация соответствует стандартной спецификации протокола MCP, позволяя любому клиенту MCP подключаться к серверу без специальной обработки.\n\n## Обработка ошибок\n\nСервер реализует комплексную обработку ошибок для:\n\n* Ошибки аутентификации\n* Ограничение скорости\n* Недействительные запросы\n* Проблемы с сетью\n* Ошибки, специфичные для API\n\n[![Значок оценки безопасности MseeP.ai](https://mseep.net/pr/ivo-toby-contentful-mcp-badge.png)](https://mseep.ai/app/ivo-toby-contentful-mcp)\n\n## Лицензия\n\nЛицензия Массачусетского технологического института\n\n## Мелкий шрифт\n\nЭтот MCP Server позволяет Claude (или другим агентам, которые могут потреблять ресурсы MCP) обновлять, удалять контент, пространства и модели контента. Поэтому будьте уверены, что вы позволяете Claude делать с вашими Contentful пространствами!\n\nЭтот MCP-сервер официально не поддерживается Contentful (пока)","Russian","ru-RU",{"_27":72,"_31":75,"_36":76},{"_29":73,"_31":32,"_33":74},"更新、创建、删除 Contentful Space 中的内容、内容模型和资产","# 内容丰富的 MCP 服务器\n\n[![铁匠徽章](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nMCP 服务器实现与 Contentful 的内容管理 API 集成，提供全面的内容管理功能。\n\n* 请注意\\*；如果您对代码不感兴趣，只想在 Claude Desktop（或任何其他能够使用 MCP 服务器的工具）中使用此 MCP，则您不必克隆此 repo，您只需在 Claude Desktop 中进行设置即可，请参阅“与 Claude Desktop 一起使用”部分以获取有关如何安装它的说明。\n\n## 特征\n\n* **内容管理**：对条目和资产进行完整的 CRUD 操作\n* **空间管理**：创建、更新和管理空间和环境\n* **内容类型**：管理内容类型定义\n* **本地化**：支持多种语言环境\n* **发布**：控制内容发布工作流程\n* **批量操作**：对多个条目和资产执行批量发布、取消发布和验证\n* **智能分页**：列表操作每个请求最多返回 3 个项目，以防止上下文窗口溢出，并具有内置分页支持\n\n## 分页\n\n为防止 LLM 中的上下文窗口溢出，列表操作（例如 search\\_entries 和 list\\_assets）每个请求限制为 3 个项目。每个响应包含：\n\n* 可用商品总数\n* 当前页面项目（最多 3 个）\n* 剩余商品数量\n* 下一页的跳过值\n* 提示 LLM 提供检索更多项目的消息\n\n该分页系统允许 LLM 有效地处理大型数据集，同时保持上下文窗口限制。\n\n## 批量操作\n\n批量操作功能可同时高效管理多个内容项：\n\n* **异步处理**：操作异步运行并提供状态更新\n* **高效的内容管理**：通过一次 API 调用处理多个条目或资产\n* **状态跟踪**：通过成功和失败计数监控进度\n* **资源优化**：减少 API 调用并提高批量操作的性能\n\n这些批量操作工具非常适合内容迁移、大规模更新或批量发布工作流程。\n\n## 工具\n\n### 入境管理\n\n* **search\\_entries** ：使用查询参数搜索条目\n* **create\\_entry** ：创建新条目\n* **get\\_entry** ：检索现有条目\n* **update\\_entry** ：更新输入字段\n* **delete\\_entry** ：删除条目\n* **publish\\_entry** ：发布条目\n* **unpublish\\_entry** ：取消发布条目\n\n### 批量操作\n\n* **bulk\\_publish** ：一次性发布多个条目和资产。接受一个实体数组（条目和资产），并批量处理它们的发布。\n* **bulk\\_unpublish** ：一次性取消发布多个条目和资产。与 bulk\\_publish 类似，但��从分发 API 中移除内容。\n* **bulk\\_validate** ：验证多个条目的内容一致性、引用和必填字段。返回验证结果，但不修改内容。\n\n### 资产管理\n\n* **list\\_assets** ：分页列出资产（每页 3 项）\n* **upload\\_asset** ：上传带有元数据的新资产\n* **get\\_asset** ：检索资产详细信息和信息\n* **update\\_asset** ：更新资产元数据和文件\n* **delete\\_asset** ：从空间中删除资产\n* **publish\\_asset** ：将资产发布到交付 API\n* **unpublish\\_asset** ：从交付 API 取消发布资产\n\n### 空间与环境管理\n\n* **list\\_spaces** ：列出可用空间\n* **get\\_space** ：获取空间详细信息\n* **list\\_environments** ：列出空间中的环境\n* **create\\_environment** ：创建新环境\n* **delete\\_environment** ：删除环境\n\n### 内容类型管理\n\n* **list\\_content\\_types** ：列出可用的内容类型\n* **get\\_content\\_type** ：获取内容类型详细信息\n* **create\\_content\\_type** ：创建新的内容类型\n* **update\\_content\\_type** ：更新内容类型\n* **delete\\_content\\_type** ：删除内容类型\n* **publish\\_content\\_type** ：发布内容类型\n\n## 开发工具\n\n### MCP 检查器\n\n该项目包括一个有助于开发和调试的 MCP Inspector 工具：\n\n* **检查模式**：运行`npm run inspect`启动检查器，您可以通过打开检查器\n* **监视模式**：使用`npm run inspect:watch`在文件更改时自动重启检查器\n* **可视化界面**：检查器提供了一个 Web 界面来测试和调试 MCP 工具\n* **实时测试**：试用工具并立即查看其响应\n* **批量操作测试**：通过进度和结果的视觉反馈来测试和监控批量操作\n\n该项目还包含一个`npm run dev`命令，该命令会在每次更改时重建并重新加载 MCP 服务器。\n\n## 配置\n\n### 先决条件\n\n1. 在[Contentful](https://www.contentful.com/)上创建 Contentful 帐户\n2. 从您的帐户设置生成内容管理 API 令牌\n\n### 环境变量\n\n这些变量也可以设置为参数\n\n* `CONTENTFUL_HOST` / `--host` ：Contentful 管理 API 端点（默认为）\n* `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token` ：您的内容管理 API 令牌\n* `ENABLE_HTTP_SERVER` / `--http` ：设置为“true”以启用 HTTP/SSE 模式\n* `HTTP_PORT` / `--port` ：HTTP 服务器的端口（默认值：3000）\n* `HTTP_HOST` / `--http-host` ：HTTP 服务器的主机（默认值：localhost）\n\n### 空间和环境范围\n\n您可以设置 spaceId 和 EnvironmentId 的范围，以确保 LLM 仅对定义的空间/环境 ID 执行操作。这主要是为了支持在特定空间内运行的代理。如果同时设置了`SPACE_ID`和`ENVIRONMENT_ID`环境变量，工具将不会报告需要这些值，处理程序将使用环境变量执行 CMA 操作。由于这些工具跨空间，您还将失去对空间处理程序中工具的访问权限。您还可以使用参数`--space-id`和`--environment-id`添加`SPACE_ID`和`ENVIRONMENT_ID` 。\n\n#### 使用 App Identity\n\n除了提供管理令牌之外，您还可以利用[App Identity](https://www.contentful.com/developers/docs/extensibility/app-framework/app-identity/)来处理身份验证。您需要设置并安装一个 Contentful App，并在调用 MCP 服务器时设置以下参数：\n\n* `--app-id` = 提供 Apptoken 的应用程序 ID\n* `--private-key` = 您在应用程序用户界面中创建的私钥，与`app_id`绑定\n* `--space-id` = 安装应用程序的spaceId\n* `--environment-id` = 安装应用程序的环境 ID（空间内）。\n\n使用这些值，MCP 服务器将请求一个临时的 AppToken，以便在定义的空间/环境 ID 中执行内容操作。当在充当 MCP 客户端（例如聊天代理）的后端系统中使用此 MCP 服务器时，此功能尤其有用。\n\n### 与 Claude Desktop 一起使用\n\n您不需要克隆此 repo 来使用此 MCP，您只需将其添加到您的`claude_desktop_config.json`即可：\n\n添加或编辑`~/Library/Application Support/Claude/claude_desktop_config.json`并添加以下行：\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@ivotoby/contentful-management-mcp-server\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n如果您的 MCPClient 不支持设置环境变量，您也可以使用如下参数设置管理令牌：\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### 通过 Smithery 安装\n\n要通过[Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)自动为 Claude Desktop 安装 Contentful 管理服务器：\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### 开发并使用Claude桌面\n\n如果您想贡献并测试 Claude 如何处理您的贡献；\n\n* 运行`npm run dev` ，这将启动观察程序，在每次更改时重建 MCP 服务器\n* 更新`claude_desktop_config.json`以直接引用项目，即；\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\n这将允许您直接使用 Claude 测试 MCP 服务器中的任何修改；但是，如果您添加新的工具/资源，则需要重新启动 Claude Desktop\n\n## 交通方式\n\nMCP 服务器支持两种传输模式：\n\n### stdio 传输\n\n默认传输模式使用标准输入/输出流进行通信。这非常适合与支持标准输入/输出传输的 MCP 客户端（例如 Claude Desktop）集成。\n\n要使用 stdio 模式，只需运行不带`--http`标志的服务器：\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### 可流式传输的HTTP传输\n\n该服务器还支持 MCP 协议中定义的 StreamableHTTP 传输。此模式对于基于 Web 的集成或将服务器作为独立服务运行时非常有用。\n\n要使用 StreamableHTTP 模式，请使用`--http`标志运行：\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### StreamableHTTP 详细信息\n\n* 使用官方 MCP StreamableHTTP 传输\n* 支持标准MCP协议操作\n* 包括用于维护状态的会话管理\n* 正确处理初始化/通知模式\n* 与标准 MCP 客户端兼容\n* 用现代方法取代已弃用的 SSE 传输\n\n该实现遵循标准 MCP 协议规范，允许任何 MCP 客户端无需特殊处理即可连接到服务器。\n\n## 错误处理\n\n服务器实现了全面的错误处理：\n\n* 身份验证失败\n* 速率限制\n* 无效请求\n* 网络问题\n* API 特定错误\n\n[![MseeP.ai 安全评估徽章](https://mseep.net/pr/ivo-toby-contentful-mcp-badge.png)](https://mseep.ai/app/ivo-toby-contentful-mcp)\n\n## 执照\n\nMIT 许可证\n\n## 细则\n\n此 MCP 服务器允许 Claude（或其他可以使用 MCP 资源的代理）更新、删除内容、空间和内容模型。因此，请务必确认您允许 Claude 对您的 Contentful 空间执行的操作！\n\n此 MCP 服务器尚未获得 Contentful 官方支持（目前）","Chinese","zh-CN","githubUser","locale",{"_80":81,"_13":82,"_93":40,"_94":40,"_16":95,"_96":97,"_31":32,"_109":110,"_117":-5,"_118":-5,"_119":120,"_187":188,"_193":-5,"_104":32,"_194":170,"_107":195,"_196":197},"addedAt","2024-12-17T15:40:03.911627Z",[83,84,85,86,87,88,89,90,91,92],"category:content-management-systems","category:developer-tools","category:app-automation","environment:network","hosting:remote-capable","language:typescript","security_grade:a","quality_grade:a","license_grade:a","author:claimed","descriptionMarkdown","descriptionPlainText",337,"integrations",[98],{"_99":100,"_29":106,"_107":108},"brand",{"_101":102,"_31":103,"_104":105},"logoSvgPath","M21.875 16.361c-.043-.048-1.067-1.18-2.365-1.19-.68 0-1.288.283-1.815.858-.773.842-2.35 1.85-4.25 1.921-1.598.059-3.085-.548-4.423-1.805-1.644-1.544-2.155-4.016-1.302-6.297.834-2.23 2.752-3.616 5.131-3.707l.044-.004c.024-.003 2.302-.258 4.325 1.548.17.185 1.154 1.197 2.475 1.228.823.018 1.586-.336 2.27-1.055.602-.632.87-1.342.797-2.112-.154-1.61-1.806-2.876-2.03-3.04-.212-.184-1.878-1.578-4.476-2.294-2.52-.695-6.42-.853-10.685 2.349a7.31 7.31 0 0 0-.557.49c-.28.208-.523.462-.716.753a12.469 12.469 0 0 0-3.064 8.677c.207 6.283 5.265 9.293 5.646 9.51.262.17 2.906 1.81 6.495 1.809 2.106 0 4.538-.565 7.005-2.322.248-.138 1.714-1.012 2.103-2.52.23-.894.042-1.815-.562-2.737l-.046-.06zm-16.932 1.97c0-1.09.887-1.977 1.977-1.977s1.977.886 1.977 1.977c0 1.09-.887 1.977-1.977 1.977s-1.977-.887-1.977-1.977zm.139-13.657c.236-.275.451-.498.628-.67a1.965 1.965 0 0 1 1.088-.329c1.09 0 1.977.887 1.977 1.977S7.888 7.63 6.798 7.63s-1.977-.887-1.977-1.977c0-.356.096-.69.261-.978zM13.249.999c3.954 0 6.657 2.336 6.826 2.486l.043.034c.42.3 1.532 1.301 1.63 2.324.044.469-.126.898-.52 1.313-.477.5-.983.752-1.504.738-.964-.019-1.743-.887-1.76-.905l-.042-.044c-2.292-2.063-4.83-1.855-5.13-1.822a6.82 6.82 0 0 0-3.012.818 3 3 0 0 0-2.34-3.214C9.543 1.45 11.516.999 13.248.999zM3.884 6.34a3 3 0 0 0 2.914 2.31c.122 0 .24-.01.358-.024a7.336 7.336 0 0 0-.39.866c-.75 2.003-.59 4.14.359 5.854-.068-.005-.136-.01-.205-.01a2.999 2.999 0 0 0-2.967 2.6 10.075 10.075 0 0 1-1.7-5.288 11.43 11.43 0 0 1 1.63-6.309zM21.497 18.9c-.3 1.174-1.615 1.89-1.627 1.896l-.058.036c-6.287 4.499-12.137.667-12.382.502l-.036-.022a2.848 2.848 0 0 1-.034-.02 2.998 2.998 0 0 0 2.543-3.228c1.124.64 2.336.951 3.58.906 2.214-.083 4.057-1.264 4.962-2.25.327-.356.67-.53 1.048-.53h.005c.762.004 1.46.688 1.593.826.421.658.558 1.291.406 1.884z","Contentful","slug","contentful","Integrates with Contentful's Content Management API, providing comprehensive content management capabilities including entry and asset management, space management, content type management, localization support, and publishing workflow control.","uid","wtkb9xsj6w","namespace",{"_111":112,"_104":116},"owner",{"_113":114},"githubAccount",{"_115":116},"login","ivo-toby","readmeMarkdown","redditPostExternalId","repository",{"_121":122,"_151":152,"_156":157,"_176":-5,"_177":178,"_179":180,"_184":185},"argumentsJsonSchema",{"_123":124,"_135":136,"_139":150},"oneOf",[125,129],{"_126":127},"required",[128],"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN",{"_126":130},[131,132,133,134],"APP_ID","PRIVATE_KEY","SPACE_ID","ENVIRONMENT_ID","properties",{"_133":137,"_134":141,"_143":144,"_128":148},{"_29":138,"_139":140},"Optional space ID to scope operations to a specific space","type","string",{"_29":142,"_139":140},"Optional environment ID to scope operations to a specific environment","CONTENTFUL_HOST",{"_145":146,"_29":147,"_139":140},"default","https://api.contentful.com","Contentful Management API Endpoint",{"_29":149,"_139":140},"Your Content Management API token","object","githubProject",{"_33":153,"_154":155}," $\"Contentful$ \n\n# Contentful MCP Server\n\n## Notice\n\nThis is a community driven server! Contentful has released an official server which you can find [here](https://github.com/contentful/contentful-mcp-server)\n\n[![smithery badge](https://smithery.ai/badge/@ivotoby/contentful-management-mcp-server)](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server)\n\nAn MCP server implementation that integrates with Contentful's Content Management API, providing comprehensive content management capabilities.\n\n- Please note \\*; if you are not interested in the code, and just want to use this MCP in\n Claude Desktop (or any other tool that is able to use MCP servers) you don't have to\n clone this repo, you can just set it up in Claude desktop, refer to the section\n \"Usage with Claude Desktop\" for instructions on how to install it.\n\n $\"contentful-mcp$ \n\n## Features\n\n- **Content Management**: Full CRUD operations for entries and assets\n- **Comment Management**: Create, retrieve, and manage comments on entries with support for both plain-text and rich-text formats, including threaded conversations\n- **Space Management**: Create, update, and manage spaces and environments\n- **Content Types**: Manage content type definitions\n- **Localization**: Support for multiple locales\n- **Publishing**: Control content publishing workflow\n- **Bulk Operations**: Execute bulk publishing, unpublishing, and validation across multiple entries and assets\n- **Smart Pagination**: List operations return maximum 3 items per request to prevent context window overflow, with built-in pagination support\n\n## Pagination\n\nTo prevent context window overflow in LLMs, list operations (like search_entries and list_assets) are limited to 3 items per request. Each response includes:\n\n- Total number of available items\n- Current page of items (max 3)\n- Number of remaining items\n- Skip value for the next page\n- Message prompting the LLM to offer retrieving more items\n\nThis pagination system allows the LLM to efficiently handle large datasets while maintaining context window limits.\n\n## Bulk Operations\n\nThe bulk operations feature provides efficient management of multiple content items simultaneously:\n\n- **Asynchronous Processing**: Operations run asynchronously and provide status updates\n- **Efficient Content Management**: Process multiple entries or assets in a single API call\n- **Status Tracking**: Monitor progress with success and failure counts\n- **Resource Optimization**: Reduce API calls and improve performance for batch operations\n\nThese bulk operation tools are ideal for content migrations, mass updates, or batch publishing workflows.\n\n## Tools\n\n### Entry Management\n\n- **search_entries**: Search for entries using query parameters\n- **create_entry**: Create new entries\n- **get_entry**: Retrieve existing entries\n- **update_entry**: Update entry fields\n- **delete_entry**: Remove entries\n- **publish_entry**: Publish entries\n- **unpublish_entry**: Unpublish entries\n\n### Comment Management\n\n- **get_comments**: Retrieve comments for an entry with filtering by status (active, resolved, all)\n- **create_comment**: Create new comments on entries with support for both plain-text and rich-text formats. Supports threaded conversations by providing a parent comment ID to reply to existing comments\n- **get_single_comment**: Retrieve a specific comment by its ID for an entry\n- **delete_comment**: Delete a specific comment from an entry\n- **update_comment**: Update existing comments with new body content or status changes\n\n#### Threaded Comments\n\nComments support threading functionality to enable structured conversations and work around the 512-character limit:\n\n- **Reply to Comments**: Use the `parent` parameter in `create_comment` to reply to an existing comment\n- **Threaded Conversations**: Build conversation trees by replying to specific comments\n- **Extended Discussions**: Work around the 512-character limit by creating threaded replies to continue longer messages\n- **Conversation Context**: Maintain context in discussions by organizing related comments in threads\n\nExample usage:\n\n1. Create a main comment: `create_comment` with `entryId`, `body`, and `status`\n2. Reply to that comment: `create_comment` with `entryId`, `body`, `status`, and `parent` (the ID of the comment you're replying to)\n3. Continue the thread: Reply to any comment in the thread by using its ID as the `parent`\n\n### Bulk Operations\n\n- **bulk_publish**: Publish multiple entries and assets in a single operation. Accepts an array of entities (entries and assets) and processes their publication as a batch.\n- **bulk_unpublish**: Unpublish multiple entries and assets in a single operation. Similar to bulk_publish but removes content from the delivery API.\n- **bulk_validate**: Validate multiple entries for content consistency, references, and required fields. Returns validation results without modifying content.\n\n### Asset Management\n\n- **list_assets**: List assets with pagination (3 items per page)\n- **upload_asset**: Upload new assets with metadata\n- **get_asset**: Retrieve asset details and information\n- **update_asset**: Update asset metadata and files\n- **delete_asset**: Remove assets from space\n- **publish_asset**: Publish assets to delivery API\n- **unpublish_asset**: Unpublish assets from delivery API\n\n### Space & Environment Management\n\n- **list_spaces**: List available spaces\n- **get_space**: Get space details\n- **list_environments**: List environments in a space\n- **create_environment**: Create new environment\n- **delete_environment**: Remove environment\n\n### Content Type Management\n\n- **list_content_types**: List available content types\n- **get_content_type**: Get content type details\n- **create_content_type**: Create new content type\n- **update_content_type**: Update content type\n- **delete_content_type**: Remove content type\n- **publish_content_type**: Publish a content type\n\n## Development Tools\n\n### MCP Inspector\n\nThe project includes an MCP Inspector tool that helps with development and debugging:\n\n- **Inspect Mode**: Run `npm run inspect` to start the inspector, you can open the inspector by going to http://localhost:5173\n- **Watch Mode**: Use `npm run inspect:watch` to automatically restart the inspector when files change\n- **Visual Interface**: The inspector provides a web interface to test and debug MCP tools\n- **Real-time Testing**: Try out tools and see their responses immediately\n- **Bulk Operations Testing**: Test and monitor bulk operations with visual feedback on progress and results\n\nThe project also contains a `npm run dev` command which rebuilds and reloads the MCP server on every change.\n\n## Configuration\n\n### Prerequisites\n\n1. Create a Contentful account at [Contentful](https://www.contentful.com/)\n2. Generate a Content Management API token from your account settings\n\n### Environment Variables\n\nThese variables can also be set as arguments\n\n- `CONTENTFUL_HOST` / `--host`: Contentful Management API Endpoint (defaults to https://api.contentful.com)\n- `CONTENTFUL_MANAGEMENT_ACCESS_TOKEN` / `--management-token`: Your Content Management API token\n- `ENABLE_HTTP_SERVER` / `--http`: Set to \"true\" to enable HTTP/SSE mode\n- `HTTP_PORT` / `--port`: Port for HTTP server (default: 3000)\n- `HTTP_HOST` / `--http-host`: Host for HTTP server (default: localhost)\n\n### Space and Environment Scoping\n\nYou can scope the spaceId and EnvironmentId to ensure the LLM will only do operations on the defined space/env ID's.\nThis is mainly to support agents that are to operate within specific spaces. If both `SPACE_ID` and `ENVIRONMENT_ID` env-vars are set\nthe tools will not report needing these values and the handlers will use the environment vars to do CMA operations.\nYou will also loose access to the tools in the space-handler, since these tools are across spaces.\nYou can also add the `SPACE_ID` and `ENVIRONMENT_ID` by using arguments `--space-id` and `--environment-id`\n\n#### Using App Identity\n\nInstead of providing a Management token you can also leverage [App Identity](https://www.contentful.com/developers/docs/extensibility/app-framework/app-identity/)\nfor handling authentication. You would have to setup and install a Contentful App and set the following parameters when calling the MCP-server:\n\n- `--app-id` = the app Id which is providing the Apptoken\n- `--private-key` = the private key you created in the user-interface with your app, tied to `app_id`\n- `--space-id` = the spaceId in which the app is installed\n- `--environment-id` = the environmentId (within the space) in which the app is installed.\n\nWith these values the MCP server will request a temporary AppToken to do content operation in the defined space/environment-id. This especially useful when using this MCP server in backend systems that act as MCP-client (like chat-agents)\n\n### Usage with Claude Desktop\n\nYou do not need to clone this repo to use this MCP, you can simply add it to\nyour `claude_desktop_config.json`:\n\nAdd or edit `~/Library/Application Support/Claude/claude_desktop_config.json`\nand add the following lines:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@ivotoby/contentful-management-mcp-server\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nIf your MCPClient does not support setting environment variables you can also set the management token using an argument like this:\n\n```json\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@ivotoby/contentful-management-mcp-server\",\n \"--management-token\",\n \"\",\n \"--host\",\n \"http://api.contentful.com\"\n ]\n }\n }\n}\n```\n\n### Installing via Smithery\n\nTo install Contentful Management Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ivotoby/contentful-management-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claude\n```\n\n### Developing and using Claude desktop\n\nIf you want to contribute and test what Claude does with your contributions;\n\n- run `npm run dev`, this will start the watcher that rebuilds the MCP server on every change\n- update `claude_desktop_config.json` to reference the project directly, ie;\n\n```\n{\n \"mcpServers\": {\n \"contentful\": {\n \"command\": \"node\",\n \"args\": [\"/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js\"],\n \"env\": {\n \"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN\": \"\"\n }\n }\n }\n}\n```\n\nThis will allow you to test any modification in the MCP server with Claude directly, however; if you add new tools/resources you will need to restart Claude Desktop\n\n## Transport Modes\n\nThe MCP server supports two transport modes:\n\n### stdio Transport\n\nThe default transport mode uses standard input/output streams for communication. This is ideal for integration with MCP clients that support stdio transport, like Claude Desktop.\n\nTo use stdio mode, simply run the server without the `--http` flag:\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN\n```\n\n### StreamableHTTP Transport\n\nThe server also supports the StreamableHTTP transport as defined in the MCP protocol. This mode is useful for web-based integrations or when running the server as a standalone service.\n\nTo use StreamableHTTP mode, run with the `--http` flag:\n\n```bash\nnpx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000\n# or alternatively\nnpx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000\n```\n\n#### StreamableHTTP Details\n\n- Uses the official MCP StreamableHTTP transport\n- Supports standard MCP protocol operations\n- Includes session management for maintaining state\n- Properly handles initialize/notify patterns\n- Compatible with standard MCP clients\n- Replaces the deprecated SSE transport with the modern approach\n\nThe implementation follows the standard MCP protocol specification, allowing any MCP client to connect to the server without special handling.\n\n## Error Handling\n\nThe server implements comprehensive error handling for:\n\n- Authentication failures\n- Rate limiting\n- Invalid requests\n- Network issues\n- API-specific errors\n\n[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/146d4235-bdb1-492e-b594-82fd27b77388)\n\n## License\n\nMIT License\n\n## Fine print\n\nThis MCP Server enables Claude (or other agents that can consume MCP resources) to update, delete content, spaces and content-models. So be sure what you allow Claude to do with your Contentful spaces!\n\nThis MCP-server is not officially supported by Contentful (yet)\n","url","https://github.com/ivo-toby/contentful-mcp","githubRepository",{"_158":159,"_160":161,"_162":163,"_16":164,"_165":166,"_31":32,"_111":167,"_169":170,"_171":172,"_174":175},"defaultBranch","main","fullName","ivo-toby/contentful-mcp","githubTreeId",1408438,162,"language","TypeScript",{"_115":116,"_107":168},"1yzw8nfjoa","recentStargazers",0,"spdxLicense",{"_31":173},"MIT License","stargazers",61,"glamaJson","inspectable",true,"npmPackage",{"_31":181,"_182":183},"@ivotoby/contentful-management-mcp-server","weeklyDownloads",76,"supportedPlatforms",[186],"MACOS","scores",{"_189":190,"_191":190,"_192":190},"license",100,"quality","security","simpleIcon","toolCount","l2fxeaot4p","updatedAt","2025-10-04T08:45:27.226735Z","meta",[200,203,205,212,215,217,220,223,226,229,232,234,237,240,242,244,246,248,250],{"_201":202},"title","contentful-mcp | Glama",{"_204":40,"_31":29},"content",{"_206":207,"_208":209,"_210":211},"href","https://glama.ai/mcp/servers/@ivo-toby/contentful-mcp","rel","canonical","tagName","link",{"_204":32,"_213":214},"property","og:title",{"_204":40,"_213":216},"og:description",{"_204":218,"_213":219},"https://glama.ai/logo.png","og:logo",{"_204":221,"_213":222},"https://glama.ai/mcp/servers/@ivo-toby/contentful-mcp/og-image","og:image",{"_204":224,"_213":225},"630","og:image:height",{"_204":227,"_213":228},"1200","og:image:width",{"_204":230,"_213":231},"website","og:type",{"_204":207,"_213":233},"og:url",{"_204":235,"_213":236},"Glama – MCP Hosting Platform","og:site_name",{"_204":238,"_31":239},"summary_large_image","twitter:card",{"_204":235,"_31":241},"twitter:title",{"_204":40,"_31":243},"twitter:description",{"_204":221,"_31":245},"twitter:image",{"_204":224,"_31":247},"twitter:image:height",{"_204":227,"_31":249},"twitter:image:width",{"_251":252},"script:ld+json",{"_253":254,"_255":256},"@context","http://schema.org","@graph",[257],{"_253":258,"_259":260,"_261":262},"https://schema.org","@type","BreadcrumbList","itemListElement",[263,270,274,278],{"_259":264,"_265":266,"_31":267,"_268":269},"ListItem","item","/","Glama","position",1,{"_259":264,"_265":271,"_31":272,"_268":273},"/mcp","MCP",2,{"_259":264,"_265":275,"_31":276,"_268":277},"/mcp/servers","Servers",3,{"_259":264,"_265":279,"_31":32,"_268":280},"/mcp/servers/@ivo-toby/contentful-mcp",4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_285":286,"_27":292,"_319":320,"_198":331,"_329":355,"_356":357},"blob",{"_204":287,"_288":289,"_290":291},"@contentful:registry=https://registry.npmjs.org\n","fileName",".npmrc","size",48,{"_80":81,"_13":293,"_93":40,"_94":40,"_16":95,"_96":294,"_31":32,"_109":297,"_117":-5,"_118":-5,"_119":300,"_187":318,"_193":-5,"_104":32,"_194":170,"_107":195,"_196":197},[83,84,85,86,87,88,89,90,91,92],[295],{"_99":296,"_29":106,"_107":108},{"_101":102,"_31":103,"_104":105},{"_111":298,"_104":116},{"_113":299},{"_115":116},{"_121":301,"_151":312,"_156":313,"_176":-5,"_177":178,"_179":316,"_184":317},{"_123":302,"_135":307,"_139":150},[303,305],{"_126":304},[128],{"_126":306},[131,132,133,134],{"_133":308,"_134":309,"_143":310,"_128":311},{"_29":138,"_139":140},{"_29":142,"_139":140},{"_145":146,"_29":147,"_139":140},{"_29":149,"_139":140},{"_33":153,"_154":155},{"_158":159,"_160":161,"_162":163,"_16":164,"_165":166,"_31":32,"_111":314,"_169":170,"_171":315,"_174":175},{"_115":116,"_107":168},{"_31":173},{"_31":181,"_182":183},[186],{"_189":190,"_191":190,"_192":190},"member",{"_321":322,"_325":326,"_327":289,"_162":163,"_328":282,"_329":289,"_330":178,"_290":291,"_139":285},"commit",{"_323":324},"sha","b961721de5a14ae020c202d4bb9cea0a3a3451bf","contentStoredObjectPointerId",313262,"fullPath","indexable","path","safeToDisplayAsText",[332,334,336,338,340,341,342,344,345,346,347,348,349,350,351,352,353,354],{"_201":333},".npmrc | contentful-mcp | Glama",{"_204":335,"_31":29},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_206":337,"_208":209,"_210":211},"https://glama.ai/mcp/servers/@ivo-toby/contentful-mcp/blob/b961721de5a14ae020c202d4bb9cea0a3a3451bf/",{"_204":339,"_213":214},".npmrc | contentful-mcp",{"_204":335,"_213":216},{"_204":218,"_213":219},{"_204":343,"_213":222},"https://glama.ai/generated-images/og?title=.npmrc+%7C+contentful-mcp",{"_204":224,"_213":225},{"_204":227,"_213":228},{"_204":230,"_213":231},{"_204":337,"_213":233},{"_204":235,"_213":236},{"_204":238,"_31":239},{"_204":235,"_31":241},{"_204":335,"_31":243},{"_204":343,"_31":245},{"_204":224,"_31":247},{"_204":227,"_31":249},"","treeMembers",[358,362,365,368,371,374,377,380,383,386,389,392,395,397,400,403,406,409,412,415,418],{"_321":359,"_327":360,"_329":360,"_139":361},{"_323":324},"bin","tree",{"_321":363,"_327":364,"_329":364,"_139":361},{"_323":324},".github",{"_321":366,"_327":367,"_329":367,"_139":361},{"_323":324},"scripts",{"_321":369,"_327":370,"_329":370,"_139":361},{"_323":324},"src",{"_321":372,"_327":373,"_329":373,"_139":361},{"_323":324},"test",{"_321":375,"_327":376,"_329":376,"_139":285},{"_323":324},"build.js",{"_321":378,"_327":379,"_329":379,"_139":285},{"_323":324},"CLAUDE.md",{"_321":381,"_327":382,"_329":382,"_139":285},{"_323":324},"codecompanion-workspace.json",{"_321":384,"_327":385,"_329":385,"_139":285},{"_323":324},"Dockerfile",{"_321":387,"_327":388,"_329":388,"_139":285},{"_323":324},"eslint.config.js",{"_321":390,"_327":391,"_329":391,"_139":285},{"_323":324},".gitignore",{"_321":393,"_327":394,"_329":394,"_139":285},{"_323":324},"LICENSE",{"_321":396,"_327":289,"_329":289,"_139":285},{"_323":324},{"_321":398,"_327":399,"_329":399,"_139":285},{"_323":324},"package.json",{"_321":401,"_327":402,"_329":402,"_139":285},{"_323":324},"package-lock.json",{"_321":404,"_327":405,"_329":405,"_139":285},{"_323":324},".prettierrc",{"_321":407,"_327":408,"_329":408,"_139":285},{"_323":324},"README.md",{"_321":410,"_327":411,"_329":411,"_139":285},{"_323":324},".releaserc",{"_321":413,"_327":414,"_329":414,"_139":285},{"_323":324},"smithery.yaml",{"_321":416,"_327":417,"_329":417,"_139":285},{"_323":324},"tsconfig.json",{"_321":419,"_327":420,"_329":420,"_139":285},{"_323":324},"vitest.config.ts","actionData","errors"]

MCP directory API