COMRAD404 / HOWTO

Как подключить MCP (Model Context Protocol) к Claude

Пошаговая инструкция по подключению MCP к Claude двумя официальными способами: локально в Claude Desktop через Extensions или config-файл и удалённо через custom connector с проверкой через Connectors и логи.

Понадобится

Точное время не указано в источниках; зависит от способа подключения
  • Аккаунт Claude
  • Claude Desktop для локального MCP-сценария
  • Пакет расширения или документация вашего локального MCP-сервера, если он не ставится из каталога
  • Публично доступный MCP-сервер для remote custom connector
  • Доступ владельца к Organization settings, если вы добавляете коннектор для Team или Enterprise

После выполнения этой инструкции вы подключите MCP к Claude одним из двух официальных способов: локально через Claude Desktop или удалённо через custom connector. В результате вы сможете проверить, что сервер и его tools появились в меню Connectors, а для локального сценария — дополнительно подтвердить это через логи Claude Desktop.

Короткий ответ: если MCP-сервер запускается на вашем компьютере, используйте Claude Desktop и путь Settings > Extensions либо ручную настройку через claude_desktop_config.json. Если сервер уже доступен по URL и должен открываться из облака Anthropic, подключайте его как remote custom connector через Customize > Connectors > + > Add custom connector.

  • Время: точное время в официальных источниках не указано; зависит от того, используете ли вы локальный или удалённый сценарий.
  • Сложность: средняя.
  • Стоимость: зависит от вашего тарифа Claude. По официальной справке remote custom connectors доступны на Free, Pro, Max, Team и Enterprise, при этом на Free действует лимит в один custom connector. Актуальные цены проверяйте отдельно.
  • Что потребуется: аккаунт Claude; для локального сценария — Claude Desktop; для remote MCP — публично доступный MCP-сервер; для Team/Enterprise — доступ владельца, если вы добавляете коннектор на уровне организации.
  • Актуальность: шаги сверены по официальным руководствам Anthropic и MCP на 2026-08-17. Текущий подтверждённый релиз спецификации MCP — 2026-07-28. Ограничение: в источниках нет единого номера версии интерфейса Claude, поэтому ориентируйтесь на названия разделов из официальной справки.

Какой способ подключения выбрать

Сценарий Где доступен Официальный путь Когда выбирать Что считать успехом
Локальный MCP Claude Desktop Settings > Extensions > Browse extensions > Install или Advanced settings > Extension Developer > Install Extension; для ручной настройки — claude_desktop_config.json Когда сервер работает на вашем компьютере В Connectors видны сервер и tools; при необходимости это подтверждается в логах
Remote MCP Claude, Cowork, Claude Desktop Customize > Connectors > + > Add custom connector; для Team/Enterprise владельцы могут использовать Organization settings > Connectors Когда сервер опубликован по публичному интернету и должен быть доступен из облака Anthropic Коннектор появляется в Connectors

MCP — это открытый протокол для подключения LLM-приложений к внешним источникам данных, инструментам и рабочим процессам. Если хотите быстро освежить базу по термину, посмотрите MCP (Model Context Protocol). Практический вердикт: если вам нужен самый прямой путь, начните с локального подключения в Claude Desktop. К remote MCP переходите, когда сервер уже опубликован и должен работать не только с вашим локальным приложением. Редакционное ограничение: официальные источники подтверждают точки входа, пути файлов и проверку, но не дают универсальный JSON-шаблон для любого сервера, поэтому содержимое claude_desktop_config.json нужно брать из документации именно вашего MCP-сервера.

