Интеграция Claude Code MCP: Подключение инструментов к агенту

Последнее обновление: June 28, 2026

Из коробки Claude Code читает и редактирует файлы и выполняет команды оболочки. Он не может читать ваши проблемы в GitHub, запрашивать вашу базу данных или управлять браузером. Model Context Protocol (MCP) устраняет этот пробел: это стандартный плагин, который позволяет агенту взаимодействовать с внешними инструментами и данными. В этом руководстве показаны точные команды claude mcp add, когда выбирать локальный или удаленный сервер, как работают области видимости (scopes), какие серверы стоит подключать и проверки безопасности, которые необходимо провести, прежде чем вы ему доверяете.

Быстрый ответ: как добавить сервер MCP в Claude Code?

Вы регистрируете сервер с помощью команды claude mcp add, после чего Claude Code может вызывать его инструменты во время сеанса.

Для локального сервера, который работает как процесс на вашей машине:

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

Для удаленного сервера, доступного по HTTPS:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

После добавления сервера выполните /mcp внутри Claude Code, чтобы увидеть статус подключения и завершить любую авторизацию OAuth. Используйте claude mcp list, чтобы подтвердить его регистрацию. Официальная справка по командам находится в Claude Code MCP docs.

Что такое MCP и почему его нужно подключать к Claude Code?

MCP — это открытый протокол, впервые опубликованный Anthropic, который определяет, как AI-клиент и сервер инструментов обмениваются возможностями. Сервер рекламирует инструменты (действия, которые может выполнить агент), ресурсы (данные, которые он может прочитать) и промпты. Любой клиент, осведомленный о MCP, может использовать любой сервер MCP, поэтому один сервер GitHub будет работать в Claude Code, IDE или другом агенте без дополнительного «клея». Спецификация и реестр серверов находятся по адресу modelcontextprotocol.io.

Практическая польза: вместо вставки содержимого задачи в чат вы подключаете сервер GitHub один раз и просите агента напрямую читать, помечать и отвечать на задачи. Для более глубокого понимания самого протокола см. наш MCP explainer, а для полного инструмента в контексте — Claude Code ultimate guide.

Сервером может быть крошечный скрипт stdio, который вы написали, образ Docker или конечная точка SaaS, размещенная поставщиком. Claude Code обрабатывает их все одинаково, как только они начинают говорить на языке MCP.

Какой транспорт использовать: локальный или удаленный?

Транспорт — это то, как Claude Code достигает сервера. Локальные серверы работают на вашей машине через stdio; удаленные серверы работают где-то еще и отвечают по протоколам HTTP или SSE. Выбор обычно зависит от того, где хранятся данные.

Используйте локальный stdio-сервер, когда инструменту нужны файлы или службы на вашем ноутбуке, например папка с ресурсами проекта или экземпляр Postgres на localhost. Используйте удаленный HTTP- или SSE-сервер, когда поставщик уже размещает его где-то, потому что вы пропускаете установку и получаете обновления, не трогая свою конфигурацию. Удаленные серверы почти всегда аутентифицируют вас через OAuth, который вы активируете из меню /mcp.

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

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

Установите область видимости с флагом --scope, например claude mcp add --scope project .... Область видимости проекта записывает зафиксированный .mcp.json, поэтому никогда не помещайте туда сырой токен; вместо этого ссылайтесь на переменную окружения. Локальная область видимости является настройкой по умолчанию и самым безопасным местом для тестирования нового сервера перед тем, как вы решите им делиться. Если вы также создаете Claude Code skills, сохраняйте согласованность между областью видимости сервера и областью видимости навыка, чтобы коллега, который клонирует репозиторий, получил рабочую настройку.

Как добавить сервер с помощью claude mcp add?

Шаблон одинаков для каждого сервера: имя, необязательный флаг транспорта и команда или URL. Разделитель -- отмечает начало локальной команды и ее аргументов.

Добавление локального файлового сервера, ограниченного одной папкой, чтобы агент мог работать только с тем, что вы разрешаете:

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

Передавайте секреты в качестве переменных окружения, а не жестко задавая их:

claude mcp add my-api --env API_KEY=your_key_here -- node ./my-mcp-server.js

Добавление удаленного сервера с его транспортом и URL:

claude mcp add --transport sse linear https://mcp.linear.app/sse

Затем управляйте тем, что у вас есть:

• claude mcp list показывает каждый зарегистрированный сервер и его статус.
• claude mcp get <name> выводит конфигурацию одного сервера.
• claude mcp remove <name> отрегистрирует его.
• /mcp (введенный в сессии) показывает состояние активного подключения и выполняет OAuth.

Придерживайтесь использования флагов согласно официальной документации; поставщики иногда меняют имя пакета или URL сервера, поэтому копируйте текущее значение из собственного файла README сервера, а не догадывайтесь.

Распространенные серверы MCP, которые стоит подключить

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

