Как подключить MCP-сервер
Чтобы подключить MCP-сервер, найдите в его документации команду запуска или адрес, подготовьте окружение и токен, добавьте сервер в конфиг или командой в клиенте, перезапустите клиент и проверьте, что инструменты видны. Ниже — порядок и форматы для Claude Desktop, Claude Code, Cursor, VS Code, Codex и opencode.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Общий порядок для любого клиента
Подключение MCP-сервера почти везде сводится к четырём шагам.
- Выберите сервер и откройте его карточку или README. Найдите там команду запуска (для локального сервера) или адрес (для удалённого) и список того, что нужно заранее: Node.js, Python и
uv, Docker, токен сервиса. - Подготовьте окружение и доступ. Поставьте нужную среду выполнения и выпустите токен с минимальными правами, если сервер работает с аккаунтом.
- Добавьте сервер в клиент: строкой в конфиге или командой в терминале. Секреты подставляйте в переменные окружения или в поле заголовков и не храните их в файлах, которые попадают в git.
- Перезапустите клиент и проверьте, что сервер подключился и видны его инструменты. Затем дайте ассистенту простую задачу, которая требует вызова инструмента.
Если вы ещё не разобрались, что такое сервер, клиент и инструмент, начните со страницы что такое 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.
{
"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 для ИИ-ассистента.
Figma MCP Server
Официальный удалённый MCP-сервер Figma: код по макетам, переменные, Code Connect и запись в макет.
MCP for Blender
MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.