Apollo MCP Server — MCP-сервер для Claude Code: GraphQL
Превращает операции GraphQL в инструменты, которые ИИ-агент вызывает напрямую. Пригодится, когда нужно дать модели доступ к вашему GraphQL API, а не описывать его словами.
claude mcp add apollo-mcp-server -- docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.0.0Что делает Apollo MCP Server
Сервер стоит между ИИ-клиентом и вашим GraphQL-графом: операции из файлов становятся инструментами, которые агент видит и вызывает по имени. Работает по Model Context Protocol, поэтому подключается к любому клиенту с поддержкой MCP.
Чтобы это заработало, нужно четыре вещи: граф, файл с определениями операций, конфигурация самого сервера и подключённый MCP-клиент. Без определения операций инструментов не появится — серверу просто нечего отдавать агенту. Проще всего запустить в контейнере: docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.0.0.
Собрать можно и из исходников, если на машине стоит Rust: cargo install --locked apollo-mcp-server. Флаг --locked берёт версии зависимостей, на которых выпускали релиз.
Какие задачи решает
- Дать агенту вызывать операции GraphQL вместо ручного описания схемы
- Превратить файл с запросами в набор MCP-инструментов
- Подключить GraphQL API к клиенту с поддержкой MCP
- Собрать сервер локально, когда контейнер не подходит
Примеры запросов агенту
- Подключи Apollo MCP Server к моему графу и покажи, какие инструменты появились
- Добавь операцию из
operations/getUser.graphqlв конфиг сервера - Проверь, что MCP-клиент видит инструменты из моего графа
Как установить Apollo MCP Server
Командой платформы
claude mcp add apollo-mcp-server -- docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.0.0Командой платформы
codex mcp add apollo-mcp-server -- docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.0.0Файл настроек
{
"mcpServers": {
"apollo-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/apollographql/apollo-mcp-server:v2.0.0"
]
}
}
}Файл настроек
{
"servers": {
"apollo-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/apollographql/apollo-mcp-server:v2.0.0"
]
}
}
}Командой платформы
gemini mcp add apollo-mcp-server docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.0.0По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apollo MCP Server
Как установить Apollo MCP Server в Claude Code?
Одной командой: claude mcp add apollo-mcp-server -- docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.0.0. Docker должен быть запущен, иначе контейнер не поднимется.
Что делает Apollo MCP Server?
Отдаёт операции GraphQL как MCP-инструменты, чтобы ИИ-модель могла обращаться к вашему API на Apollo и вызывать их по имени.
Что нужно настроить до запуска?
Граф, определения операций, которые станут инструментами, конфигурационный файл сервера и подключение MCP-клиента. Без операций список инструментов останется пустым.
