К содержимому
Блог

MCP-сервер: что это, как подключить к Claude Code и чем он опасен

MCP-сервер: что это, как подключить к Claude Code и чем он опасен

Если коротко, MCP-сервер это маленькая программа, которая показывает ИИ-приложению ваши файлы, базы и внешние сервисы по единым правилам. Модель сама ничего не запускает: она просит вызвать инструмент, а клиент вроде Claude Code идёт на сервер и приносит ответ. Ниже путь одного вызова, подключение к Claude Code, роль шлюза Relay и правила для чужих серверов.

Коротко

  • MCP (Model Context Protocol) задаёт общие правила, по которым клиент находит у сервера инструменты, ресурсы и готовые промпты.

  • В Claude Code сервер добавляет одна команда claude mcp add, проверяет claude mcp list.

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

  • Всё, что вернул инструмент, попадает в промпт и уходит поставщику модели.

Как проходит один вызов

Протокол Anthropic опубликовала 25 ноября 2024 года, назвав его открытым стандартом связи между ИИ-приложениями и источниками данных. Ролей три. Хост это приложение вроде Claude Code. Клиент живёт внутри хоста, и на каждый сервер заводится свой. Сервер отдаёт возможности. Обмен идёт сообщениями JSON-RPC 2.0 по одному из двух транспортов: stdio (хост порождает сервер дочерним процессом) или Streamable HTTP (сервер доступен по адресу), как описано в разделе об архитектуре в документации протокола.

Что происходит, когда вы просите «найди в заметках всё про платежи»:

ШагКто действуетЧто происходит
1Claude Codeотправляет модели ваш запрос и описания инструментов всех подключённых серверов
2Модельотвечает просьбой вызвать конкретный инструмент с аргументами
3Claude Codeвызывает этот инструмент на нужном MCP-сервере
4MCP-сервервыполняет действие и возвращает текст или данные
5Claude Codeкладёт результат в контекст и снова обращается к модели

Возможности бывают трёх видов: инструменты (то, что модель вызывает как функцию), ресурсы (данные, которые подкладывают в контекст) и промпты (готовые шаблоны запросов). Практичное правило для своих серверов: всё, что пишет или удаляет, оформляйте инструментом, а чтение отдавайте ресурсом. Тогда клиент сразу показывает, где риск.

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

Достаточно одной команды. Двойной дефис в ней отделяет параметры самого claude от строки, которой запускается сервер (так описано в документации Claude Code про MCP).

bash
claude mcp add <имя> -- <команда> [аргументы]
claude mcp add --transport http <имя> <url>
claude mcp list

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

ОбластьГде хранитсяКто видит
local (по умолчанию)~/.claude.json, привязка к проектутолько вы
project.mcp.json в корне проектався команда через git
user~/.claude.jsonвы, во всех проектах

Серверы из области project Claude Code, по описанию вендора, запускает только после вашего одобрения в интерактивной сессии, так что присланный кем-то .mcp.json сам не заведётся. Для локального сервера запись выглядит так:

json
{
  "mcpServers": {
    "notes": {
      "command": "uv",
      "args": ["--directory", "/абсолютный/путь/к/notes-mcp", "run", "server.py"]
    }
  }
}

Для удалённого сервера вместо command и args в записи указывают type со значением http и поле url.

Claude Code через Relay

MCP шлюзу не мешает. Серверы настраиваются и стартуют на вашей машине, а запросы к модели уходят по адресу из переменных окружения. Для Relay это адрес https://relay-llm.ru без /v1: клиенты Anthropic дописывают путь сами (формат Messages).

bash
export ANTHROPIC_BASE_URL=https://relay-llm.ru
export ANTHROPIC_AUTH_TOKEN="$RELAY_API_KEY"
export ANTHROPIC_MODEL=claude-sonnet-5-5
claude

Полный набор переменных, включая модели для субагентов, лежит в руководстве по Claude Code. Поля тела запроса вроде tools шлюз передаёт модели без изменений, поэтому описания MCP-инструментов доходят в том виде, в каком их собрал клиент. Поддержку конкретных параметров определяет сама модель, а в каталоге у всех текстовых моделей отмечена работа с инструментами.

Claude Sonnet 5.50,52 $ за 1 млн входных токенов

Что при этом уходит к провайдеру

Описания инструментов и результаты вызовов становятся частью промпта. Если сервер прочитал файл с паролями, текст файла ушёл модели. По странице безопасности, Relay не хранит тексты запросов и ответов: они проходят к поставщику модели, и тот получает их целиком. В журнале остаются модель, число токенов, стоимость и время, записи живут 90 дней.

Есть и денежная сторона. Описания инструментов едут в каждом запросе сессии и считаются входными токенами, поэтому пять подключённых серверов с длинными описаниями заметно утяжеляют каждый шаг агента. Для агентной работы заведите отдельный ключ: суточный лимит расходов, лимит запросов в минуту и список моделей задаются на каждый ключ. Как читать списания, описано в разделе про оплату.

Свой сервер: короткий маршрут

  1. Возьмите официальный SDK на Python или TypeScript из организации modelcontextprotocol на GitHub.

  2. Опишите одну функцию как инструмент: имя, типизированные аргументы и ясное описание. Его читает модель, и по нему она решает, когда вызывать.

  3. Запустите сервер по stdio и проверьте инструмент руками в MCP Inspector, пока ИИ не подключён.

  4. Только потом добавляйте его командой claude mcp add с абсолютными путями.

На старте ловят три ошибки. В stdio-сервере нельзя печатать в стандартный вывод: он занят сообщениями JSON-RPC, один лишний print рвёт соединение, логи пишите в stderr. Имена и пути, которые приходят от модели, нужно проверять: строка с .. иначе выйдет за пределы разрешённой папки. И сверяйте синтаксис с версией SDK: по данным вендора на 29 октября 2026, в Python SDK 2.x класс сервера называется MCPServer, а в старых примерах встречается FastMCP.

Чужие серверы: что проверить до запуска

Локальный сервер работает с теми же правами, что и ваш пользователь. Раздел security best practices на сайте протокола называет угрозы прямо: произвольные команды, потеря данных, вредоносная строка запуска, спрятанная в конфиге.

РискЧто делать
Вредоносная команда запускапрочитать её целиком, npx ... && curl ... в одной строке повод остановиться
Лишние правасначала подключать серверы только для чтения, а запись добавлять позже отдельным шагом
Утечка ключейпередавать секреты через переменные окружения, не коммитить .mcp.json с токеном
Подсунутые инструкции в чужом контентене давать серверу, который тянет чужие страницы, права на запись и удаление

Референсные серверы лежат в репозитории modelcontextprotocol/servers, но по его README это учебные примеры, не рассчитанные на продакшен.

MCP-сервер бесплатный?

Протокол и SDK открыты. Платить придётся за то, к чему сервер ходит: за API стороннего сервиса, базу или облако, и за токены модели. В Relay подписки нет, токены списываются с баланса.

Нужно ли настраивать что-то в Relay, чтобы MCP заработал?

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

Можно ли ставить чужие MCP-серверы?

Можно, если сначала прочитать строку запуска и код. Локальный сервер получает права вашего пользователя, а всё, что он вернул, уходит в промпт. Выдавайте минимум прав и храните секреты вне репозитория.

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.