Что такое MCP-сервер простыми словами#
До протокола каждую пару «агент — сервис» соединяли отдельно, руками. Десять агентов и десять сервисов — сто самодельных мостиков, и каждый ломается по-своему. MCP убирает эту арифметику: сервис один раз описывает себя по общему стандарту, и его понимает любой агент, который этот стандарт умеет.
Придумала протокол Anthropic и опубликовала его 25 ноября 2024 года — как «новый стандарт связи ИИ-помощников с системами, где живут данные». Через год он перестал быть её собственностью: 9 декабря 2025 года MCP передан в Agentic AI Foundation — фонд под крылом Linux Foundation. Туда же одновременно ушли goose от Block и формат AGENTS.md от OpenAI, а в списке платиновых участников — Amazon, Google, Microsoft, Cloudflare, Bloomberg.
Это не формальность, а ответ на вопрос «не выключат ли завтра». Стандартом теперь управляет не один вендор, и последняя спецификация от 28 июля 2026 года вышла уже в этом режиме: протокол сделали stateless — без рукопожатия и идентификаторов сессии, каждый запрос сам себя описывает. За тридцать дней до 21 июля 2026 года пакеты MCP для TypeScript и Python скачали больше 470 миллионов раз.
Вайбкодеру из всего этого важна одна вещь: MCP-сервер — не плагин с кнопками. Это набор инструментов, которые агент вызывает сам, когда решит, что они нужны. Вы не нажимаете «загрузить макет» — вы пишете «посмотри, почему кнопка съезжает», а дальше агент сам решает, лезть ли ему в браузер.
| Способ | Что это | Когда берут |
|---|---|---|
Локальный (stdio) |
Программа на вашей машине, Claude Code запускает её как процесс | Нужен доступ к браузеру, файлам, локальной базе |
Удалённый (http) |
Чужой сервер по адресу в интернете | Облачный сервис: трекер, документация, мониторинг |
| Коннектор claude.ai | Сервер, добавленный в веб-интерфейсе Клода | Уже подключён в чате и нужен в терминале — приезжает сам |
Четвёртый транспорт, sse, объявлен устаревшим: если в чужой инструкции он ещё встречается, ищите у того же сервиса адрес для http.
Как подключить сервер: одна команда#
Проще всего проверить, что всё работает, на официальном сервере Anthropic с документацией Claude Code. Он бесплатный, не требует ни регистрации, ни ключей — и, забегая вперёд, остаётся полезным насовсем.
- Выйдите из сессии Клода: команды
claude mcpвыполняются в обычном терминале, а не внутри диалога. - Добавьте сервер:
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp - Проверьте связь командой
claude mcp list— рядом с именем должно появиться✔ Connected. - Запустите
claudeи попросите: «Через сервер claude-code-docs посмотри, что делает MCP_TIMEOUT». - Разрешите вызов инструмента, когда Клод спросит, — первый раз он спрашивает про каждый новый сервер.
Разберём команду по частям, потому что дальше вы будете писать её сами:
1claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
--transport http говорит, что сервер живёт по адресу, а не на вашей машине. claude-code-docs — имя, которое вы придумываете сами: под ним сервер показывается в списке и им же удаляется. Последним идёт адрес.
Локальный сервер добавляется иначе — вместо адреса указывается команда запуска, и перед ней ставится двойной дефис:
1claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest
Ещё одна ловушка на старте: claude mcp add не проверяет доступы. Команда только записывает настройку, поэтому она радостно примет и пустой токен, и опечатку в адресе. Сообщение Added… означает «записано», а не «работает» — работает то, что показало ✔ Connected в claude mcp list.
Внутри сессии тот же список показывает команда /mcp, и там видно ещё одну важную цифру — сколько инструментов принёс каждый сервер. Она пригодится дальше: после 30–50 доступных инструментов агент начинает путаться, какой из них брать.
Где хранится настройка и кому она видна#
У сервера есть область видимости, и выбирается она флагом --scope. Это решение стоит принять сразу: поменять область у добавленного сервера нельзя, только удалить и добавить заново.
| Область | Где лежит | Кто видит |
|---|---|---|
local (по умолчанию) |
~/.claude.json |
Только вы, только в этом проекте |
project |
.mcp.json в корне проекта |
Все, кто склонирует репозиторий |
user |
~/.claude.json |
Только вы, зато во всех проектах |
Для сервера, который нужен вам всегда — браузер, документация, — берите --scope user: иначе придётся добавлять его в каждом новом проекте заново. Для сервера, который относится к конкретному проекту, — --scope project: файл .mcp.json уезжает в репозиторий, и у напарника всё поднимается само.
Ключи в .mcp.json не пишут — файл лежит в репозитории. Там подставляются переменные окружения:
1{2 "mcpServers": {3 "api-server": {4 "type": "http",5 "url": "https://api.example.com/mcp",6 "headers": { "Authorization": "Bearer ${API_KEY}" }7 }8 }9}
Если сервер не подключился#
Три причины закрывают почти все случаи:
-
✘ Failed to connectсразу после добавления локального сервера. Скорее всего,npxещё качает пакет: подождите и повторитеclaude mcp list. Не помогло — запустите ту же команду руками и прочитайте, что она скажет. -
Connection timed out. Старт сервера ограничен тридцатью секундами. Медленный интернет лечится запускомMCP_TIMEOUT=60000 claude. -
Правка
.mcp.jsonне подействовала. Файл читается один раз, при старте сессии. Выйдите и зайдите заново.
Отдельная история — ! Needs authentication. Это не ошибка, а нормальный статус сервиса с логином: наберите /mcp внутри сессии, выберите сервер и подтвердите вход в браузере. Или, если не хочется выходить из терминала, выполните claude mcp login <имя>.
Три сервера, которые правда пригодятся#
Каталог Anthropic и чужие подборки перечисляют сотни серверов, и в этом главная ловушка темы: подключить хочется всё. Ниже — три, которые закрывают три реальные боли вайбкодера, а не «интеграцию с сервисом, которым вы не пользуетесь».
Chrome DevTools: агент видит страницу#
Самая частая беда при сборке сайта — агент не видит результат. Он пишет CSS вслепую, вы открываете страницу, находите съехавшую кнопку, описываете её словами, агент правит наугад. Круг повторяется.
Сервер Chrome DevTools от команды Google даёт агенту настоящий браузер: 31 инструмент, включая скриншот, чтение консоли со стек-трейсами по сорсмапам, разбор сетевых запросов, запись трассы производительности и эмуляцию мобильных экранов. Нужны Node.js, npm и Chrome.
1claude mcp add chrome-devtools --scope user -- npx -y chrome-devtools-mcp@latest
После этого работают просьбы вроде «открой localhost:3000, сними скриншот на ширине 375 и скажи, что разъезжается» или «загрузи страницу и покажи, что ругается в консоли».
Context7: свежая документация вместо выдуманных функций#
Вторая беда — придуманные функции. Модель обучена до какой-то даты, библиотека с тех пор переехала на новый синтаксис, и агент уверенно пишет код по старой версии. Формально всё логично, фактически не работает.
Context7 от Upstash отдаёт агенту документацию конкретной библиотеки нужной версии. Инструментов два: resolve-library-id находит библиотеку по имени, query-docs достаёт по ней документацию. Ключ не обязателен — бесплатного уровня хватает, ключ с их сайта только поднимает лимиты.
1claude mcp add --transport http --scope user context7 https://mcp.context7.com/mcp
Дальше в промпте достаточно попросить прямо: «через context7 посмотри, как в свежей версии настраивается роутинг». Тот же приём помогает, когда агент спорит с вами о синтаксисе: вместо спора — сходить и прочитать.
Документация Claude Code: чтобы агент не путался в своих настройках#
Третья беда самая обидная: Клод неуверенно рассказывает про собственные настройки. Флаги, хуки, области видимости, названия переменных меняются от версии к версии, и по памяти он выдаёт то, что было полгода назад.
Тот самый сервер, на котором мы проверяли подключение, эту дыру и закрывает — он ищет по актуальной документации Claude Code:
1claude mcp add --transport http --scope user claude-code-docs https://code.claude.com/docs/mcp
Ноль настройки, ноль регистрации, две минуты работы. Особенно заметно, когда разбираетесь с CLAUDE.md, хуками и правами: там ошибиться версией легко, а цена ошибки — час на разбор того, чего в вашей сборке просто нет. Как устроены сами правила проекта, разбираю в статье про CLAUDE.md и память агента.
Сколько сервер стоит в контексте#
Теперь про цену, из-за которой список выше такой короткий. Каждый сервер рассказывает агенту, что он умеет, и этот рассказ занимает место в окне контекста — в каждой сессии, независимо от того, пригодился сервер или нет.
Цифра из документации Anthropic: типичный набор из пяти серверов — GitHub, Slack, Sentry, Grafana, Splunk — съедает около 55 000 токенов в одних только описаниях инструментов. До того, как агент прочитал хоть одну строчку вашего кода.
Есть и вторая цена, менее очевидная. Точность выбора инструмента падает, когда доступных становится больше 30–50: агент начинает путаться в похожих названиях. Тот же эффект, что с раздутым CLAUDE.md, — и он же одна из причин, по которым агент делает не то.
С обеими бедами борется поиск по инструментам, и в Claude Code он включён по умолчанию: на старте грузятся только имена, а полное описание подтягивается, когда инструмент действительно понадобился. Экономия — больше 85%.
Поиск по инструментам сделал лишний сервер дешёвым, а не бесплатным. Дешёвая ошибка совершается чаще — и потому обходится дороже.
Отдельно стоит знать про вывод. Если инструмент вернул больше 10 000 токенов, Claude Code предупреждает, а на 25 000 обрезает. Потолок поднимается переменной MAX_MCP_OUTPUT_TOKENS, но чаще правильный вывод другой: сервер, который на каждый чих вываливает простыню, съест вам сессию.
Когда MCP не нужен#
Половина серверов из популярных подборок вам не нужна, и вот почему.
Файлы Клод и так читает. Файловый MCP-сервер — первое, что советуют в чужих инструкциях, и он бессмысленный: чтение, поиск и правка файлов встроены в Claude Code.
Терминал у него тоже есть. Всё, что делается командой в консоли, агент делает командой в консоли. Работа с GitHub через gh, запросы к базе через psql, сборка проекта — для этого сервер не нужен. MCP выигрывает там, где у сервиса нет вменяемой командной строки, а не там, где вам лень разрешить Bash.
Иногда сервер заменяется скиллом. Скилл — это инструкция, которую агент читает, когда она нужна, и в контексте она почти ничего не весит. Context7, как мы видели, сам предлагает такой режим вместо MCP.
Правило, к которому всё сводится: сервер подключается под задачу, которая у вас уже болит. Не «на всякий случай». Список стоит раз в пару месяцев пересматривать и вычищать — claude mcp remove <имя> возвращает контекст мгновенно.
Чему вы даёте доступ#
Об этом почти не пишут в подборках, поэтому скажу прямо: подключая MCP-сервер, вы запускаете чужой код рядом со своим проектом.
В документации по безопасности Anthropic формулирует честно: связанные коннекторы проверяются по критериям каталога, но аудита безопасности серверов Anthropic не проводит. Рекомендация оттуда же — писать свои серверы или брать у тех, кому доверяете.
Второй риск специфический — инъекция промпта. Сервер, который тянет содержимое из интернета, приносит агенту чужой текст, а в этом тексте могут быть инструкции. Не «представьте себе», а обычная практика: комментарий в задаче, страница по ссылке, ответ чужого API.
Что из этого следует на практике:
- смотреть, кто автор сервера, и предпочитать серверы самих сервисов и известных команд, а не безымянные обёртки;
- давать серверу минимум прав — для базы это отдельный пользователь только на чтение, для трекера токен на один проект;
- не отключать подтверждение доверия к новому серверу: оно там не для красоты;
-
держать
.mcp.jsonпод тем же вниманием, что и остальной код в репозитории: строчка в нём означает процесс, который запустится у каждого, кто склонирует проект.
Готовые промпты, которые не требуют ни одного сервера и работают из коробки, собраны у нас в библиотеке промптов.
Частые вопросы#
Что такое MCP-сервер простыми словами?
Как подключить MCP-сервер к Claude Code?
claude mcp add --transport http имя адрес, для локальной программы — claude mcp add имя -- команда запуска, где двойной дефис отделяет опции от аргументов сервера. Дальше claude mcp list покажет статус: нужен ответ ✔ Connected. Сервисы с логином потребуют ещё входа через панель /mcp.Какие MCP-серверы бесплатные?
Сколько MCP-серверов можно подключить?
Почему сервер показывает «Failed to connect»?
claude mcp list. Если не помогло, запустите команду сервера руками в терминале и прочитайте ошибку. У облачных серверов та же надпись означает неверный адрес или отсутствующий токен: claude mcp add не проверяет доступы при добавлении.- Anthropic — полный справочник по MCP в Claude Code: команды, транспорты, области видимости, лимиты вывода
- Anthropic — подключение первого сервера по шагам и разбор ошибок
- Anthropic — безопасность: аудита MCP-серверов компания не проводит
- Anthropic — 55 000 токенов на пять серверов, экономия больше 85%, падение точности после 30–50 инструментов
- Anthropic — анонс протокола 25 ноября 2024 года
- Model Context Protocol — переход стандарта в Agentic AI Foundation
- Linux Foundation — состав фонда и переданные проекты
- Model Context Protocol — спецификация от 28 июля 2026 года и цифры загрузок SDK
- Chrome DevTools — состав из 31 инструмента, установка и предупреждения о доступе к браузеру
- Upstash — адрес сервера Context7, инструменты и режимы установки
- Microsoft — сервер Playwright, второй частый вариант браузера для агента
Больше цифр и разборов — в Telegram-канале
Черновики, промежуточные результаты и то, что не дошло до блога