Где живёт конфигурация 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, отдельно от проекта.

Важно

В .mcp.json не должно быть токенов и паролей в открытом виде — иначе они утекут в репозиторий. Как передавать секреты правильно, разберём в уроке про переменные окружения.

Практика в терминале

Проверь это руками в тренажёре ниже: в корне проекта уже лежит скрытый .mcp.json. Найди его через ls -a, выведи содержимое командой cat и рассмотри запись сервера tracker внутри словаря mcpServers.

Проверь себя

Отвечено 0/3

Режим:

Где по умолчанию хранится конфигурация MCP-серверов проекта?

Почему проектный .mcp.json удобно коммитить в репозиторий?

Что описывает запись сервера с командой и args в .mcp.json?

Вопросы и ответы по уроку

Где по умолчанию хранится конфигурация MCP-серверов проекта?

Серверы проекта описаны в текстовом файле .mcp.json в корне проекта; его можно прочитать обычным cat.