Как настроить MCP в Claude Code: серверы и конфиг

MCP, Model Context Protocol, это способ дать Claude Code доступ к внешним инструментам: файлам, репозиториям, базе, API. Подключается командой claude mcp add или правкой конфига. После добавления сервер появляется в /mcp, а его инструменты агент вызывает сам, когда они нужны.

Что такое MCP простыми словами

MCP-сервер это маленькая программа, которая умеет отдавать Claude инструменты и данные. Например, сервер filesystem даёт агенту читать и писать файлы за пределами проекта, сервер github работать с pull request, сервер postgres ходить в базу. Claude Code выступает клиентом: он запускает сервер, получает от него список инструментов и зовёт их по ходу задачи.

Шаг 1. Добавить сервер

# stdio-сервер (локальный процесс):
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /home/me/work

# http-сервер (удалённый):
claude mcp add --transport sse myapi https://example.com/mcp

Команда прописывает сервер в конфиг текущего проекта. Первый аргумент имя, дальше команда запуска самого сервера.

Шаг 2. Конфиг вручную

То же самое можно задать в файле .mcp.json в корне проекта:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/me/work"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..." }
    }
  }
}

Шаг 3. Проверить, что сервер жив

claude
/mcp
filesystem   ✓ connected   (8 tools)
github       ✓ connected   (11 tools)

Если сервер красный или failed, инструмент не работает. Сначала чиним подключение, потом задаём задачу.

Когда MCP реально полезен

Частые ошибки

• failed при /mcp: сервер не установлен (нет npx/node) или путь в args кривой.
• 401 от github: невалидный или просроченный токен в env.
• Тяжёлый контекст: слишком много серверов с длинными описаниями инструментов.

Токены, которые расходуют MCP-инструменты, удобно гонять через реселлерский API CLOD с оплатой рублём.

Частые вопросы