Как добавить MCP-сервер в Claude Code

Добавление удаленного сервера по HTTP

Удаленный сервер - это просто URL. Claude Code общается с ним по протоколу streamable HTTP, поэтому вся регистрация умещается в одну строку:

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp

Первый аргумент после транспорта - это имя, под которым сервер будет виден в /mcp и в названиях инструментов; второй - адрес эндпоинта. Серверам, которые используют аутентификацию через OAuth, больше ничего в командной строке не нужно: при первом открытии /mcp выберите сервер, и Claude Code откроет браузер для входа и подтверждения доступа, а затем сохранит полученный токен и будет обновлять его сам. Начиная с версии 2.1.186 вход можно выполнить и без интерактивной сессии, командой claude mcp login hosttracker, а на машине без браузера добавьте --no-browser, чтобы получить ссылку для перехода из другого места.

Серверы, которые ожидают статический токен, принимают его как заголовок:

claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Некоторые старые серверы до сих пор используют транспорт SSE. Он считается устаревшим в пользу HTTP, и начиная с Claude Code 2.1.265 флаг --transport http сначала пробует HTTP, а при отказе сервера переключается на SSE, так что указывать --transport sse вручную теперь почти не требуется.

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

Локальный сервер - это программа, которую Claude Code запускает сам и с которой общается через стандартный ввод и вывод. Поместите ее команду и аргументы после двойного дефиса, чтобы собственные флаги Claude Code не перепутались с флагами сервера:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects

Переменные окружения, нужные серверу, передаются через --env (короткая форма -e), по одной на каждую переменную. Есть один задокументированный нюанс: парсер опций считает все, что идет после --env KEY=value, следующей парой, поэтому не ставьте имя сервера сразу после этого флага - вставьте между ними другую опцию либо разместите --env перед --transport:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

Если конфигурация сервера уже есть у вас в виде JSON, например из его README, команда claude mcp add-json <name> '<json>' принимает ее как есть, вместе с type, command, args и env.

Выбор области: этот проект, команда или везде

По умолчанию сервер добавляется в локальной области - только для этого проекта, и запись хранится в вашем собственном ~/.claude.json. Есть еще две области:

• --scope project записывает запись в файл .mcp.json в корне репозитория. Закоммитьте его - и тот же сервер получит каждый участник команды; при первом запуске Claude Code попросит каждого подтвердить его.
• --scope user делает сервер доступным во всех проектах на вашей машине, оставаясь приватным лично для вас.

Если одно и то же имя встречается сразу в нескольких областях, локальная область побеждает область проекта, а область проекта побеждает область пользователя. Вся запись целиком берется из выигравшей области, поля из разных областей никогда не смешиваются. Разумное разделение - --scope user для сервисов, привязанных к вашему личному аккаунту, например сервера мониторинга или системы заявок, и --scope project для инструментов, которые должна использовать вся команда.

Проверка работоспособности

Выполните claude mcp list вне сессии. Для каждого сервера будет выведен один из нескольких статусов: подключен, требуется аутентификация, не удалось подключиться (с кодом HTTP или текстом ошибки, начиная с версии 2.1.219), ожидает подтверждения для неподтвержденного сервера проекта, либо отключен для этого проекта. Внутри сессии команда /mcp показывает те же серверы вместе с числом их инструментов, позволяет запустить вход для того, которому он нужен, сбросить его аутентификацию или отключить сервер для текущего проекта, не удаляя его совсем.

Быстрая функциональная проверка - это запрос, ответить на который может только сам сервер. Когда подключен сервер HostTracker, спросите "какие из моих мониторов сейчас недоступны?" или "запусти HTTP-проверку example.com из трех локаций"; ассистент должен вызвать инструмент, названный по имени сервера, и привести результат, которого не мог знать заранее. Если ничего не происходит, причина обычно в списке инструментов: /mcp покажет ноль инструментов для сервера, который подключился, но не прошел авторизацию.

Удаление, просмотр и импорт

Команда claude mcp get <name> выводит полную конфигурацию и область одного сервера. claude mcp remove <name> удаляет его вместе со всеми сохраненными токенами OAuth. Если серверы уже настроены в Claude Desktop, команда claude mcp add-from-claude-desktop импортирует их в интерактивном режиме; она работает на macOS и в Windows Subsystem for Linux, но не на обычном Windows или обычном Linux, и пропускает сервер Desktop, чье имя содержит символы, недопустимые в Claude Code (разрешены только буквы, цифры, дефисы и подчеркивания).

Сервер мониторинга как первая проверка

Сервис мониторинга - хороший выбор для первого подключаемого сервера, потому что результат вызова инструмента сразу можно проверить: ассистент говорит, что сайт доступен, и вы можете открыть его и убедиться сами. Сервер HostTracker не требует локальной установки, проходит аутентификацию через OAuth в браузере и открывает доступ к мгновенным проверкам из 300 с лишним локаций, а также к мониторам, инцидентам, окнам обслуживания и страницам статуса вашего аккаунта, так что на вопрос "работает ли прод?" ответ приходит с реальных контрольных точек, а не из обучающих данных. О формате файла, переменных окружения и типичных сбоях читайте в руководстве по настройке .mcp.json.