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

Данные на 22.10.2026, 21:50 МСК · цены в ₽ за 1M токенов

MCP (Model Context Protocol) это open-source стандарт, через который харнесс агента (Claude Code, Cursor, Codex) подключает внешние инструменты и данные. MCP-сервер это программа, которая отдаёт агенту набор инструментов: базу, браузер, трекер, документацию. Сервер запускают локально командой (stdio) или подключают по URL (HTTP). В Claude Code это команда claude mcp add, в Cursor файл mcp.json. Готовые серверы собраны в каталоге aishlyuz.ru/mcp-servery.

Что такое MCP-сервер простыми словами

В MCP три участника. Хост это харнесс, в котором работает агент: Claude Code, Cursor, Codex. Клиент живёт внутри хоста и держит соединение с сервером. Сервер описывает свои инструменты (tools), ресурсы и промпты, а агент сам решает, какой инструмент вызвать.

Сообщения идут в формате JSON-RPC. Спецификация описывает два стандартных транспорта: stdio и Streamable HTTP. Полный текст на modelcontextprotocol.io/specification.

Зачем MCP агенту

Без MCP вы копируете в чат задачу из трекера, лог из мониторинга и схему базы. С MCP агент берёт это сам:

• читает задачу в трекере и закрывает её после PR;
• делает запрос в базу и проверяет миграцию на реальных данных;
• открывает страницу в браузере и смотрит консоль;
• подтягивает актуальную документацию библиотеки, а не ту, что была в обучении модели.

Вот это реально полезно: контекст агент находит сам, вы проверяете результат.

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

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

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

Синтаксис ниже сверен с документацией Claude Code, Cursor и Codex на 22.10.2026. В примерах один и тот же удалённый сервер https://mcp.example.com/mcp и один локальный, Context7.

В Claude Code

Удалённый сервер:

claude mcp add --transport http example https://mcp.example.com/mcp \
  --header "Authorization: Bearer $EXAMPLE_TOKEN"

Локальный сервер. Всё после -- это команда запуска сервера:

claude mcp add --transport stdio context7 -- npx -y @upstash/context7-mcp

Список серверов: claude mcp list, один сервер: claude mcp get example. В сессии то же показывает /mcp. Модели для Claude Code настраиваются отдельно от MCP, это в статье Claude Code из России.

В Cursor

Конфиг лежит в .cursor/mcp.json в проекте или в ~/.cursor/mcp.json для всех проектов:

{
  "mcpServers": {
    "example": {
      "url": "https://mcp.example.com/mcp",
      "headers": { "Authorization": "Bearer ${env:EXAMPLE_TOKEN}" }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

${env:ИМЯ} подставляет переменную окружения, так ключ не попадает в репозиторий. Про модели в Cursor со своим ключом есть статья Cursor со своим API-ключом.

В Codex и других харнессах

Codex хранит MCP в ~/.codex/config.toml или в .codex/config.toml проекта. Локальный сервер добавляется командой:

codex mcp add context7 -- npx -y @upstash/context7-mcp

Удалённый с ключом из переменной окружения проще описать в конфиге:

[mcp_servers.example]
url = "https://mcp.example.com/mcp"
bearer_token_env_var = "EXAMPLE_TOKEN"

Проверка: codex mcp list, в интерфейсе Codex команда /mcp. Для серверов с OAuth codex mcp login example. Как запустить сам Codex, в статье Codex из России. Другие харнессы обычно понимают тот же формат mcpServers с command или url, сравнение в статье нейросети в Cursor и Claude Code.

Пример: наш сервер aishlyuz.ru/mcp

Наш MCP удалённый, адрес https://aishlyuz.ru/mcp, заголовок Authorization: Bearer sk-ais-…. Ключ тот же, что для моделей в кабинете AIShlyuz, схема в статье один API-ключ для всех нейросетей:

claude mcp add --transport http aishlyuz https://aishlyuz.ru/mcp

Без заголовка Claude Code и Cursor откроют OAuth: вы входите в кабинет и разрешаете доступ. Агент видит пять мета-инструментов (search_tools, get_tool_schema, execute_tools, manage_connections, read_result) и через них находит нужный, не забивая контекст. Подробно в статье MCP-сервер в Claude Code и Cursor, список инструментов на /mcp.

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

claude mcp list пишет статус рядом с каждым сервером:

• ✔ Connected: сервер на связи, инструменты доступны;
• ! Needs authentication: нужен вход, запустите /mcp в сессии или claude mcp login <имя>;
• ✘ Failed to connect: Claude Code не достучался до сервера.

При Failed to connect проверяем URL, ключ в заголовке и то, что локальная команда вообще запускается из терминала. Повторить подключение всех упавших серверов: /mcp reconnect all. Финальная проверка простая: попросите агента вызвать инструмент и посмотрите на ответ.

Где взять MCP-серверы

• Эталонные серверы от авторов протокола (Filesystem, Git, Fetch, Memory, Time) лежат в репозитории modelcontextprotocol/servers.
• В нашем каталоге MCP-серверов десятки проверенных MCP-инструментов. У каждой карточки транспорт (stdio или http), метка «Официальный» и команда установки. Эти серверы ставятся отдельно и со своим ключом сервиса.
• Шлюзы для нескольких серверов сразу: Docker MCP Gateway, для баз данных Google MCP Toolbox.

Бесплатный ли сервер, смотрите в карточке и в лицензии репозитория: open-source код бесплатен, а сервис за ним может быть платным.

Безопасность MCP

MCP-сервер действует от вашего имени: читает данные, вызывает API, локальный сервер ещё и выполняет код на вашей машине. Что проверяем перед установкой, по документации Cursor:

• источник: ставим серверы от вендора сервиса или из известного репозитория;
• права: какие данные и API сервер получит;
• ключи: отдельный ключ с минимальными правами под каждый сервер, на чтение там, где запись не нужна;
• код: для серверов с доступом к деньгам, проду и персональным данным читаем исходники.

Ключи держим в переменных окружения (${env:…} в Cursor, bearer_token_env_var в Codex), а не в mcp.json в репозитории. Спецификация требует от HTTP-серверов проверять заголовок Origin, а локальным серверам советует слушать только 127.0.0.1. Если пишете свой сервер, это первое, что стоит сделать.

Как написать свой MCP-сервер

Официальные SDK есть для Python, TypeScript и других языков, список на modelcontextprotocol.io/docs/sdk. Сервер пишет агент: дайте ему задачу вида «MCP-сервер на Python с инструментом X, готово, когда claude mcp list показывает Connected и инструмент отвечает». Подключили командой из раздела выше, вызвали инструмент, поправили по факту.

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