Подключение к серверам MCP

Добавьте сервер MCP в Claude Code, проверьте соединение и найдите конфигурацию на диске.

Model Context Protocol (MCP) позволяет Claude Code использовать инструменты, выходящие за рамки встроенного набора, такие как поиск в трекере проблем, запрос к базе данных или управление веб-браузером. Эти инструменты поступают от серверов MCP, которые работают на вашем компьютере или как размещённые сервисы.

Это руководство проведёт вас через подключение одного сервера MCP от начала до конца с помощью CLI Claude Code. К концу вы будете иметь подключённый и отвечающий сервер, узнаете, где находится его конфигурация на диске, и поймёте, как исправить наиболее распространённые ошибки соединения.

Для каждого способа подключения и настройки серверов MCP в Claude Code см. справочник MCP.

Перед началом

Убедитесь, что у вас есть:

• Claude Code установлен и аутентифицирован
• Открытый терминал в каталоге проекта. Подойдёт любой каталог, включая пустой.

Добавление и проверка сервера

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

Шаги одинаковы для любого сервера: добавьте его, проверьте статус соединения, затем используйте его в сеансе, с дополнительным шагом очистки в конце. Некоторые серверы добавляют шаг, например вход в браузер, показанный в Дополнительные примеры серверов MCP. Для большего количества серверов для подключения просмотрите Справочник Anthropic.

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

claude mcp list

claude

Use the claude-code-docs server to look up what MCP_TIMEOUT does

claude mcp remove claude-code-docs

Где сохраняются серверы

Команда claude mcp add записывает детали сервера в файл конфигурации. По умолчанию она регистрирует сервер в области local: приватно для вас, активно только в текущем проекте. Передайте --scope user для регистрации один раз для всех ваших проектов или --scope project для совместного использования с товарищами по команде. Изменение области сервера проходит через оба варианта.

Есть другие способы добавления сервера, каждый рассмотрен позже на этой странице:

• Добавление локального сервера: запустите программу на вашем компьютере вместо подключения к URL.
• Редактирование .mcp.json напрямую: напишите запись JSON самостоятельно вместо использования команды.
• Подключение сервера, требующего входа: добавьте размещённый сервер, который требует входа в браузер перед тем, как его инструменты будут работать.

Поиск вашей конфигурации на диске

Команда claude mcp add записывает сервер в одну из трёх областей, сохранённых в двух файлах, в зависимости от флага --scope. Вам не нужно редактировать эти файлы напрямую, но знание того, где они находятся, помогает при отладке и контроле версий.

На Windows ~/.claude.json разрешается в %USERPROFILE%\.claude.json, обычно C:\Users\YourName\.claude.json. Если вы установили CLAUDE_CONFIG_DIR, Claude Code читает .claude.json из этого каталога вместо этого.

Запустите claude mcp get claude-code-docs для просмотра того, какая область содержит определение сервера. Для того, как области взаимодействуют, когда один и тот же сервер определён в более чем одной, см. Области установки MCP.

Изменение области сервера

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

claude mcp remove claude-code-docs --scope local

Использование сервера во всех ваших проектах

Повторно добавьте сервер в области user, чтобы сделать его активным в каждом проекте, который вы открываете, оставаясь приватным для вас:

claude mcp add --scope user --transport http claude-code-docs https://code.claude.com/docs/mcp

Совместное использование сервера с вашей командой

Повторно добавьте сервер в области project, который записывает в .mcp.json в корне проекта:

claude mcp add --scope project --transport http claude-code-docs https://code.claude.com/docs/mcp

Зафиксируйте .mcp.json в контроле версий. Товарищи по команде, которые клонируют репозиторий и запускают Claude Code, видят приглашение одобрить сервер, затем он подключается и для них.

Дополнительные примеры серверов MCP

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

Добавление локального сервера

Локальный сервер stdio — это программа, которую Claude Code запускает как подпроцесс на вашем компьютере, а не сервис, к которому он обращается по URL. Используйте один для инструментов, которым требуется доступ к локальным ресурсам, таким как браузер, ваша файловая система или сокет базы данных.

Сервер Playwright MCP — хороший для попытки: он даёт Claude браузер, который он может навигировать, нажимать и читать, и он не требует учётной записи. Он работает через npx, поэтому требует Node.js 18 или позже.

claude mcp add playwright -- npx -y @playwright/mcp@latest

claude mcp list

Use playwright to open https://example.com and tell me the page title

