mcp-server · kontent-ai — MCP-сервер для Claude Code: работа с Kontent.ai
Связывает проект Kontent.ai с ИИ-редактором: типы контента, таксономии, ассеты и языковые версии правятся через естественный язык.
claude mcp add --env KONTENT_API_KEY=<KONTENT_API_KEY> --env KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> --env PORT=<PORT> --transport stdio kontent-ai-mcp-server -- npx -y @kontent-ai/mcp-serverЧто делает mcp-server
Сервер реализует Model Context Protocol и даёт агенту доступ к Management API Kontent.ai. Через него можно перечислять и создавать типы контента, сниппеты, группы таксономии, ассеты и папки ассетов. Для контентных единиц есть отдельный набор инструментов: контейнер, языковые варианты, переводы, черновики и публикация.
Правки типов и таксономий идут через patch-операции — move, addInto, remove, replace. Перед любым патчем сервер требует вызвать get-patch-guide: без него агент не знает допустимых операций для конкретного типа сущности, и запрос сорвётся. Поиск по вариантам контента работает семантически, но фильтров там мало — только по ID варианта.
Запускается двумя транспортами: npx @kontent-ai/mcp-server@latest stdio или npx @kontent-ai/mcp-server@latest shttp. Чтобы всё заработало, нужны аккаунт Kontent.ai, проект, Management API key с подходящими правами и Environment ID. Ключ и ID передаются переменными окружения KONTENT_API_KEY и KONTENT_ENVIRONMENT_ID.
Какие задачи решает
- завести типы контента из схемы, нарисованной в диаграмме
- найти контент по смыслу, когда точных ключевых слов нет
- создать языковую версию материала и назначить контрибьютора
- переименовать и разложить папки ассетов
- посмотреть, где используется конкретный тип контента
Примеры запросов агенту
- Покажи все типы контента в проекте и скажи, где используется тип
article - Создай новый тип контента
blog-postс полями заголовок и тело - Найди материалы про доставку и покажи их черновики
Как установить mcp-server
Командой платформы
claude mcp add --env KONTENT_API_KEY=<KONTENT_API_KEY> --env KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> --env PORT=<PORT> --transport stdio kontent-ai-mcp-server -- npx -y @kontent-ai/mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add kontent-ai-mcp-server --env KONTENT_API_KEY=<KONTENT_API_KEY> --env KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> --env PORT=<PORT> -- npx -y @kontent-ai/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"kontent-ai-mcp-server": {
"command": "npx",
"args": [
"-y",
"@kontent-ai/mcp-server"
],
"env": {
"KONTENT_API_KEY": "<KONTENT_API_KEY>",
"KONTENT_ENVIRONMENT_ID": "<KONTENT_ENVIRONMENT_ID>",
"PORT": "<PORT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"kontent-ai-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kontent-ai/mcp-server"
],
"env": {
"KONTENT_API_KEY": "<KONTENT_API_KEY>",
"KONTENT_ENVIRONMENT_ID": "<KONTENT_ENVIRONMENT_ID>",
"PORT": "<PORT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KONTENT_API_KEY=<KONTENT_API_KEY> -e KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> -e PORT=<PORT> kontent-ai-mcp-server npx -y @kontent-ai/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-server
Как установить mcp-server в Claude Code?
Выполните claude mcp add mcp-server -e KONTENT_API_KEY=<KONTENT_API_KEY> -e KONTENT_ENVIRONMENT_ID=<KONTENT_ENVIRONMENT_ID> -- npx -y @kontent-ai/mcp-server. Подставьте свой Management API key и Environment ID.
Что делает mcp-server?
Даёт ИИ-агенту инструменты для работы с проектом Kontent.ai: типы контента, сниппеты, таксономии, ассеты и контентные единицы с их языковыми вариантами.
Что нужно для работы сервера?
Аккаунт Kontent.ai, проект, Management API key с нужными правами и Environment ID. Без ключа и ID сервер не подключится к проекту.
Похожие MCP-серверы
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Сначала — mcp-server от других авторов.
