MCP-серверы для Claude Code

Конфигурация Model Context Protocol, которая действительно полезна, и подводные камни, отнимающие немало времени.

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

.mcp.json, который стоит использовать

Copy{
  "mcpServers": {
    "filesystem": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]},
    "git":        {"command": "uvx", "args": ["mcp-server-git", "--repository", "."]},
    "github":     {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"],
                   "env": {"GITHUB_TOKEN": "..."}},
    "fetch":      {"command": "uvx", "args": ["mcp-server-fetch"]},
    "playwright": {"command": "npx", "args": ["-y", "@playwright/mcp@latest"]}
  }
}

Поместите его в корень репозитория; Claude Code обнаружит его и один раз запросит подтверждение доверия.

Подводные камни

• Запрос подтверждения доверия — полезная функция. Claude Code не загружает MCP-серверы проекта, пока вы не одобрите их для этого проекта. Это граница безопасности, а не ошибка.
• Назначьте серверу базы данных роль только для чтения. MCP-сервер выполняет любой SQL, который выдаёт модель; роль только для чтения делает сгенерированную по ошибке команду DROP физически невыполнимой.
• Ограничивайте права токенов. Для GitHub repo и read:org достаточно. Не передавайте ему классический PAT со всеми правами.
• Вывод MCP входит в контекст. Результат из 200 строк или полностью загруженная страница отправляются повторно при каждом следующем ходе. Большие объёмы вывода инструментов — главная причина высокой стоимости агентных сессий.