Каталог MCP

ivo-toby/contentful-mcp

MCP сервер для Contentful, интегрирующийся с API управления контентом: создание, редактирование, публикация записей и медиа, управление комментариями и массовые операции. Полезен разработчикам и контент-менеджерам для автоматизации контент-процессов через LLM.

README

40 инструментов

Версии

Установить сервер

Contentful MCP Server

Notice

This is a community driven server! Contentful has released an official server which you can find here

An MCP server implementation that integrates with Contentful's Content Management API, providing comprehensive content management capabilities.

Please note *; if you are not interested in the code, and just want to use this MCP in Claude Desktop (or any other tool that is able to use MCP servers) you don't have to clone this repo, you can just set it up in Claude desktop, refer to the section "Usage with Claude Desktop" for instructions on how to install it.

Features

Content Management: Full CRUD operations for entries and assets
Comment Management: Create, retrieve, and manage comments on entries with support for both plain-text and rich-text formats, including threaded conversations
Space Management: Create, update, and manage spaces and environments
Content Types: Manage content type definitions
Localization: Support for multiple locales
Publishing: Control content publishing workflow
Bulk Operations: Execute bulk publishing, unpublishing, and validation across multiple entries and assets
Smart Pagination: List operations return maximum 3 items per request to prevent context window overflow, with built-in pagination support

Инструменты были проиндексированы: 04.09.2026

bulk_validate

Проверить несколько записей сразу

Параметры

entryIdsstring[]обязательный
Array of entry IDs to validate
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

create_ai_action

Создаёт новое AI Action

Параметры

configurationobjectобязательный
The model configuration
descriptionstringобязательный
The description of the AI Action
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
instructionobjectобязательный
The instruction object containing the template and variables
namestringобязательный
The name of the AI Action
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
testCasesobject[]
Optional array of test cases for the AI Action

create_comment

Создаёт новый комментарий к записи. Комментарий будет создан с указанным текстом и статусом. Для создания цепочки обсуждений (ответа на существующий комментарий) необходимо указать идентификатор родительского комментария. Это позволяет обойти ограничение в 512 символов, создавая цепочки ответов.

Параметры

bodystringобязательный
The content of the comment (max 512 characters)
entryIdstringобязательный
The unique identifier of the entry to comment on
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
parentstring
Optional ID of the parent comment to reply to. Use this to create threaded conversations or to continue longer messages by replying to your own comments.
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
statusenum
The status of the comment

create_content_type

Создать новый тип контента

Параметры

descriptionstring
displayFieldstring
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
fieldsobject[]обязательный
Array of field definitions for the content type
namestringобязательный
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

create_entry

Создает новую запись в Contentful. Перед выполнением этой функции необходимо знать contentTypeId (не НАЗВАНИЕ типа контента) и поля этого типа контента. Определение полей можно получить с помощью инструмента GET_CONTENT_TYPE. ВАЖНО: Все значения полей ДОЛЖНЫ включать ключ локали (например, 'en-US') для каждого значения, как в примере: { title: { 'en-US': 'My Title' } }. Каждое поле в Contentful требует указания локали, даже для одноязычного контента.

Параметры

contentTypeIdstringобязательный
The ID of the content type for the new entry
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
fieldsobjectобязательный
The fields of the entry with localized values. Example: { title: { 'en-US': 'My Title' }, description: { 'en-US': 'My Description' } }
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

create_environment

Создать новое окружение

Параметры

environmentIdstringобязательный
namestringобязательный
spaceIdstringобязательный

delete_ai_action

Удалить AI Action

Параметры

aiActionIdstringобязательный
The ID of the AI Action to delete
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

delete_asset

Удалить актив

Параметры

assetIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

delete_comment

Удаляет конкретный комментарий из записи.

Параметры

commentIdstringобязательный
The unique identifier of the comment to delete
entryIdstringобязательный
The unique identifier of the entry
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

delete_content_type

Удалить тип контента

Параметры

contentTypeIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

delete_entry

Удалить запись

Параметры

entryIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

delete_environment

Удалить окружение

Параметры

environmentIdstringобязательный
spaceIdstringобязательный

get_ai_action

Получить конкретный AI Action по ID

Параметры

aiActionIdstringобязательный
The ID of the AI Action to retrieve
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

get_ai_action_invocation

Получить результат предыдущего вызова AI Action

Параметры

aiActionIdstringобязательный
The ID of the AI Action
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
invocationIdstringобязательный
The ID of the specific invocation to retrieve
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

get_asset

Извлечь актив

Параметры

assetIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

get_comments

Извлекает комментарии для записи с поддержкой постраничной навигации. Возвращает комментарии с их статусом и содержимым.

Параметры

bodyFormatenum
Format for the comment body content
entryIdstringобязательный
The unique identifier of the entry to get comments for
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
limitnumber
Maximum number of comments to return (1-100, default: 10)
skipnumber
Number of comments to skip for pagination (default: 0)
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
statusenum
Filter comments by status

get_content_type

Получить сведения о конкретном типе контента

Параметры

contentTypeIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

get_entry

Получить существующую запись

Параметры

entryIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

get_single_comment

Получить конкретный комментарий по его ID для записи.

Параметры

bodyFormatenum
Format for the comment body content
commentIdstringобязательный
The unique identifier of the comment to retrieve
entryIdstringобязательный
The unique identifier of the entry
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

get_space

Получить детали пространства

Параметры

spaceIdstringобязательный

invoke_ai_action

Вызвать AI Action с переменными

Параметры

aiActionIdstringобязательный
The ID of the AI Action to invoke
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
outputFormatenum
The format of the output content
rawVariablesobject[]
Array of raw variable objects (for complex variable types like references)
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
variablesobject
Key-value pairs of variable IDs and their values
waitForCompletionboolean
Whether to wait for the AI Action to complete before returning

