Как подключить MCP-серверы к Claude Desktop

Удаленные серверы: добавление пользовательского коннектора

Откройте Claude Desktop, перейдите в Settings, затем в Connectors, и нажмите Add custom connector. Задайте имя, вставьте URL сервера и подтвердите. Пользовательские коннекторы для удаленного MCP доступны на тарифах Free, Pro, Max, Team и Enterprise; на Free-аккаунте можно добавить только один такой коннектор. На тарифах Team и Enterprise владелец организации сначала добавляет коннектор в настройках организации, а участники затем включают его на своей странице Connectors.

Серверы с поддержкой OAuth при первом обращении попросят войти и подтвердить разрешения в браузере - больше ничего не требуется. Необязательный раздел Advanced settings принимает client ID и secret для OAuth на серверах, которым нужен заранее зарегистрированный клиент, но большинству публичных серверов это не требуется. Для сервера HostTracker URL - https://mcp.host-tracker.com/mcp; он использует OAuth с динамической регистрацией клиента, поэтому коннектор хранит только те разрешения, которые вы подтвердили, и вставлять ключ не нужно.

Коннекторы работают на стороне Anthropic, а не на вашей машине, поэтому не могут достучаться до сервера в вашей локальной сети, и это тот же механизм, что используют claude.ai и Cowork. Файл конфигурации, о котором пойдет речь дальше, - его локальный аналог.

Локальные серверы: редактирование claude_desktop_config.json

Откройте Settings, выберите вкладку Developer и нажмите Edit Config. Откроется файл конфигурации в вашем редакторе, а если его еще нет - он будет создан. На macOS файл лежит по пути ~/Library/Application Support/Claude/claude_desktop_config.json, на Windows - по пути %APPDATA%\Claude\claude_desktop_config.json; в Linux-бете лучше воспользоваться кнопкой Edit Config, а не угадывать путь самостоятельно. Каждый сервер - это запись в разделе mcpServers с командой запуска и ее аргументами:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Сохраните файл, затем полностью закройте Claude Desktop и запустите заново; просто закрыть окно недостаточно, потому что серверы запускаются при старте приложения. На Windows среда выполнения, от которой зависит команда, например Node.js для npx, должна быть установлена и находиться в PATH, который видит десктопное приложение, поэтому если сервер работает в терминале, но не из приложения - обычно дело именно в разнице PATH.

Чтобы убедиться, что сервер загрузился, нажмите на значок "Add files, connectors, and more" внизу слева от поля сообщения, наведите на Connectors и откройте Manage connectors; сервер будет показан там вместе со своими инструментами. В более старой документации этот значок называют значком молотка, и на странице устранения неполадок это название еще встречается в одном из заголовков.

Расширения из каталога

Раздел Settings, затем Extensions, затем Browse extensions показывает подобранный каталог локальных серверов, упакованных как расширения: они устанавливаются одним кликом и обновляются сами. Скачанный пакет устанавливается через Install Extension выбором файла; такие пакеты используют формат .mcpb, который пришел на смену более раннему названию .dxt, и могут оборачивать серверы на Node.js, Python или в виде бинарников. Пакеты, распространяемые частным образом, не обновляются автоматически и после изменений их приходится переустанавливать вручную.

Где искать логи, если ничего не появляется

Claude Desktop ведет общий лог подключений и отдельный лог для каждого сервера. На macOS они находятся в ~/Library/Logs/Claude/ как mcp.log и mcp-server-NAME.log; на Windows - в %APPDATA%\Claude\logs. В файле конкретного сервера собран его собственный вывод ошибок - там будет видно отсутствующий модуль, неверный путь или отклоненные учетные данные. Если файл пуст, значит приложению вообще не удалось запустить команду, и причину стоит искать в PATH или в синтаксической ошибке JSON в файле конфигурации.

Одно приложение, две поверхности

Сейчас Claude Desktop включает вкладку Code, которая запускает Claude Code прямо внутри приложения, рядом со вкладкой Chat. Серверы, описанные в claude_desktop_config.json, доступны и в чате, и в локальных сессиях вкладки Code, наравне с серверами из ~/.claude.json и файла .mcp.json проекта; если одно и то же имя встречается в нескольких местах, вкладка Code использует определение из десктопного файла. Отдельная консольная версия Claude Code файл десктопного приложения не читает. Если серверы уже настроены в десктопном приложении и их нужно перенести в терминал, команда claude mcp add-from-claude-desktop импортирует их на macOS и в Windows Subsystem for Linux, как описано в руководстве о добавлении MCP-сервера в Claude Code.

Удаленный сервер мониторинга как первый коннектор

Удаленный сервер - самый быстрый способ убедиться, что процесс подключения коннектора работает: устанавливать ничего не нужно, а ответ легко проверить. Добавьте сервер HostTracker как пользовательский коннектор, войдите, когда будет предложено, и спросите Claude, доступен ли знакомый вам сайт; в ответе должна быть ссылка на проверку, выполненную из названных контрольных точек HostTracker, а не догадка. На странице MCP-сервера перечислены все 65 инструментов и разрешения, нужные каждому из них, от мгновенных проверок до обновлений страниц статуса.