Contentful в MCP: управляйте Contentful из любого AI-агента

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Contentful, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Contentful

Дайте ИИ работать с контентом в Contentful: искать записи и ассеты, читать типы контента, локали и теги, а также создавать, изменять, публиковать и снимать с публикации записи. Delivery-токен для чтения, management-токен для записи.

Настройка

1. В Contentful (https://app.contentful.com) откройте свой space, затем Settings → API keys → Add API key. Задайте ключу имя (например, «AnythingMCP»), отметьте окружения, которые он может читать (как минимум master), и сохраните.
2. Скопируйте Space ID в CONTENTFUL_SPACE_ID, а Content Delivery API access token в CONTENTFUL_DELIVERY_TOKEN.
3. Укажите в CONTENTFUL_ENVIRONMENT id окружения, обычно master. Остальные окружения перечислены в Settings → Environments.
4. Укажите в CONTENTFUL_DELIVERY_URL адрес https://cdn.contentful.com, а для space в регионе данных ЕС https://cdn.eu.contentful.com, без косой черты в конце. Чтобы ИИ читал и черновики, используйте https://preview.contentful.com (или https://preview.eu.contentful.com) вместе с Content Preview API access token того же ключа.
5. Для записи создайте персональный токен доступа: меню аватара → Account settings → CMA tokens → Create personal access token. Выберите срок действия и сразу скопируйте токен: Contentful показывает его только один раз. Вставьте его в CONTENTFUL_MANAGEMENT_TOKEN без слова Bearer и укажите в CONTENTFUL_MANAGEMENT_URL адрес https://api.contentful.com (или https://api.eu.contentful.com). Токен действует от вашего имени во всех spaces, которые вы можете редактировать.
6. Если ваша организация должна одобрять персональные токены доступа, администратор организации открывает Organization settings, находит токен в настройках доступа для персональных токенов и предоставляет ему доступ. До этого инструменты записи отвечают 401 OrganizationAccessGrantRequired; чтение через delivery-токен это не затрагивает.
7. Установите коннектор и начните с contentful_get_space: он возвращает название space и его локали, это быстрая проверка того, что Space ID и delivery-токен подходят друг к другу.

Два токена, и это намеренно: delivery-токен читает только опубликованный контент (с preview-токеном ещё и черновики), поэтому коннектор, настроенный только с четырьмя обязательными значениями, может всё найти, но ничего не меняет. Запись, неопубликованные черновики, spaces и окружения идут через Content Management API с персональным токеном доступа. Если оставить CONTENTFUL_MANAGEMENT_URL и CONTENTFUL_MANAGEMENT_TOKEN пустыми, инструменты управления просто сообщат, что этих значений не хватает.

Публикация меняет ваш рабочий сайт: contentful_publish_entry и contentful_unpublish_entry меняют то, что посетители видят на вашем сайте или в приложении, поэтому ИИ называет запись и последствия и ждёт вашего «да». contentful_delete_entry при установке выключен, потому что удалённую запись нельзя восстановить.

Как работают изменения: contentful_list_content_types даёт id типов контента и полей, contentful_list_locales коды локалей. Значения полей хранятся по id поля, а внутри по локали, например {"title": {"en-US": "Hello"}}. Перед каждым изменением ИИ читает запись через contentful_get_entry_for_editing, чтобы получить её текущую sys.version; если кто-то сохранил запись в промежутке, Contentful отвечает 409 VersionMismatch, и ИИ читает её заново. contentful_update_entry заменяет все поля, и всё, что не передано, удаляется; для одного-двух полей ИИ использует contentful_patch_entry. Изменение появляется на сайте только после публикации новой версии.

Поиск: contentful_list_entries принимает content_type, полнотекстовый query и дополнительные фильтры, например fields.slug=hello или fields.date[gte]=2026-01-01. Для фильтрации или сортировки по полю нужен content_type. Связанные записи и ассеты возвращаются в includes, а URL ассетов начинаются с //, поэтому ИИ добавляет https:.

Пагинация: списки возвращают total, skip и limit (до 1000); следующая страница начинается с skip + limit.

Частые ошибки: 401 AccessTokenInvalid означает неверный или просроченный токен либо delivery-токен на preview-хосте (или наоборот). 404 NotFound означает неверный id либо space или окружение, к которым у токена нет доступа: здесь Contentful отвечает 404, а не 403. 400 «A Content Type ID is required» означает фильтр по полю без content_type. 422 ValidationFailed называет поле, которое пустое или нарушает правило валидации. 429 RateLimitExceeded: management API допускает около 7 запросов в секунду, подождите и повторите.

Коннектор не загружает ассеты, не создаёт и не редактирует типы контента, не управляет окружениями, вебхуками, ролями и приложениями и не использует GraphQL API.

Предварительные требования: CONTENTFUL_SPACE_ID, CONTENTFUL_ENVIRONMENT, CONTENTFUL_DELIVERY_URL, CONTENTFUL_DELIVERY_TOKEN

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите Contentful и введите переменные, перечисленные в Предварительных требованиях.

Доступные инструменты

Примеры запросов

• «Найди статьи блога, опубликованные за последние 30 дней, и перечисли заголовок, slug и автора каждой.»
• «В каких записях есть сохранённые, но ещё не опубликованные изменения?»
• «Перечисли изображения, загруженные в этом месяце, с размером файла и разрешением.»
• «Измени заголовок лендинга весенней распродажи на „Весенняя распродажа: скидка 20% на всё“ и опубликуй его после моего подтверждения.»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT