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

Чтобы подключить MCP-сервер, найдите в его документации команду запуска или адрес, подготовьте окружение и токен, добавьте сервер в конфиг или командой в клиенте, перезапустите клиент и проверьте, что инструменты видны. Ниже — порядок и форматы для Claude Desktop, Claude Code, Cursor, VS Code, Codex и opencode.

Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026

Общий порядок для любого клиента

Подключение MCP-сервера почти везде сводится к четырём шагам.

  1. Выберите сервер и откройте его карточку или README. Найдите там команду запуска (для локального сервера) или адрес (для удалённого) и список того, что нужно заранее: Node.js, Python и uv, Docker, токен сервиса.
  2. Подготовьте окружение и доступ. Поставьте нужную среду выполнения и выпустите токен с минимальными правами, если сервер работает с аккаунтом.
  3. Добавьте сервер в клиент: строкой в конфиге или командой в терминале. Секреты подставляйте в переменные окружения или в поле заголовков и не храните их в файлах, которые попадают в git.
  4. Перезапустите клиент и проверьте, что сервер подключился и видны его инструменты. Затем дайте ассистенту простую задачу, которая требует вызова инструмента.

Если вы ещё не разобрались, что такое сервер, клиент и инструмент, начните со страницы что такое MCP-сервер.

Что нужно заранее

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

  • npx — для серверов на JavaScript и TypeScript. Нужен Node.js: команда npx ставится вместе с ним. Проверить можно командой node --version.
  • uvx — для серверов на Python. Нужен менеджер пакетов uv. Ставьте его официальным установщиком: при установке через pip команда uvx может не появиться там, где её ищет клиент.
  • docker — для серверов в контейнере. Нужен установленный и запущенный Docker. Такой способ хорош тем, что сервер изолирован от остальной системы.

Некоторые серверы распространяются как готовый исполняемый файл: тогда в конфиге указывается полный путь к нему. Серверам для программ вроде Blender, Unity или 1С обычно нужна ещё и часть внутри самой программы: дополнение, пакет или обработка.

Токены и права

Если сервер работает с аккаунтом (GitHub, Figma и другие), ему нужен токен или вход через OAuth. Выпускайте отдельный токен для каждого сервера и давайте ему только нужные права: например, только чтение и только нужные репозитории. Ставьте срок действия токена, чтобы забытый ключ не работал вечно. Если сервер умеет работать в режиме только для чтения, начните с него.

Локальный или удалённый сервер

Локальный сервер клиент запускает сам. В конфиге указываются команда и аргументы, например npx -y пакет, uvx пакет или docker run …. Такой сервер работает с вашими правами и видит то же, что и вы на этом компьютере.

Удалённый сервер уже работает в сети, в конфиге указывается его адрес. Вход обычно идёт через OAuth в браузере или по токену в заголовке Authorization. Если клиент поддерживает только локальные серверы, к удалённому можно подключиться через мост вроде mcp-remote.

Как подключить в популярных клиентах

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

Откройте Settings → Developer → Edit Config. Файл лежит в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS, в %APPDATA%\Claude\claude_desktop_config.json на Windows и в ~/.config/Claude/claude_desktop_config.json на Linux.

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

После сохранения полностью закройте и снова откройте приложение. В конфиге Claude Desktop описываются локальные серверы; удалённые добавляются как коннекторы в настройках.

Как проверить подключение

  • Claude Code: claude mcp list показывает статус каждого сервера, claude mcp get имя — подробности, а команда /mcp внутри сессии — список подключённых серверов.
  • Cursor: статус и инструменты видны в настройках MCP, логи — в панели Output, пункт MCP Logs.
  • Codex: codex mcp list в терминале или /mcp в интерфейсе.
  • Claude Desktop: список коннекторов в меню у поля ввода, логи — в ~/Library/Logs/Claude на macOS и %APPDATA%\Claude\logs на Windows.

После этого дайте ассистенту задачу, которую без сервера не решить, и посмотрите, вызвал ли он инструмент. Ответ без вызова инструмента подключение не подтверждает.

Частые ошибки

Ошибка Причина Что сделать
spawn npx ENOENT или spawn uvx ENOENT Клиент, запущенный из меню, не видит команду Укажите полный путь к команде или запустите клиент из терминала
Сервер не появляется Ошибка в JSON или клиент не перезапущен Проверьте синтаксис файла и полностью перезапустите клиент
Ошибка авторизации Неверный или просроченный токен, мало прав Выпустите новый токен с нужными правами
Инструменты есть, но не вызываются Модель не поняла, что нужен инструмент Назовите сервер или инструмент прямо в запросе
На Windows не запускается npx Особенности запуска команд Используйте cmd с аргументами /c npx …

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

Перед подключением откройте репозиторий сервера и посмотрите, кто его поддерживает, когда были последние изменения и какая у проекта лицензия. Прочитайте список инструментов: если среди них есть выполнение кода или удаление данных, работайте с копией проекта или базы. Не отключайте подтверждение вызовов в клиенте, пока не убедились, что сервер ведёт себя предсказуемо. В карточках нашего каталога всё это собрано в разделе «Риски».

С чего начать

Если хотите попробовать на чём-то понятном, возьмите сервер под инструмент, с которым работаете каждый день: GitHub MCP Server для кода, Figma MCP Server для вёрстки, MCP for Blender для 3D или mcp-1c для 1С.

Частые вопросы

Можно ли подключить несколько MCP-серверов сразу?

Да. Каждый сервер — отдельная запись в конфиге с уникальным именем. Подключайте только нужные: инструменты занимают место в контексте модели.

Где хранить токены для серверов?

В переменных окружения или в настройках клиента для секретов. Не храните их в общих конфигах вроде .mcp.json, которые попадают в git.

Почему сервер работает в одном клиенте и не работает в другом?

У клиентов разные форматы конфигов и разные поддерживаемые транспорты. Например, в конфиге Claude Desktop описываются только локальные серверы.

Нужно ли перезапускать клиент после правки конфига?

Обычно да. Claude Desktop нужно закрыть полностью, а не только окно.

Рекомендованные серверы

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Figma MCP Server

Официальный удалённый MCP-сервер Figma: код по макетам, переменные, Code Connect и запись в макет.

Риск: high Лицензия: NOASSERTION ★ 2 209

MCP for Blender

MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.

Риск: high Лицензия: MIT ★ 34 950