1. Возьмите установочные данные у сервера

    Нужны точный MCP URL для HTTP либо исполняемая команда с аргументами для stdio. Уточните, требуются ли ключ, OAuth и доступ к файлам или сети.

  2. Добавьте удалённый сервер

    Для Streamable HTTP используйте форму claude mcp add --transport http <имя> <URL_MCP>. Замените оба плейсхолдера данными выбранного сервера. Если сервер локальный, переходите к следующему шагу вместо этой команды.

    Shell
    claude mcp add --transport http <имя> <URL_MCP>

  3. Или добавьте локальный сервер

    Для stdio команда начинается после разделителя --: claude mcp add --transport stdio <имя> -- <команда> <аргументы>. Эти плейсхолдеры не являются готовым пакетом; используйте только команду издателя. Секрет для локального процесса можно передать через --env или окружение с учётом риска хранения в конфигурации.

    Shell
    claude mcp add --transport stdio <имя> -- <команда> <аргументы>

  4. Проверьте область и статус

    По умолчанию запись относится к текущему локальному проекту; --scope project делает общий .mcp.json, --scope user — личную запись. Выполните claude mcp list и claude mcp get <имя>; внутри Claude Code откройте /mcp. Для проектного файла подтвердите доверие к серверу после проверки его конфигурации.

  5. Войдите и сделайте пробный запрос

    Если /mcp сообщает о необходимости входа, завершите OAuth в этом клиенте. Выберите один инструмент чтения и проверьте ответ по известному исходному значению.

Что проверить

  • Для HTTP-записи в .mcp.json нужен type: http; один url без type Claude Code считает ошибкой конфигурации.
  • Команда add подтверждает сохранение записи; реальную связь показывают list, get и /mcp.
  • Секреты не помещайте в общий .mcp.json проекта.