Добавление MCP-серверов в Claude Code

Claude Code подключает серверы командой claude mcp add или из файла .mcp.json в корне репозитория.

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

Файл проекта

.mcp.json

Ключ верхнего уровня

mcpServers

Формат

json

OAuth для удалённых серверов

●Да

Пример конфигурации

В этом примере добавлены размещённый сервер GitHub и Playwright в качестве локального сервера — в формате, который ожидает этот клиент.

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

Примечания и особенности

• Настройки для локальной области (по умолчанию) и области пользователя хранятся в ~/.claude.json; настройки для проекта — в .mcp.json.
• Для каждой записи с url также нужно указать type, например http; запись только с url вызовет ошибку.
• В файле раскрываются значения ${VAR} и ${VAR:-default}.
• Чтобы войти на OAuth-серверы, выполните /mcp в сеансе. Для предварительно зарегистрированных OAuth-приложений передайте --client-id, --client-secret и --callback-port.

Создать конфигурацию Claude Code →

Другие клиенты