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

Разбираю по документации Anthropic: чем MCP-сервер отличается от встроенного инструмента, как добавить его одной командой и почему десять серверов работают хуже двух

Автор Ольга Гунько Опубликовано Обновлено Время чтения 15 мин Просмотров 1
Новичок
Слева друг под другом окно браузера, лист с текстом и цилиндр базы данных, от каждого тянется серый провод в оранжевую коробку-разветвитель по центру; из неё один провод уходит вправо в окно терминала со значком консоли, рядом стоит оранжевый квадратный человечек
Один разъём вместо трёх разных — это и есть вся идея протокола

Что такое 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. Он бесплатный, не требует ни регистрации, ни ключей — и, забегая вперёд, остаётся полезным насовсем.

  1. Выйдите из сессии Клода: команды claude mcp выполняются в обычном терминале, а не внутри диалога.
  2. Добавьте сервер: claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
  3. Проверьте связь командой claude mcp list — рядом с именем должно появиться ✔ Connected.
  4. Запустите claude и попросите: «Через сервер claude-code-docs посмотри, что делает MCP_TIMEOUT».
  5. Разрешите вызов инструмента, когда Клод спросит, — первый раз он спрашивает про каждый новый сервер.

Разберём команду по частям, потому что дальше вы будете писать её сами:

bash
1claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

--transport http говорит, что сервер живёт по адресу, а не на вашей машине. claude-code-docs — имя, которое вы придумываете сами: под ним сервер показывается в списке и им же удаляется. Последним идёт адрес.

Локальный сервер добавляется иначе — вместо адреса указывается команда запуска, и перед ней ставится двойной дефис:

bash
1claude mcp add chrome-devtools -- npx -y chrome-devtools-mcp@latest

Ещё одна ловушка на старте: claude mcp add не проверяет доступы. Команда только записывает настройку, поэтому она радостно примет и пустой токен, и опечатку в адресе. Сообщение Added… означает «записано», а не «работает» — работает то, что показало ✔ Connected в claude mcp list.

Внутри сессии тот же список показывает команда /mcp, и там видно ещё одну важную цифру — сколько инструментов принёс каждый сервер. Она пригодится дальше: после 30–50 доступных инструментов агент начинает путаться, какой из них брать.

Где хранится настройка и кому она видна#

У сервера есть область видимости, и выбирается она флагом --scope. Это решение стоит принять сразу: поменять область у добавленного сервера нельзя, только удалить и добавить заново.

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

Для сервера, который нужен вам всегда — браузер, документация, — берите --scope user: иначе придётся добавлять его в каждом новом проекте заново. Для сервера, который относится к конкретному проекту, — --scope project: файл .mcp.json уезжает в репозиторий, и у напарника всё поднимается само.

Ключи в .mcp.json не пишут — файл лежит в репозитории. Там подставляются переменные окружения:

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.

bash
1claude mcp add chrome-devtools --scope user -- npx -y chrome-devtools-mcp@latest

После этого работают просьбы вроде «открой localhost:3000, сними скриншот на ширине 375 и скажи, что разъезжается» или «загрузи страницу и покажи, что ругается в консоли».

Context7: свежая документация вместо выдуманных функций#

Вторая беда — придуманные функции. Модель обучена до какой-то даты, библиотека с тех пор переехала на новый синтаксис, и агент уверенно пишет код по старой версии. Формально всё логично, фактически не работает.

Context7 от Upstash отдаёт агенту документацию конкретной библиотеки нужной версии. Инструментов два: resolve-library-id находит библиотеку по имени, query-docs достаёт по ней документацию. Ключ не обязателен — бесплатного уровня хватает, ключ с их сайта только поднимает лимиты.

bash
1claude mcp add --transport http --scope user context7 https://mcp.context7.com/mcp

Дальше в промпте достаточно попросить прямо: «через context7 посмотри, как в свежей версии настраивается роутинг». Тот же приём помогает, когда агент спорит с вами о синтаксисе: вместо спора — сходить и прочитать.

Документация Claude Code: чтобы агент не путался в своих настройках#

Третья беда самая обидная: Клод неуверенно рассказывает про собственные настройки. Флаги, хуки, области видимости, названия переменных меняются от версии к версии, и по памяти он выдаёт то, что было полгода назад.

Тот самый сервер, на котором мы проверяли подключение, эту дыру и закрывает — он ищет по актуальной документации Claude Code:

bash
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, и в других инструментах, без отдельной интеграции под каждый.
Как подключить MCP-сервер к Claude Code?
Одной командой в обычном терминале, не внутри сессии. Для облачного сервиса это claude mcp add --transport http имя адрес, для локальной программы — claude mcp add имя -- команда запуска, где двойной дефис отделяет опции от аргументов сервера. Дальше claude mcp list покажет статус: нужен ответ ✔ Connected. Сервисы с логином потребуют ещё входа через панель /mcp.
Какие MCP-серверы бесплатные?
Бесплатны почти все локальные: Chrome DevTools, Playwright и подобные — это открытые программы, которые запускаются у вас на машине. Из облачных бесплатен сервер документации Claude Code, а Context7 работает без ключа на общем лимите. Платят обычно не за сервер, а за сам сервис: доступ к трекеру или мониторингу нужен такой же, как из браузера.
Сколько MCP-серверов можно подключить?
Технического потолка нет, практический — окно контекста. Каждый сервер описывает свои инструменты в каждой сессии: набор из пяти популярных занимает около 55 000 токенов. Поиск по инструментам в Claude Code включён по умолчанию и срезает больше 85%, но точность выбора всё равно падает, когда инструментов набирается за полсотни. Двух-трёх серверов хватает почти всем.
Почему сервер показывает «Failed to connect»?
Чаще всего это локальный сервер, у которого ещё качается пакет: подождите полминуты и повторите claude mcp list. Если не помогло, запустите команду сервера руками в терминале и прочитайте ошибку. У облачных серверов та же надпись означает неверный адрес или отсутствующий токен: claude mcp add не проверяет доступы при добавлении.
Ольга Гунько
Автор Ольга Гунько Веб-дизайнер и вайбкодер

Строю проекты на нейросетях и показываю всё как есть — цифры, затраты, результаты

18 лет в дизайне 600+ проектов Вау-сайты SEO-заводы Claude + Figma
Клодовая · Telegram-канал · 107 подписчиков

Больше цифр и разборов — в Telegram-канале

Черновики, промежуточные результаты и то, что не дошло до блога

Подписаться на Клодовую