contentful-mcp
Контентный MCP-сервер
Реализация сервера MCP, которая интегрируется с API управления контентом Contentful, предоставляя комплексные возможности управления контентом.
Обратите внимание *; если вас не интересует код, а вы просто хотите использовать этот MCP в Claude Desktop (или любом другом инструменте, который может использовать серверы MCP), вам не нужно клонировать этот репозиторий, вы можете просто настроить его в Claude Desktop, инструкции по его установке см. в разделе «Использование с Claude Desktop».
Функции
Управление контентом : полный цикл операций CRUD для записей и активов
Управление пространством : создание, обновление и управление пространствами и средами.
Типы контента : управление определениями типов контента
Локализация : Поддержка нескольких локалей
Публикация : управление процессом публикации контента
Массовые операции : выполнение массовой публикации, отмены публикации и проверки нескольких записей и активов.
Умная пагинация : операции со списками возвращают максимум 3 элемента на запрос, чтобы предотвратить переполнение контекстного окна, со встроенной поддержкой пагинации.
Related MCP server: Storyblok MCP Server
Пагинация
Чтобы предотвратить переполнение контекстного окна в LLM, операции со списками (например, search_entries и list_assets) ограничены 3 элементами на запрос. Каждый ответ включает:
Общее количество доступных предметов
Текущая страница элементов (макс. 3)
Количество оставшихся предметов
Пропустить значение для следующей страницы
Сообщение, побуждающее LLM предложить извлечь больше элементов
Эта система пагинации позволяет LLM эффективно обрабатывать большие наборы данных, сохраняя при этом ограничения контекстного окна.
Массовые операции
Функция массовых операций обеспечивает эффективное управление несколькими элементами контента одновременно:
Асинхронная обработка : операции выполняются асинхронно и предоставляют обновления статуса.
Эффективное управление контентом : обработка нескольких записей или активов за один вызов API
Отслеживание статуса : отслеживайте прогресс с помощью счетчиков успешных и неудачных операций.
Оптимизация ресурсов : сокращение числа вызовов API и повышение производительности пакетных операций.
Эти инструменты для массовых операций идеально подходят для миграции контента, массовых обновлений или пакетных публикаций.
Инструменты
Управление входом
search_entries : Поиск записей с использованием параметров запроса
create_entry : Создать новые записи
get_entry : Извлечь существующие записи
update_entry : Обновить поля ввода
delete_entry : Удалить записи
publish_entry : Публикация записей
unpublish_entry : Отменить публикацию записей
Массовые операции
bulk_publish : Публикация нескольких записей и активов за одну операцию. Принимает массив сущностей (записей и активов) и обрабатывает их публикацию как пакет.
bulk_unpublish : Отменить публикацию нескольких записей и активов за одну операцию. Аналогично bulk_publish, но удаляет контент из API доставки.
bulk_validate : Проверка нескольких записей на предмет согласованности содержимого, ссылок и обязательных полей. Возвращает результаты проверки без изменения содержимого.
Управление активами
list_assets : Список активов с разбивкой на страницы (3 элемента на странице)
upload_asset : Загрузить новые активы с метаданными
get_asset : Получить сведения и информацию об активах
update_asset : Обновление метаданных и файлов активов
delete_asset : Удалить активы из пространства
publish_asset : публикация ресурсов в API доставки
unpublish_asset : Отменить публикацию ресурсов из API доставки
Управление пространством и окружающей средой
list_spaces : Список доступных пространств
get_space : Получить сведения о пространстве
list_environments : Список сред в пространстве
create_environment : Создать новую среду
delete_environment : Удалить среду
Управление типом контента
list_content_types : Список доступных типов контента
get_content_type : Получить сведения о типе контента
create_content_type : Создать новый тип контента
update_content_type : Обновить тип контента
delete_content_type : Удалить тип контента
publish_content_type : Опубликовать тип контента
Инструменты разработки
Инспектор МКП
Проект включает в себя инструмент MCP Inspector, который помогает в разработке и отладке:
Режим проверки : запустите
npm run inspect, чтобы запустить инспектор. Вы можете открыть инспектор, перейдя по адресу http://localhost:5173.Режим наблюдения : используйте
npm run inspect:watchдля автоматического перезапуска инспектора при изменении файлов.Визуальный интерфейс : инспектор предоставляет веб-интерфейс для тестирования и отладки инструментов MCP.
Тестирование в реальном времени : попробуйте инструменты и сразу же увидите результаты.
Тестирование массовых операций : тестирование и мониторинг массовых операций с визуальной обратной связью о ходе выполнения и результатах.
Проект также содержит команду npm run dev , которая перестраивает и перезагружает сервер MCP при каждом изменении.
Конфигурация
Предпосылки
Создайте учетную запись Contentful на Contentful
Создайте токен API управления контентом из настроек вашего аккаунта.
Переменные среды
Эти переменные также могут быть заданы как аргументы.
CONTENTFUL_HOST/--host: Конечная точка API управления контентом (по умолчанию https://api.contentful.com )CONTENTFUL_MANAGEMENT_ACCESS_TOKEN/--management-token: Ваш токен API управления контентомENABLE_HTTP_SERVER/--http: Установите значение «true», чтобы включить режим HTTP/SSEHTTP_PORT/--port: Порт для HTTP-сервера (по умолчанию: 3000)HTTP_HOST/--http-host: Хост для HTTP-сервера (по умолчанию: localhost)
Исследование космоса и окружающей среды
Вы можете ограничить spaceId и EnvironmentId, чтобы гарантировать, что LLM будет выполнять операции только с определенными идентификаторами пространства/среды. Это в основном необходимо для поддержки агентов, которые должны работать в определенных пространствах. Если заданы как SPACE_ID , так и ENVIRONMENT_ID env-vars, инструменты не будут сообщать о необходимости этих значений, а обработчики будут использовать переменные среды для выполнения операций CMA. Вы также потеряете доступ к инструментам в обработчике пространства, поскольку эти инструменты находятся в разных пространствах. Вы также можете добавить SPACE_ID и ENVIRONMENT_ID , используя аргументы --space-id и --environment-id
Использование идентификатора приложения
Вместо предоставления токена управления вы также можете использовать App Identity для обработки аутентификации. Вам придется настроить и установить Contentful App и задать следующие параметры при вызове MCP-сервера:
--app-id= идентификатор приложения, предоставляющего Apptoken--private-key= закрытый ключ, созданный вами в пользовательском интерфейсе вашего приложения, привязанный кapp_id--space-id= spaceId, в котором установлено приложение--environment-id= environmentId (внутри пространства), в котором установлено приложение.
С этими значениями сервер MCP запросит временный AppToken для выполнения операции с контентом в определенном пространстве/идентификаторе среды. Это особенно полезно при использовании этого сервера MCP в бэкэнд-системах, которые действуют как MCP-клиент (например, чат-агенты)
Использование с Claude Desktop
Вам не нужно клонировать этот репозиторий, чтобы использовать этот MCP, вы можете просто добавить его в свой claude_desktop_config.json :
Добавьте или отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json и добавьте следующие строки:
{
"mcpServers": {
"contentful": {
"command": "npx",
"args": ["-y", "@ivotoby/contentful-management-mcp-server"],
"env": {
"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
}
}
}
}Если ваш MCPClient не поддерживает настройку переменных среды, вы также можете установить токен управления, используя следующий аргумент:
{
"mcpServers": {
"contentful": {
"command": "npx",
"args": [
"-y",
"@ivotoby/contentful-management-mcp-server",
"--management-token",
"<your token>",
"--host",
"http://api.contentful.com"
]
}
}
}Установка через Smithery
Чтобы автоматически установить Contentful Management Server для Claude Desktop через Smithery :
npx -y @smithery/cli install @ivotoby/contentful-management-mcp-server --client claudeРазработка и использование Claude Desktop
Если вы хотите внести свой вклад и проверить, что Клод сделает с вашим вкладом;
запустите
npm run dev, это запустит наблюдателя, который перестраивает сервер MCP при каждом измененииобновите
claude_desktop_config.json, чтобы он напрямую ссылался на проект, т. е.:
{
"mcpServers": {
"contentful": {
"command": "node",
"args": ["/Users/ivo/workspace/contentful-mcp/bin/mcp-server.js"],
"env": {
"CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA Token>"
}
}
}
}Это позволит вам протестировать любые изменения на сервере MCP напрямую с помощью Claude. Однако если вы добавите новые инструменты/ресурсы, вам потребуется перезапустить Claude Desktop.
Виды транспорта
Сервер MCP поддерживает два режима транспортировки:
stdio транспорт
Режим транспорта по умолчанию использует стандартные потоки ввода/вывода для связи. Это идеально подходит для интеграции с клиентами MCP, поддерживающими транспорт stdio, такими как Claude Desktop.
Чтобы использовать режим stdio, просто запустите сервер без флага --http :
npx -y contentful-mcp --management-token YOUR_TOKEN
# or alternatively
npx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKENПотоковый HTTP-транспорт
Сервер также поддерживает транспорт StreamableHTTP, как определено в протоколе MCP. Этот режим полезен для веб-интеграций или при запуске сервера как автономной службы.
Чтобы использовать режим StreamableHTTP, запустите с флагом --http :
npx -y contentful-mcp --management-token YOUR_TOKEN --http --port 3000
# or alternatively
npx -y @ivotoby/contentful-management-mcp-server --management-token YOUR_TOKEN --http --port 3000Подробности о потоковом HTTP
Использует официальный транспорт MCP StreamableHTTP
Поддерживает стандартные операции протокола MCP
Включает управление сеансами для поддержания состояния
Правильно обрабатывает шаблоны инициализации/уведомления
Совместимость со стандартными клиентами MCP
Заменяет устаревший транспорт SSE на современный подход.
Реализация соответствует стандартной спецификации протокола MCP, позволяя любому клиенту MCP подключаться к серверу без специальной обработки.
Обработка ошибок
Сервер реализует комплексную обработку ошибок для:
Ошибки аутентификации
Ограничение скорости
Недействительные запросы
Проблемы с сетью
Ошибки, специфичные для API
Лицензия
Лицензия Массачусетского технологического института
Мелкий шрифт
Этот MCP Server позволяет Claude (или другим агентам, которые могут потреблять ресурсы MCP) обновлять, удалять контент, пространства и модели контента. Поэтому будьте уверены, что вы позволяете Claude делать с вашими Contentful пространствами!
Этот MCP-сервер официально не поддерживается Contentful (пока)
Available Tools
40 toolsbulk_validateC
Validate multiple entries at once
Inputs: entryIds (required), spaceId (required), environmentId (required).
create_ai_actionC
Create a new AI Action
Inputs: name (required), description (required), instruction (required), configuration (required), +3 more.
create_commentA
Create a new comment on an entry. The comment will be created with the specified body and status. To create a threaded conversation (reply to an existing comment), provide the parent comment ID. This allows you to work around the 512-character limit by creating threaded replies.
Inputs: entryId (required), body (required), spaceId (required), environmentId (required), +2 more.
create_content_typeD
Create a new content type
Inputs: name (required), fields (required), spaceId (required), environmentId (required), +2 more.
create_entryA
Create a new entry in Contentful. Before executing this function, you need to know the contentTypeId (not the content type NAME) and the fields of that contentType. You can get the fields definition by using the GET_CONTENT_TYPE tool. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Title' } }. Every field in Contentful requires a locale even for single-language content.
Inputs: contentTypeId (required), fields (required), spaceId (required), environmentId (required).
create_environmentD
Create a new environment
Inputs: spaceId (required), environmentId (required), name (required).
delete_ai_actionB
Delete an AI Action
Inputs: aiActionId (required), spaceId (required), environmentId (required).
delete_assetC
Delete an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
delete_commentC
Delete a specific comment from an entry.
Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required).
delete_content_typeC
Delete a content type
Inputs: contentTypeId (required), spaceId (required), environmentId (required).
delete_entryC
Delete an entry
Inputs: entryId (required), spaceId (required), environmentId (required).
delete_environmentC
Delete an environment
Inputs: spaceId (required), environmentId (required).
get_ai_actionB
Get a specific AI Action by ID
Inputs: aiActionId (required), spaceId (required), environmentId (required).
get_ai_action_invocationB
Get the result of a previous AI Action invocation
Inputs: aiActionId (required), invocationId (required), spaceId (required), environmentId (required).
get_assetC
Retrieve an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
get_commentsB
Retrieve comments for an entry with pagination support. Returns comments with their status and body content.
Inputs: entryId (required), spaceId (required), environmentId (required), bodyFormat, +3 more.
get_content_typeB
Get details of a specific content type
Inputs: contentTypeId (required), spaceId (required), environmentId (required).
get_entryC
Retrieve an existing entry
Inputs: entryId (required), spaceId (required), environmentId (required).
get_single_commentB
Retrieve a specific comment by its ID for an entry.
Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required), +1 more.
get_spaceC
Get details of a space
Inputs: spaceId (required).
invoke_ai_actionC
Invoke an AI Action with variables
Inputs: aiActionId (required), spaceId (required), environmentId (required), variables, +3 more.
list_ai_actionsC
List all AI Actions in a space
Inputs: spaceId (required), environmentId (required), limit, skip, +1 more.
list_assetsA
List assets in a space. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.
Inputs: limit (required), skip (required), spaceId (required), environmentId (required).
list_content_typesB
List content types in a space. Returns a maximum of 10 items per request. Use skip parameter to paginate through results.
Inputs: limit (required), skip (required), spaceId (required), environmentId (required).
list_environmentsC
List all environments in a space
Inputs: spaceId (required).
list_spacesA
List all available spaces
Inputs: no named parameters.
publish_ai_actionC
Publish an AI Action
Inputs: aiActionId (required), spaceId (required), environmentId (required).
publish_assetC
Publish an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
publish_content_typeC
Publish a content type
Inputs: contentTypeId (required), spaceId (required), environmentId (required).
publish_entryA
Publish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard publish operation. For multiple entries, it automatically uses bulk publishing.
Inputs: entryId (required), spaceId (required), environmentId (required).
search_entriesA
Search for entries using query parameters. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.
Inputs: query (required), spaceId (required), environmentId (required).
unpublish_ai_actionC
Unpublish an AI Action
Inputs: aiActionId (required), spaceId (required), environmentId (required).
unpublish_assetC
Unpublish an asset
Inputs: assetId (required), spaceId (required), environmentId (required).
unpublish_entryA
Unpublish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard unpublish operation. For multiple entries, it automatically uses bulk unpublishing.
Inputs: entryId (required), spaceId (required), environmentId (required).
update_ai_actionC
Update an existing AI Action
Inputs: aiActionId (required), name (required), description (required), instruction (required), +4 more.
update_assetD
Update an asset
Inputs: assetId (required), spaceId (required), environmentId (required), title, +2 more.
update_commentA
Update an existing comment on an entry. The handler will merge your updates with the existing comment data.
Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required), +3 more.
update_content_typeB
Update an existing content type. The handler will merge your field updates with existing content type data, so you only need to provide the fields and properties you want to change.
Inputs: contentTypeId (required), fields (required), spaceId (required), environmentId (required), +3 more.
update_entryA
Update an existing entry. The handler will merge your field updates with the existing entry fields, so you only need to provide the fields and locales you want to change. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Updated Title' } }. Every field in Contentful requires a locale even for single-language content.
Inputs: entryId (required), fields (required), spaceId (required), environmentId (required).
upload_assetC
Upload a new asset
Inputs: title (required), file (required), spaceId (required), environmentId (required), +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Each tool targets a distinct resource and action (e.g., create_entry vs. get_entry, publish_asset vs. unpublish_asset). There is no overlap in purpose, and descriptions clearly differentiate similar operations like get_ai_action vs. get_ai_action_invocation.
All tools follow a consistent verb_noun snake_case pattern (e.g., create_entry, list_assets, update_comment). No mixing of conventions like camelCase or different verb styles.
With 40 tools, the count exceeds the typical well-scoped range (3-15) and the '25+' threshold for too many. Even considering Contentful's complexity, the number feels heavy and may overwhelm agents.
The tool set covers full CRUD plus publish/unpublish, search, and validation for entries; CRUD plus upload for assets; lifecycle for comments, environments, AI actions; and space listing. No obvious gaps such as missing delete for content types or bulk operations.
Maintenance
Related MCP Connectors
Headless CMS. Search the docs and read, draft, publish, and schedule entries via OAuth.
Run read-only GraphQL queries and list documents and media assets in Caisy.
Manage repositories, users, releases, and automate GitHub workflows
Hosted Kontent.ai MCP server to manage content, types, taxonomies, and workflows
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server for interacting with Contentstack's Content Management API1511 npm2TypeScriptMIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive management of Storyblok CMS through natural language interactions. Supports story creation and publishing, asset management, component schema updates, release workflows, and content discovery across all major Storyblok APIs.8 npm-
- AlicenseAqualityDmaintenanceEnables efficient content retrieval from Contentful's Content Delivery API using GraphQL queries. Supports schema exploration, query generation, and flexible data fetching with read-only access.69 npm1MIT
- AlicenseAqualityNot gradedmaintenanceEnables AI agents to manage Contentrain CMS content, models, and assets with automatic git branch synchronization across different environments. It provides standardized tools for performing CRUD operations on git-based headless CMS projects through natural language.14-