Пошагово: как подключить MCP к Claude

  1. Определите тип подключения.

    Выберите локальный MCP, если сервер запускается на вашем компьютере и вы работаете в Claude Desktop. Выберите remote MCP, если сервер доступен по публичному интернету и его нужно подключить в Claude, Cowork или Claude Desktop.

    Ожидаемый результат: вы понимаете, какой из двух официальных путей ниже вам нужен, и не смешиваете локальную и удалённую схему.

  2. Для локального сценария откройте каталог расширений в Claude Desktop.

    Перейдите в Settings > Extensions > Browse extensions и нажмите Install у нужного расширения. Это актуальный официальный путь для каталожных desktop extensions.

    Ожидаемый результат: расширение устанавливается в Claude Desktop и готово к появлению в Connectors.

  3. Если у вас есть пакет .mcpb, установите его через режим разработчика расширений.

    Откройте Advanced settings > Extension Developer > Install Extension и выберите пакет .mcpb. Этот путь нужен не для всех серверов, а только для тех, которые распространяются как готовый пакет расширения.

  4. Если ваш локальный сервер настраивается вручную, откройте claude_desktop_config.json.

    Используйте точный путь для вашей ОС и вставьте конфигурацию, которую даёт документация именно вашего сервера. Источники подтверждают расположение файла, но не дают универсального содержимого для всех серверов.

    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%Claudeclaude_desktop_config.json
  5. Полностью перезапустите Claude Desktop после любой локальной установки или правки конфига.

    Это обязательное действие для локального сценария: после изменений Claude Desktop нужно закрыть и открыть заново, иначе сервер может не появиться в приложении.

    Ожидаемый результат: после повторного запуска Claude Desktop подхватывает установленное расширение или обновлённый конфиг.

  6. Проверьте локальное подключение через меню Connectors.

    В Claude Desktop нажмите + и откройте Connectors. По официальной инструкции здесь должны отображаться подключённые серверы и доступные tools. Если результат неочевиден, дополнительно проверьте Developer settings и логи Claude Desktop.

    Ожидаемый результат: вы видите установленный MCP-сервер и связанные tools в Connectors либо диагностические записи в логах.

  7. Для удалённого сценария добавьте custom connector.

    В Claude, Cowork или Claude Desktop откройте Customize > Connectors > + > Add custom connector. Если вы на Team или Enterprise и добавляете коннектор для организации, используйте путь Organization settings > Connectors.

    Ожидаемый результат: открывается форма добавления удалённого коннектора.

  8. Завершите настройку удалённого MCP и авторизацию.

    Заполните данные, которые запрашивает Claude для вашего сервера, и завершите OAuth, если он используется. Критическое условие: remote MCP должен быть доступен из облака Anthropic по публичному интернету. Если сервер находится только в приватной сети, за VPN или за firewall, подключение не сработает без allowlist IP-адресов Anthropic.

  9. Проверьте удалённый коннектор через Connectors.

    После добавления откройте Connectors и убедитесь, что коннектор появился в списке. Для базовой верификации этого достаточно: официальные материалы Anthropic предлагают проверять наличие подключения через Connectors, а в локальном сценарии ещё и через логи.

    Ожидаемый результат: удалённый коннектор отображается в Claude как доступное подключение.

Как проверить, что всё работает

  • Локальный MCP в Claude Desktop: нажмите +, откройте Connectors и убедитесь, что видите сервер и tools.
  • Локальный MCP после ручной конфигурации: если сервер не появился, откройте Developer settings и логи Claude Desktop и ищите ошибки загрузки или запуска.
  • Remote MCP: после добавления коннектора откройте Connectors и проверьте, что он отображается как подключённый.
  • Если вы работаете в нескольких поверхностях Claude: Anthropic отдельно указывает, что connectors работают across Claude, Claude Desktop, Claude Code и API через MCP Connector, но конкретный способ первоначального подключения зависит от выбранного сценария выше.

Частые ошибки и исправления

  • Ошибка: после установки локального расширения сервер не появляется в Claude Desktop. Решение: полностью перезапустите Claude Desktop. Официальные материалы прямо требуют полный restart после правок локальной конфигурации.
  • Ошибка: вы редактируете не тот файл локальной конфигурации. Решение: используйте точный путь: ~/Library/Application Support/Claude/claude_desktop_config.json на macOS или %APPDATA%Claudeclaude_desktop_config.json на Windows.
  • Ошибка: remote MCP не подключается из Claude, хотя сервер доступен из вашей локальной сети. Решение: проверьте, что сервер действительно доступен по публичному интернету из облака Anthropic. Приватная сеть, VPN и firewall не подойдут без allowlist IP-адресов Anthropic.
  • Ошибка: на Free не удаётся добавить ещё один custom connector. Решение: официально для Free указан лимит в один custom connector.
  • Ошибка: названия пунктов меню в вашем приложении чуть отличаются от увиденных в статье. Решение: это рабочее ограничение rollout: в источниках нет единого номера версии интерфейса Claude, поэтому сверяйте актуальный путь по официальной справке Anthropic.

