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 (сервер доступен по адресу), как описано в разделе об архитектуре в документации протокола.
Что происходит, когда вы просите «найди в заметках всё про платежи»:
| Шаг | Кто действует | Что происходит |
|---|---|---|
| 1 | Claude Code | отправляет модели ваш запрос и описания инструментов всех подключённых серверов |
| 2 | Модель | отвечает просьбой вызвать конкретный инструмент с аргументами |
| 3 | Claude Code | вызывает этот инструмент на нужном MCP-сервере |
| 4 | MCP-сервер | выполняет действие и возвращает текст или данные |
| 5 | Claude Code | кладёт результат в контекст и снова обращается к модели |
Возможности бывают трёх видов: инструменты (то, что модель вызывает как функцию), ресурсы (данные, которые подкладывают в контекст) и промпты (готовые шаблоны запросов). Практичное правило для своих серверов: всё, что пишет или удаляет, оформляйте инструментом, а чтение отдавайте ресурсом. Тогда клиент сразу показывает, где риск.
Как подключить сервер к Claude Code
Достаточно одной команды. Двойной дефис в ней отделяет параметры самого claude от строки, которой запускается сервер (так описано в документации Claude Code про MCP).
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 сам не заведётся. Для локального сервера запись выглядит так:
{
"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).
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-инструментов доходят в том виде, в каком их собрал клиент. Поддержку конкретных параметров определяет сама модель, а в каталоге у всех текстовых моделей отмечена работа с инструментами.
Что при этом уходит к провайдеру
Описания инструментов и результаты вызовов становятся частью промпта. Если сервер прочитал файл с паролями, текст файла ушёл модели. По странице безопасности, Relay не хранит тексты запросов и ответов: они проходят к поставщику модели, и тот получает их целиком. В журнале остаются модель, число токенов, стоимость и время, записи живут 90 дней.
Есть и денежная сторона. Описания инструментов едут в каждом запросе сессии и считаются входными токенами, поэтому пять подключённых серверов с длинными описаниями заметно утяжеляют каждый шаг агента. Для агентной работы заведите отдельный ключ: суточный лимит расходов, лимит запросов в минуту и список моделей задаются на каждый ключ. Как читать списания, описано в разделе про оплату.
Свой сервер: короткий маршрут
Возьмите официальный SDK на Python или TypeScript из организации modelcontextprotocol на GitHub.
Опишите одну функцию как инструмент: имя, типизированные аргументы и ясное описание. Его читает модель, и по нему она решает, когда вызывать.
Запустите сервер по stdio и проверьте инструмент руками в MCP Inspector, пока ИИ не подключён.
Только потом добавляйте его командой
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-серверы?
Можно, если сначала прочитать строку запуска и код. Локальный сервер получает права вашего пользователя, а всё, что он вернул, уходит в промпт. Выдавайте минимум прав и храните секреты вне репозитория.