Подключение MCP-сервера в Claude Code

В Claude Code серверы подключают командой в терминале, не в окне Claude Code. Всё, что стоит после двух дефисов, — команда запуска локального сервера.

Claude Code хранит серверы в трёх областях: только для вас в этом проекте, для всех участников проекта через .mcp.json и для вас во всех проектах.

Локальный сервер#

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

# с переменной окружения
claude mcp add godot -e GODOT_PATH=/opt/godot/godot -- npx @coding-solo/godot-mcp

# свой сервер на Python SDK
claude mcp add catalog -- uv run --with "mcp[cli]" mcp run /абсолютный/путь/server.py

Удалённый сервер#

В версиях Claude Code 2.1.1 и новее удалённый сервер удобно добавлять описанием в JSON:

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer ВАШ_ТОКЕН"}}'

В более старых версиях — так:

claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer ВАШ_ТОКЕН"

Если сервер поддерживает OAuth, заголовок не нужен: Claude Code предложит войти через браузер.

Области видимости#

Таблица: Ключ --scope | Область | Где действует | Где хранится | |---|---|---| | local (по умолчанию) | Только у вас и только в текущем проекте | Ваши настройки Claude Code | | project | У всех, кто работает с проектом | Файл .mcp.json в корне проекта | | user | У вас во всех проектах | Ваши настройки Claude Code |

claude mcp add --scope project playwright -- npx @playwright/mcp@latest

Проверка#

claude mcp list
claude mcp get playwright

Внутри сеанса Claude Code команда /mcp показывает, к каким серверам есть подключение и какие у них инструменты.

Если что-то не так#

• В Windows команда claude mcp add-json для HTTP-сервера иногда отвечает Invalid input — используйте прежний формат с --transport http.
• Если команда запуска сервера не находится, укажите её полный путь.
• Остальное — в разделе «Частые ошибки».