Skip to main content
Glama

Контентный 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 при каждом изменении.

Конфигурация

Предпосылки

  1. Создайте учетную запись Contentful на Contentful

  2. Создайте токен API управления контентом из настроек вашего аккаунта.

Переменные среды

Эти переменные также могут быть заданы как аргументы.

  • CONTENTFUL_HOST / --host : Конечная точка API управления контентом (по умолчанию https://api.contentful.com )

  • CONTENTFUL_MANAGEMENT_ACCESS_TOKEN / --management-token : Ваш токен API управления контентом

  • ENABLE_HTTP_SERVER / --http : Установите значение «true», чтобы включить режим HTTP/SSE

  • HTTP_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 tools
bulk_validateC

Validate multiple entries at once

Inputs: entryIds (required), spaceId (required), environmentId (required).

create_ai_actionC

Create a new AI Action

Inputs: name (required), description (required), instruction (required), configuration (required), +3 more.

create_commentA

Create a new comment on an entry. The comment will be created with the specified body and status. To create a threaded conversation (reply to an existing comment), provide the parent comment ID. This allows you to work around the 512-character limit by creating threaded replies.

Inputs: entryId (required), body (required), spaceId (required), environmentId (required), +2 more.

create_content_typeD

Create a new content type

Inputs: name (required), fields (required), spaceId (required), environmentId (required), +2 more.

create_entryA

Create a new entry in Contentful. Before executing this function, you need to know the contentTypeId (not the content type NAME) and the fields of that contentType. You can get the fields definition by using the GET_CONTENT_TYPE tool. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Title' } }. Every field in Contentful requires a locale even for single-language content.

Inputs: contentTypeId (required), fields (required), spaceId (required), environmentId (required).

create_environmentD

Create a new environment

Inputs: spaceId (required), environmentId (required), name (required).

delete_ai_actionB

Delete an AI Action

Inputs: aiActionId (required), spaceId (required), environmentId (required).

delete_assetC

Delete an asset

Inputs: assetId (required), spaceId (required), environmentId (required).

delete_commentC

Delete a specific comment from an entry.

Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required).

delete_content_typeC

Delete a content type

Inputs: contentTypeId (required), spaceId (required), environmentId (required).

delete_entryC

Delete an entry

Inputs: entryId (required), spaceId (required), environmentId (required).

delete_environmentC

Delete an environment

Inputs: spaceId (required), environmentId (required).

get_ai_actionB

Get a specific AI Action by ID

Inputs: aiActionId (required), spaceId (required), environmentId (required).

get_ai_action_invocationB

Get the result of a previous AI Action invocation

Inputs: aiActionId (required), invocationId (required), spaceId (required), environmentId (required).

get_assetC

Retrieve an asset

Inputs: assetId (required), spaceId (required), environmentId (required).

get_commentsB

Retrieve comments for an entry with pagination support. Returns comments with their status and body content.

Inputs: entryId (required), spaceId (required), environmentId (required), bodyFormat, +3 more.

get_content_typeB

Get details of a specific content type

Inputs: contentTypeId (required), spaceId (required), environmentId (required).

get_entryC

Retrieve an existing entry

Inputs: entryId (required), spaceId (required), environmentId (required).

get_single_commentB

Retrieve a specific comment by its ID for an entry.

Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required), +1 more.

get_spaceC

Get details of a space

Inputs: spaceId (required).

invoke_ai_actionC

Invoke an AI Action with variables

Inputs: aiActionId (required), spaceId (required), environmentId (required), variables, +3 more.

list_ai_actionsC

List all AI Actions in a space

Inputs: spaceId (required), environmentId (required), limit, skip, +1 more.

list_assetsA

List assets in a space. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.

Inputs: limit (required), skip (required), spaceId (required), environmentId (required).

list_content_typesB

List content types in a space. Returns a maximum of 10 items per request. Use skip parameter to paginate through results.

Inputs: limit (required), skip (required), spaceId (required), environmentId (required).

list_environmentsC

List all environments in a space

Inputs: spaceId (required).

list_spacesA

List all available spaces

Inputs: no named parameters.

publish_ai_actionC

Publish an AI Action

Inputs: aiActionId (required), spaceId (required), environmentId (required).

publish_assetC

Publish an asset

Inputs: assetId (required), spaceId (required), environmentId (required).

publish_content_typeC

Publish a content type

Inputs: contentTypeId (required), spaceId (required), environmentId (required).

publish_entryA

Publish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard publish operation. For multiple entries, it automatically uses bulk publishing.

Inputs: entryId (required), spaceId (required), environmentId (required).

search_entriesA

Search for entries using query parameters. Returns a maximum of 3 items per request. Use skip parameter to paginate through results.

Inputs: query (required), spaceId (required), environmentId (required).

unpublish_ai_actionC

Unpublish an AI Action

Inputs: aiActionId (required), spaceId (required), environmentId (required).

unpublish_assetC

Unpublish an asset

Inputs: assetId (required), spaceId (required), environmentId (required).

unpublish_entryA

Unpublish an entry or multiple entries. Accepts either a single entryId (string) or an array of entryIds (up to 100 entries). For a single entry, it uses the standard unpublish operation. For multiple entries, it automatically uses bulk unpublishing.

Inputs: entryId (required), spaceId (required), environmentId (required).

update_ai_actionC

Update an existing AI Action

Inputs: aiActionId (required), name (required), description (required), instruction (required), +4 more.

update_assetD

Update an asset

Inputs: assetId (required), spaceId (required), environmentId (required), title, +2 more.

update_commentA

Update an existing comment on an entry. The handler will merge your updates with the existing comment data.

Inputs: entryId (required), commentId (required), spaceId (required), environmentId (required), +3 more.

update_content_typeB

Update an existing content type. The handler will merge your field updates with existing content type data, so you only need to provide the fields and properties you want to change.

Inputs: contentTypeId (required), fields (required), spaceId (required), environmentId (required), +3 more.

update_entryA

Update an existing entry. The handler will merge your field updates with the existing entry fields, so you only need to provide the fields and locales you want to change. IMPORTANT: All field values MUST include a locale key (e.g., 'en-US') for each value, like: { title: { 'en-US': 'My Updated Title' } }. Every field in Contentful requires a locale even for single-language content.

Inputs: entryId (required), fields (required), spaceId (required), environmentId (required).

upload_assetC

Upload a new asset

Inputs: title (required), file (required), spaceId (required), environmentId (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 40 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (e.g., create_entry vs. get_entry, publish_asset vs. unpublish_asset). There is no overlap in purpose, and descriptions clearly differentiate similar operations like get_ai_action vs. get_ai_action_invocation.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern (e.g., create_entry, list_assets, update_comment). No mixing of conventions like camelCase or different verb styles.

    Tool Count2/5

    With 40 tools, the count exceeds the typical well-scoped range (3-15) and the '25+' threshold for too many. Even considering Contentful's complexity, the number feels heavy and may overwhelm agents.

    Completeness5/5

    The tool set covers full CRUD plus publish/unpublish, search, and validation for entries; CRUD plus upload for assets; lifecycle for comments, environments, AI actions; and space listing. No obvious gaps such as missing delete for content types or bulk operations.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers