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

Что такое MCP-сервер и как подключить его к кодинг-агентам: серверы stdio и HTTP, расход токенов, секреты и правильная область действия, по шагам.

Solviera Teknoloji 6 мин чтения

Что такое MCP-сервер? Коротко: небольшая программа, которая даёт ИИ-агенту новые возможности. Model Context Protocol (MCP) — открытый протокол: по нему сервер предлагает агенту инструменты, готовые промпты и читаемые ресурсы. Агент вызывает эти инструменты, чтобы открыть браузер, прочитать issues на GitHub, найти ошибки в Sentry или сделать запрос к базе данных.

В статье разбирается, как работает MCP, какие серверы стоит добавить и какие ошибки люди допускают, подключая их к кодинг-агентам.

Что такое MCP-сервер и как он работает?

MCP-сервер может предлагать три вида вещей:

  • Инструменты (tools): функции, которые может вызвать агент, например browser_navigate или search_issues.
  • Промпты (prompts): шаблоны, которые сервер подготавливает для агента.
  • Ресурсы (resources): данные, которые агент может прочитать, например файл или запись.

Когда агент стартует, он подключается к своим серверам и получает списки их инструментов. Эти списки попадают в контекст модели, и модель вызывает инструмент, когда он нужен.

Типы подключения

ТипГде работаетПримерАвторизация
stdioНа вашем компьютере, как командаnpx -y @playwright/mcp@latestПеременные окружения при необходимости
HTTPПо удалённому адресуhttps://mcp.sentry.dev/mcpТокен или OAuth
SSEПо удалённому адресу, как поток событийВстречается у старых серверовТокен или OAuth

MCP-серверы, которые стоит добавить

Серверы, которые чаще всего используют с кодинг-агентами, делятся на несколько групп. Некоторые из 23 готовых серверов в каталоге AgentVera:

  • Браузер: Playwright (открывать страницы, кликать, заполнять формы, делать скриншоты), Chrome DevTools (консоль, сетевые запросы, трассы производительности).
  • Документация: Context7 (актуальная документация библиотек под нужную версию), Cloudflare Docs.
  • Разработка: GitHub (issues, pull request, поиск по коду), Git (локальный log, diff, commit), Sentry (ошибки и стек-трейсы).
  • Мобильная разработка: Mobile MCP, MobileBuildMCP, iOS Simulator, Firebase.
  • Данные и память: Filesystem, Memory, Fetch, Sequential Thinking, Supabase.
  • Продукт и команда: Linear, Notion, Stripe.
  • Дизайн: Figma (сервер Dev Mode MCP в десктопном приложении), Canva.
  • Маркетинг: fal.ai (генерация изображений, видео и аудио), Meta Ads (рекламные кампании).

Добавление MCP-серверов в каждый CLI

У каждого агента свой способ. В Claude Code сервер можно добавить из командной строки:

claude mcp add playwright -- npx -y @playwright/mcp@latest

В Codex серверы описываются в ~/.codex/config.toml:

