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

Курс: MCP: подключаем инструменты — https://zero2claude.ru/learn/mcp
Канонический URL: https://zero2claude.ru/learn/mcp/2-1-gde-konfiguraciya

Файл .mcp.json: где он лежит, как устроена одна запись сервера и почему проектный конфиг можно коммитить в репозиторий.

Прежде чем подключать инструменты, полезно знать, где 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` не должно быть токенов и паролей в открытом виде — иначе они утекут в репозиторий. Как передавать секреты правильно, разберём в уроке про переменные окружения.