list_ai_actions

Вывести список всех AI Actions в пространстве.

Параметры

environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
limitnumber
Maximum number of AI Actions to return
skipnumber
Number of AI Actions to skip for pagination
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
statusenum
Filter AI Actions by status

list_assets

Перечисляет активы в пространстве. Возвращает не более 3 элементов за один запрос. Используйте параметр skip для постраничного перебора результатов.

Параметры

environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
limitnumberобязательный
Maximum number of items to return (max: 3)
skipnumberобязательный
Number of items to skip for pagination
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

list_content_types

Получает список типов контента в пространстве. Возвращает максимум 10 элементов за запрос. Используйте параметр skip для пролистывания результатов.

Параметры

environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
limitnumberобязательный
Maximum number of items to return (max: 3)
skipnumberобязательный
Number of items to skip for pagination
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

list_environments

Список всех окружений в пространстве

Параметры

spaceIdstringобязательный

list_spaces

Перечисляет все доступные пространства.

Параметры

Без параметров.

publish_ai_action

Опубликовать AI Action

Параметры

aiActionIdstringобязательный
The ID of the AI Action to publish
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

publish_asset

Опубликовать актив

Параметры

assetIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

publish_content_type

Опубликовать тип контента

Параметры

contentTypeIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

publish_entry

Публикует одну или несколько записей. Принимает либо один entryId (строка), либо массив entryIds (до 100 записей). Для одной записи использует стандартную операцию публикации. Для нескольких записей автоматически использует массовую публикацию.

Параметры

entryIdstring | string[]обязательный
ID of the entry to publish, or an array of entry IDs (max: 100)
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

search_entries

Ищет записи по параметрам запроса. Возвращает не более 3 элементов за запрос. Используйте параметр skip для пролистывания результатов.

Параметры

environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
queryobjectобязательный
Query parameters for searching entries
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

unpublish_ai_action

Отменяет публикацию AI Action.

Параметры

aiActionIdstringобязательный
The ID of the AI Action to unpublish
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

unpublish_asset

Снять ресурс с публикации

Параметры

assetIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

unpublish_entry

Снимает с публикации одну или несколько записей. Принимает либо один entryId (строка), либо массив entryIds (до 100 записей). Для одной записи использует стандартную операцию снятия с публикации. Для нескольких записей автоматически применяет массовое снятие с публикации.

Параметры

entryIdstring | string[]обязательный
ID of the entry to unpublish, or an array of entry IDs (max: 100)
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

update_ai_action

Обновить существующее AI Action

Параметры

aiActionIdstringобязательный
The ID of the AI Action to update
configurationobjectобязательный
The model configuration
descriptionstringобязательный
The description of the AI Action
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
instructionobjectобязательный
The instruction object containing the template and variables
namestringобязательный
The name of the AI Action
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
testCasesobject[]
Optional array of test cases for the AI Action

update_asset

Обновить актив

Параметры

assetIdstringобязательный
descriptionstring
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
fileobject
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
titlestring

update_comment

Обновляет существующий комментарий к записи. Обработчик объединит ваши изменения с данными существующего комментария.

Параметры

bodystring
The updated content of the comment
bodyFormatenum
Format for the comment body content
commentIdstringобязательный
The unique identifier of the comment to update
entryIdstringобязательный
The unique identifier of the entry
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
statusenum
The updated status of the comment

update_content_type

Обновляет существующий тип контента. Обработчик объединяет ваши изменения полей с текущими данными типа контента, так что достаточно указать только те поля и свойства, которые вы хотите изменить.

Параметры

contentTypeIdstringобязательный
descriptionstring
displayFieldstring
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
fieldsobject[]обязательный
namestring
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

update_entry

Обновляет существующую запись. Обработчик объединит ваши изменения полей с существующими полями записи, поэтому вам нужно указать только те поля и локали, которые вы хотите изменить. ВАЖНО: Все значения полей ОБЯЗАТЕЛЬНО должны включать ключ локали (например, 'en-US') для каждого значения, как показано: { title: { 'en-US': 'My Updated Title' } }. Каждое поле в Contentful требует локаль, даже для однозязычного контента.

Параметры

entryIdstringобязательный
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
fieldsobjectобязательный
The fields to update with localized values. Example: { title: { 'en-US': 'My Updated Title' } }
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.

upload_asset

Загрузить новый ассет

Параметры

descriptionstring
environmentIdstringобязательный
The ID of the environment within the space, by default this will be called Master
fileobjectобязательный
spaceIdstringобязательный
The ID of the Contentful space. This must be the space's ID, not its name, ask for this ID if it's unclear.
titlestringобязательный

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@ivotoby/contentful-management-mcp-server"
  ],
  "env": {
    "CONTENTFUL_MANAGEMENT_ACCESS_TOKEN": "<Your CMA token>"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер даёт ИИ-ассистентам вроде Claude прямой доступ к Contentful. Вместо того чтобы копаться в админке или писать API-запросы вручную, AI сам создаёт, редактирует и публикует записи, загружает файлы, управляет комментариями и окружениями. Он решает задачу — автоматизировать рутину контент-менеджера, позволяя управлять CMS через естественный язык.

Что он умеет?

Сервер управляет контентом Contentful: ищет, создаёт, читает, обновляет и удаляет записи, публикует и снимает с публикации. Работает с медиафайлами, пространствами, окружениями и типами контента. Ведёт комментарии к записям, поддерживает треды. Управляет AI-действиями: создаёт, редактирует, публикует и запускает их. Поддерживает массовые операции: пакетную публикацию, распубликовку и валидацию. Списки ограничены тремя элементами на страницу, есть пагинация.