Где живёт конфигурация MCP

Прежде чем подключать инструменты, полезно знать, где Claude Code хранит список MCP-серверов. Это обычный текстовый файл, и читать его ты умеешь.

Проектный файл .mcp.json

Конфигурация серверов живёт в файле .mcp.json в корне проекта. Он текстовый, в формате JSON, и его можно открыть любым редактором или вывести в терминал:

cat .mcp.json

Если файла нет — значит, к этому проекту ещё не подключён ни один сервер. Это нормально: файл появится, когда ты добавишь первый.

Как выглядит одна запись

Внутри лежит словарь mcpServers, где у каждого сервера есть имя и способ запуска. Локальный сервер (транспорт stdio) описывается командой и аргументами:

{
  "mcpServers": {
    "tracker": {
      "command": "npx",
      "args": ["-y", "tracker-mcp-server"]
    }
  }
}

Имя tracker — это как ты называешь сервер для себя. command и args — чем Claude Code его запустит.

Проектный или пользовательский

.mcp.json в корне проекта — общий: его можно закоммитить в репозиторий, и тогда коллеги получат те же серверы. Личные настройки (например, только для тебя) хранятся в пользовательском конфиге Claude Code, отдельно от проекта.