[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp@latest"]

Подвох в том, что один и тот же сервер приходится описывать заново в каждом инструменте, а секреты оказываются в конфигах открытым текстом. Когда агентов несколько, списки расходятся.

Управление MCP-серверами в одном месте

MCP-менеджер AgentVera держит серверы в одном списке и подключает их при запуске агента:

  1. На странице MCP нажмите +, чтобы открыть каталог и выбрать сервер, или введите собственную команду либо адрес.
  2. Решите, получат ли его все агенты или только выбранные вами. При желании ограничьте его одним проектом.
  3. Нажмите Test connection, чтобы получить список инструментов, промптов и ресурсов сервера.
  4. Перезапустите агента; изменение применится к новой сессии.

Секретные переменные окружения и токены в заголовках хранятся в связке ключей вашей операционной системы. Серверы, которым нужен OAuth, авторизуются при первом использовании. Серверы из собственных настроек Claude Code и Codex показываются в списке вместе с состоянием; их можно импортировать в AgentVera или записать серверы AgentVera обратно в конфиги CLI.

Эти серверы получают не только Claude Code и Codex. Их получают и другие инструменты с поддержкой MCP: opencode, Copilot, Qwen Code, Goose и Amp.

Считайте стоимость в токенах

Скрытая цена MCP — контекст. Описания инструментов каждого сервера попадают в контекст агента и перечитываются на каждом ходу. Сервер с десятью инструментами занимает место на каждом ходу, даже если агент ни разу его не вызывает.

Тест подключения в AgentVera показывает примерное число токенов, которые каждый инструмент добавляет в контекст агента. Это позволяет:

  • Отдавать дорогие, но редко нужные серверы только тому агенту, которому они нужны.
  • Выбирать более лёгкий из двух серверов, делающих одно и то же.
  • Держать компактного агента свободным от инструментов, которыми он не воспользуется.

Другие способы сократить контекст описаны в статье как снизить расход токенов в Claude Code.

Общая доска для агентов

AgentVera автоматически добавляет в каждый проект MCP-сервер agentvera-board. Это доска объявлений, общая для агентов проекта и вас. Агенты используют board_read, board_post и board_update, чтобы оставлять заметки, решения, todo, находки и записи о файлах и модулях, а также читать, что написали другие. Вы публикуете и отмечаете выполненными todo на вкладке Board в правой панели.

Для параллельных агентов это простой ответ на вопрос «как Tester узнает о решении, которое принял Architect?».

Пример: тестирование в браузере через Playwright

Лучший пример того, что даёт MCP, — браузер. Агент с MCP-сервером Playwright может:

  • Открыть ваше приложение по его локальному адресу.
  • Сделать снимок дерева доступности страницы.
  • Нажимать кнопки и заполнять формы.
  • Сделать скриншот и рассказать, что он видит.

Так агент сам проверит, например, «работает ли кнопка сохранения на странице настроек?». Для этого AgentVera управляет headless Chrome с собственным профилем. Агенты в режиме «AgentVera browser» используют его через Playwright MCP, а вы следите за вкладками в реальном времени на странице Browser и вмешиваетесь, когда захотите. Подробности смотрите на странице браузера агента.

Какой сервер для какого агента?

Раздавать серверы по ролям, а не давать каждый сервер каждому агенту, выгодно и для контекста, и для безопасности:

Роль агентаПодходящие серверыЗачем
Фронтенд-разработчикPlaywright, Chrome DevTools, FigmaВидит страницу, читает дизайн
Бэкенд-разработчикContext7, Supabase, GitАктуальная документация, база данных, история репозитория
ОтладчикSentry, GitHubСтек-трейсы и связанные issues
ПродуктовыйLinear, NotionЧитает и обновляет задачи и документы

Полезно и ограничивать сервер одним проектом. Сервер, подключённый к Supabase-проекту одного клиента, не должен быть виден агентам в других проектах.

Заметки о безопасности

MCP-серверы дают агентам доступ к реальным системам. Поэтому:

  • Осторожнее с серверами, которые могут писать. Агент, способный применять миграции базы данных, может изменить данные одним неверным шагом.
  • Не храните токены в текстовых файлах. Используйте связку ключей или переменные окружения.
  • Не запускайте незнакомые серверы. Серверы stdio выполняются как код на вашем компьютере.
  • Не пропускайте тест подключения. Он показывает, что сервер предлагает на самом деле и сколько контекста стоит.

Добавление собственного MCP-сервера

Можно добавлять и серверы, которых нет в каталоге. Нужно две вещи:

  • Для stdio: команда и аргументы запуска, а также переменные окружения, если они нужны.
  • Для HTTP или SSE: адрес сервера и заголовки авторизации, если они нужны.

После добавления проверьте подключение. Если тест не проходит, посмотрите вывод сервера (stderr): обычно причина в отсутствующей переменной окружения или неустановленной среде выполнения (например, uvx).

Чек-лист

  • Действительно ли этот сервер помогает этому агенту?
  • Вы проверили его стоимость в токенах?
  • Секреты лежат в связке ключей, а не в текстовом файле?
  • Нужно ли ограничить сервер одним проектом?
  • Вы перезапустили агента после добавления?

Итоги

MCP-серверы выводят кодинг-агентов за пределы терминала: в зоне досягаемости оказываются браузеры, трекеры задач, мониторинг ошибок и файлы дизайна. Цена — расход контекста и управление секретами. Баланс помогают удержать управление серверами в одном месте, сужение их области действия и измерение их стоимости.

Вы можете попробовать MCP-менеджер AgentVera в бесплатном тарифе, а какие инструменты поддерживают MCP, смотрите на странице Claude Code и на страницах других агентов.

Вопросы

Что такое MCP-сервер?

Небольшая программа, которая говорит на протоколе Model Context Protocol и предлагает ИИ-агенту инструменты, промпты и ресурсы. Вызывая эти инструменты, агент может открыть браузер, прочитать issues или сделать запрос к базе данных.

Чем отличаются серверы stdio и HTTP?

Сервер stdio запускается как команда на вашем компьютере (например, через npx). HTTP-сервер работает по удалённому адресу и обычно требует OAuth или токен.

Тратят ли MCP-серверы токены?

Да. Описания инструментов каждого сервера попадают в контекст агента и перечитываются на каждом ходу. Не подключая неиспользуемые серверы, вы снижаете расход.

Какие агенты поддерживают MCP?

В AgentVera MCP-серверы AgentVera при запуске получают не только Claude Code и Codex, но и opencode, Copilot, Qwen Code, Goose и Amp.

Соберите своих агентов за одним столом.

Скачайте AgentVera бесплатно; ваши установленные CLI уже готовы к работе.

Другие статьи