Что такое 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 держит серверы в одном списке и подключает их при запуске агента:
- На странице MCP нажмите +, чтобы открыть каталог и выбрать сервер, или введите собственную команду либо адрес.
- Решите, получат ли его все агенты или только выбранные вами. При желании ограничьте его одним проектом.
- Нажмите Test connection, чтобы получить список инструментов, промптов и ресурсов сервера.
- Перезапустите агента; изменение применится к новой сессии.
Секретные переменные окружения и токены в заголовках хранятся в связке ключей вашей операционной системы. Серверы, которым нужен 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 и на страницах других агентов.