# mcp-server

Связывает проект Kontent.ai с ИИ-редактором: типы контента, таксономии, ассеты и языковые версии правятся через естественный язык.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9
- Автор: kontent-ai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/kontent-ai/mcp-server
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/kontent-ai-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`.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `KONTENT_API_KEY`, `KONTENT_ENVIRONMENT_ID`, `PORT` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- завести типы контента из схемы, нарисованной в диаграмме
- найти контент по смыслу, когда точных ключевых слов нет
- создать языковую версию материала и назначить контрибьютора
- переименовать и разложить папки ассетов
- посмотреть, где используется конкретный тип контента

## Примеры запросов агенту
- Покажи все типы контента в проекте и скажи, где используется тип `article`
- Создай новый тип контента `blog-post` с полями заголовок и тело
- Найди материалы про доставку и покажи их черновики

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

## Другие версии с тем же именем
- [mcp-server · heyputer](https://affpapa.org/nevibecode/mcp/mcp-server.md) — ★ 43872
- [mcp-server · mapbox](https://affpapa.org/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/nevibecode/mcp/ui5-mcp-server.md) — ★ 104

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md