Подключение сервера, требующего входа

Размещённые сервисы, такие как Sentry, Linear и Notion, запускают свои серверы MCP за OAuth: вы добавляете URL сервера, затем входите через ваш браузер.

Шаги ниже используют Sentry в качестве примера. Чтобы подключить другой сервис, замените его URL, который вы можете найти в Справочнике Anthropic или документации сервиса.

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

/mcp

Серверы, которые аутентифицируются со статическим токеном вместо OAuth, принимают токен во время добавления с --header "Authorization: Bearer <token>". См. пример GitHub для рабочей версии.

Редактирование .mcp.json напрямую

Каждый файл в таблице областей использует один и тот же формат JSON для записей сервера. Этот раздел редактирует .mcp.json, файл области проекта. Это тот, который наиболее стоит писать вручную, потому что он проверяется в репозитории, где он удваивается как конфигурация-как-код для вашей команды.

Создайте .mcp.json в корне вашего проекта. Пример ниже определяет оба сервера из этого руководства, размещённый сервер документации, доступный по HTTP, и сервер Playwright как локальный процесс stdio:

{
  "mcpServers": {
    "claude-code-docs": {
      "type": "http",
      "url": "https://code.claude.com/docs/mcp"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    }
  }
}

Поля отличаются по типу сервера:

• Для HTTP-серверов url — это конечная точка, к которой подключается Claude Code.
• Для серверов stdio command и args — это программа, которую он запускает.

После сохранения файла начните новый сеанс Claude Code в проекте. Claude Code читает .mcp.json при запуске.

В первый раз, когда Claude Code видит сервер в области проекта, он просит вас одобрить его. Приглашение существует, чтобы репозиторий, который вы клонируете, не мог запускать процессы на вашем компьютере без вашего согласия. Одобрите приглашение или запустите /mcp для одобрения позже, если вы его пропустили.

После одобрения запустите /mcp и проверьте, что серверы показаны как подключённые. Если один показывает ошибку вместо этого, см. Troubleshooting.

Подключение с других поверхностей

Это руководство использует команды CLI claude mcp, но каждая поверхность Claude Code может подключаться к серверам MCP:

• Настольное приложение Claude Code: добавляйте серверы через Connectors UI.
• Приложение Claude Desktop chat: отдельное приложение от Claude Code. Чтобы скопировать серверы из его claude_desktop_config.json в CLI, запустите claude mcp add-from-claude-desktop на macOS или WSL.
• VS Code: см. Подключение к внешним инструментам с MCP.
• Claude Code в веб-версии: читает .mcp.json из вашего репозитория. См. Редактирование .mcp.json напрямую.
• Claude.ai: коннекторы, которые вы добавляете в claude.ai/customize/connectors, загружаются автоматически в CLI, когда вы входите с этой учётной записью. См. Использование серверов MCP из Claude.ai.

Troubleshooting

Если сервер не подключается, проверьте его статус с /mcp внутри сеанса или claude mcp list из вашей оболочки, затем сопоставьте симптом ниже. Панель /mcp также позволяет вам переподключиться или аутентифицироваться без выхода из сеанса.

* Вы запустили `claude mcp add` из другого проекта. Серверы в области local привязаны к проекту, где вы их добавили: корень репозитория или точный каталог, если вы не были в репозитории git. Повторно добавьте сервер из проекта, в котором вы находитесь сейчас, или добавьте его с `--scope user`, чтобы он не был привязан к проекту.
* Вы отредактировали файл конфигурации по неправильному пути. Правильные файлы — это `~/.claude.json` и `<project>/.mcp.json`. Claude Code не читает пути, такие как `~/.claude/config/mcp.json`, `~/.claude/mcp.json` или `%APPDATA%\Claude\mcp.json`.

curl -I https://mcp.sentry.dev/mcp

npx -y @playwright/mcp@latest

MCP_TIMEOUT=60000 claude

$env:MCP_TIMEOUT = "60000"; claude

claude mcp remove claude-code-docs

claude mcp reset-project-choices

Следующие шаги

С одним подключённым сервером изучите остальное, что позволяет MCP:

• Найти больше серверов MCP в Справочнике Anthropic
• Совместное использование серверов с вашей командой с использованием областей установки
• Управление доступом MCP для организации с управляемыми параметрами и элементами управления политикой
• Справочные ресурсы MCP в запросах с упоминаниями @
• Запуск запросов MCP как команд из меню /
• Создайте свой собственный сервер с SDK MCP