Playwright MCP server выделяется для фронтенд-работы: агент открывает вашу страницу, проходит по потоку кликов и сообщает о сбоях со скриншотом. Сервер базы данных удобен для вопросов к схеме только для чтения, но ограничьте его до реплики только для чтения, чтобы случайный запрос никогда не мог записать данные. Когда вы начинаете связывать несколько серверов вместе, направляйте тяжелую работу на выделенного воркера с помощью Claude Code subagents, чтобы основная сессия оставалась отзывчивой.

Сценарий: подключение сервера GitHub MCP для открытия PR

Предположим, вы хотите, чтобы агент обрабатывал проблемы (issues) и открывал pull requests в одном репозитории. GitHub размещает официальный удаленный сервер MCP, поэтому вам не нужно ничего устанавливать локально.

1. Регистрация размещенного сервера:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

2. Введите /mcp в Claude Code, выберите github и завершите вход через OAuth в браузере. Токен остается у GitHub; вам никогда не придется вставлять его в файл.

3. Подтвердите загруженные инструменты с помощью claude mcp list.

4. Теперь задайте вопрос на обычном языке:

• "Перечислить открытые проблемы с меткой bug и обобщить три лучшие."
• "Открыть черновик PR из fix/login-redirect в main с кратким описанием."
• "Прочитать PR #214 и отметить все, что касается аутентификации."

Агент читает ветки проблем, составляет тело PR и связывает нужную проблему — и все это без выхода из терминала. Сначала предоставьте приложению GitHub доступ только к одному репозиторию, просмотрите то, что предлагает агент, и расширяйте доступ только тогда, когда вы уверены в процессе. Полный список инструментов сервера и опция самохостинга описаны в GitHub MCP server repo.

Безопасно ли подключать сервер MCP?

Сервер MCP может выполнять код на вашей машине или действовать от имени ваших учетных записей, поэтому относитесь к каждому из них как к установке зависимости: подключайте только те серверы, которым доверяете. Риск реален, поскольку вредоносный или ошибочный сервер может эксфильтровать файлы или предпринять разрушительные действия с вашими учетными данными.

Пройдите по этому контрольному списку перед добавлением сервера:

• Подтвердите источник. Предпочитайте официальные серверы поставщиков (GitHub, Sentry) или опубликованные эталонные серверы, а не неизвестный пакет.
• Проверьте, какие инструменты он предоставляет. Сервер «прочитать мои проблемы» не должен запрашивать права на запись ко всему вашему диску.
• Ограничьте область действия. Направляйте файловые серверы на одну папку проекта, а серверы баз данных — на реплику чтения.
• Храните секреты вне .mcp.json. Используйте переменные окружения и никогда не коммитьте реальный токен.
• Предоставляйте минимальные привилегии при использовании OAuth. Давайте приложению GitHub один репозиторий, а не всю вашу организацию (org), пока вы ему не доверяете.
• Просматривайте действия перед утверждением. Прочитайте предлагаемый PR или запрос агента; не одобряйте автоматически записи от нового сервера.

Anthropic отмечает риск внедрения запросов (prompt-injection) для серверов, которые извлекают недоверенный веб-контент, поэтому будьте особенно осторожны с любым сервером, который подтягивает произвольные страницы. Текущее руководство по безопасности находится в Claude Code MCP docs.

Устранение неполадок с подключениями MCP

Большинство сбоев связаны с конфигурацией или аутентификацией, а не с протоколом. Выполните следующие шаги в указанном порядке:

• Сервер не указан: повторно выполните claude mcp list. Если он отсутствует, команда add, вероятно, завершилась неудачей; проверьте опечатку в разделителе -- или в названии пакета.

• Статус показывает «failed» в /mcp: процесс не смог запуститься. Для серверов stdio выполните исходную команду (например, строку npx) в терминале, чтобы увидеть реальную ошибку.

• Ошибка аутентификации: откройте /mcp, выберите сервер и повторите процесс OAuth. Для серверов на основе токенов убедитесь, что переменная окружения установлена в оболочке, запустившей Claude Code.

• Инструменты не отображаются: перезапустите сеанс Claude Code, чтобы он загрузил возможности сервера, а затем проверьте, что область видимости (scope) видна текущему проекту.

• Неправильная область видимости (scope): сервер, добавленный с --scope local, не будет виден для товарищей по команде; передобавьте его с --scope project, если он должен быть общим.

Когда удаленный сервер меняет свой URL или пакет переименовывается, ваша сохраненная конфигурация становится устаревшей. Извлеките текущее значение из файла README сервера и передобавьте его, вместо того чтобы редактировать вслепую.

Ключевой вывод

MCP превращает Claude Code из агента, работающего с файлами и оболочкой, в агент, который взаимодействует с вашими реальными инструментами. Добавляйте серверы с claude mcp add, выбирайте stdio для локальных данных и HTTP/SSE для размещенных сервисов, а также устанавливайте область видимости в зависимости от того, кто должен видеть сервер. Сначала подключите один полезный сервер; сервер GitHub — это сильный старт, и проверьте источник и разрешения каждого сервера, прежде чем доверять ему. Храните токены в переменных окружения, ограничивайте доступ к файловой системе и базе данных узко, и просматривайте действия агента, пока новый сервер не заслужит доверие.