Безопасность и ограничения

  • MCP предназначен для подключения Claude к внешним источникам данных, инструментам и рабочим процессам. Перед подключением проверьте, какой именно сервер вы добавляете и каким системам он открывает доступ.
  • Desktop extensions в официальной документации Claude Desktop поддерживают Node.js, Python и binary MCP servers. Для Node.js-сценариев отдельная установка Node.js не требуется, потому что в Claude Desktop есть встроенная Node.js runtime.
  • Remote custom connectors работают только если сервер доступен по публичному интернету из облака Anthropic.
  • Цены и лимиты по планам в этой статье не фиксируются: источники подтверждают доступность remote MCP на Free, Pro, Max, Team и Enterprise и лимит Free в один custom connector, но отдельную pricing page нужно проверять перед внедрением.
  • Если вы ищете публичные серверы через MCP Registry, учитывайте, что официальный registry всё ещё находится в preview, поэтому формат и данные могут меняться или сбрасываться до GA.
  • Редакционное ограничение: в исходниках нет единого номера версии приложения Claude и нет универсального примера claude_desktop_config.json для всех MCP-серверов. Эта инструкция надёжно покрывает официальные точки входа, файлы и проверку, но содержимое конкретного server config нужно брать из документации самого сервера.

Что делать дальше

Источники

Вопросы и ответы

Можно ли подключить MCP только в Claude Desktop?

Нет, но сценарии различаются. Desktop extensions для локального MCP доступны всем пользователям Claude Desktop. Remote custom connectors официально доступны в Claude, Cowork и Claude Desktop. Отдельно Anthropic указывает, что web connectors доступны пользователям Claude, Cowork, Claude Desktop и Claude Mobile.

Нужно ли отдельно устанавливать Node.js для локального MCP?

Для desktop extensions отдельная установка Node.js не требуется: в Claude Desktop есть встроенная Node.js runtime. При этом официально поддерживаются Node.js, Python и binary MCP servers.

Где находится файл claude_desktop_config.json?

На macOS — ~/Library/Application Support/Claude/claude_desktop_config.json. На Windows — %APPDATA%Claudeclaude_desktop_config.json.

Почему remote MCP не работает через VPN или внутреннюю сеть компании?

Потому что remote custom connector должен быть доступен из облака Anthropic по публичному интернету. Приватная сеть, VPN или firewall не подходят без allowlist IP-адресов Anthropic.

Сколько custom connectors можно добавить на Free?

По официальной справке для Free действует ограничение в один custom connector. Если лимиты меняются, проверяйте актуальную справку и pricing отдельно.

Шаги

HOW-TO
  1. Определите тип подключения

    | Выберите локальный MCP для Claude Desktop или remote MCP для сервера, доступного по публичному интернету.

  2. Откройте каталог локальных расширений

    | В Claude Desktop перейдите в Settings > Extensions > Browse extensions и нажмите Install у нужного расширения.

  3. Установите пакет .mcpb при необходимости

    | Если сервер распространяется как пакет, откройте Advanced settings > Extension Developer > Install Extension и выберите .mcpb.

  4. Откройте claude_desktop_config.json для ручной настройки

    | При ручной конфигурации используйте точный путь файла для macOS или Windows и вставьте конфиг из документации вашего сервера.

  5. Полностью перезапустите Claude Desktop

    | После любой локальной установки или правки конфига закройте и заново откройте приложение.

  6. Проверьте локальное подключение

    | Нажмите +, откройте Connectors и убедитесь, что сервер и tools появились; при необходимости смотрите Developer settings и логи.

  7. Добавьте remote custom connector

    | В Claude, Cowork или Claude Desktop откройте Customize > Connectors > + > Add custom connector; для Team/Enterprise владельцы могут использовать Organization settings > Connectors.

  8. Завершите настройку и проверьте доступность remote MCP

    | Заполните данные, завершите авторизацию и убедитесь, что сервер доступен из облака Anthropic по публичному интернету.

  9. Проверьте remote connector через Connectors

    | Откройте Connectors и убедитесь, что удалённый коннектор появился в списке доступных подключений.

Источники

SOURCES

Вопросы и ответы

FAQ
Можно ли подключить MCP только в Claude Desktop?

Нет, но сценарии различаются. Локальные desktop extensions доступны в Claude Desktop. Remote custom connectors официально доступны в Claude, Cowork и Claude Desktop.

Нужно ли отдельно устанавливать Node.js для локального MCP?

Нет, для desktop extensions отдельная установка Node.js не требуется: в Claude Desktop есть встроенная Node.js runtime. Официально поддерживаются Node.js, Python и binary MCP servers.

Где находится claude_desktop_config.json?

На macOS — ~/Library/Application Support/Claude/claude_desktop_config.json. На Windows — %APPDATA%Claudeclaude_desktop_config.json.

Почему remote MCP не работает через VPN или внутреннюю сеть?

Потому что remote custom connector должен быть доступен из облака Anthropic по публичному интернету. Приватная сеть, VPN или firewall не подходят без allowlist IP-адресов Anthropic.

Сколько custom connectors можно добавить на Free?

По официальной справке для Free действует ограничение в один custom connector.

Читайте также

LINKS