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

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

Что нужно знать о сервере#

Таблица: Два вида серверов | | Локальный | Удалённый | |---|---|---| | Что указать клиенту | Команду запуска и её аргументы | Адрес, обычно с окончанием /mcp | | Транспорт | stdio | Streamable HTTP | | Вход | Обычно не нужен; ключи передают в переменных окружения | OAuth в браузере или токен в заголовке Authorization | | Пример | npx @playwright/mcp@latest | https://mcp.atlassian.com/v2/mcp |

Команду или адрес берите из документации сервера. В каталоге MCP-серверов они вынесены в карточку каждого сервера.

Порядок подключения#

Найдите настройки клиента. У каждого клиента свой файл или своя команда — ссылки ниже.
Добавьте сервер. Для локального — команду, аргументы и переменные окружения, для удалённого — адрес и, если нужно, заголовки.
Перезапустите клиент. Многие клиенты читают настройки только при запуске; Claude Desktop нужно закрыть полностью, а не только окно.
Проверьте список инструментов. В клиенте должен появиться сервер и его инструменты.
Разрешайте вызовы осознанно. Клиент спросит согласие перед вызовом инструмента. Постоянное разрешение давайте только инструментам, которые ничего не меняют.

Форматы настроек#

Таблица: Где клиенты хранят список серверов | Клиент | Где | Ключ | Руководство | |---|---|---|---| | Claude Desktop | claude_desktop_config.json | mcpServers | Claude Desktop | | Claude Code | команда claude mcp add или .mcp.json | mcpServers | Claude Code | | Cursor | ~/.cursor/mcp.json или .cursor/mcp.json | mcpServers | Cursor | | VS Code | .vscode/mcp.json | servers | VS Code | | OpenCode | opencode.json | mcp | OpenCode |

Самый распространённый формат — объект mcpServers. Так выглядит локальный сервер:

Локальный сервер в формате mcpServers

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": { "PLAYWRIGHT_BROWSERS_PATH": "/opt/browsers" }
    }
  }
}

А так — удалённый в Cursor и других клиентах, которые принимают поле url:

Удалённый сервер в формате mcpServers

{
  "mcpServers": {
    "atlassian": { "url": "https://mcp.atlassian.com/v2/mcp" }
  }
}

Где хранить ключи#

Не вписывайте ключи в файлы, которые попадают в репозиторий: .mcp.json, .vscode/mcp.json, .cursor/mcp.json в папке проекта.
Передавайте ключ через переменную окружения (env для локального сервера) или используйте подстановку, если клиент её поддерживает: в VS Code — ${input:…} с запросом пароля, в OpenCode — {env:ИМЯ}.
Если удалённый сервер поддерживает OAuth, выбирайте вход через браузер, а не постоянный токен: доступ можно отозвать, а токен живёт недолго.

Как проверить сервер без клиента#

MCP Inspector — официальное приложение, которое запускает сервер и показывает его инструменты, ресурсы и шаблоны. Удобно, чтобы отделить ошибки сервера от ошибок настройки клиента:

Запуск MCP Inspector для локального сервера

npx @modelcontextprotocol/inspector npx @playwright/mcp@latest

Удалённый сервер на соответствие ревизии 2026-07-28 можно проверить бесплатной проверкой справочника.

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

Таблица: Признаки и причины | Признак | Причина | Что сделать | |---|---|---| | Сервер не запускается, в журнале ENOENT или «command not found» | Клиент не находит npx, uvx или python: он запускает сервер с урезанной переменной PATH | Укажите полный путь к команде (which uvx на macOS и Linux, where uvx в Windows) | | В Windows не запускается npx | Команду нужно запускать через оболочку | "command": "cmd", "args": ["/c", "npx", …] | | Сервер запускается и сразу отключается | Сервер пишет журнал в стандартный вывод и ломает обмен | Писать журнал только в stderr; для чужого сервера — сообщить автору | | Файл или папка «не найдены» | Относительный путь: клиент запускает сервер из своей рабочей папки | Только абсолютные пути | | Удалённый сервер отвечает 401 | Нужен вход или токен | Пройти вход в браузере или добавить заголовок Authorization | | В инструкции адрес оканчивается на /sse | Устаревший транспорт HTTP+SSE | Взять у поставщика адрес Streamable HTTP; если его нет, нужен клиент, который ещё поддерживает SSE | | Инструментов слишком много, модель путается | Сервер открывает десятки инструментов | Отключить лишние в настройках клиента или сервера (у многих серверов есть группы инструментов) |