Матвей АбрамовМатвей АбрамовВступить в клуб

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

Матвей Абрамов
6 июня 2026 · 16 мин чтения · Уровень: Базовый → Средний
1 просмотров 1 поделились 6 оценили полезной
MCP Файлы проект на диске GitHub репозиторий База данных SQL-запросы Браузер веб и страницы

Ты сидишь в Claude Code и упираешься в стену: он отлично пишет код, но не может сам сходить в твой GitHub, выполнить запрос к базе, проверить страницу в браузере или поискать в интернете. Каждый раз ты руками копируешь данные туда-сюда — выгружаешь логи, вставляешь содержимое таблицы, пересказываешь, что лежит в репозитории. MCP закрывает ровно эту дыру: он даёт Claude руки за пределами чата. Ниже — что такое MCP-серверы простыми словами, как они устроены, как подключить любой сервер одной командой claude mcp add, чем отличаются уровни local, project и user, какие серверы поставить первыми и что делать, если не подключается. А в конце — к чему вся эта обвязка ведёт на самом деле и почему именно она превращает Claude из чата в станок для продукта.

Веду канал про Claude и вайбкодингРазборы, связки и то, как на этом собирать продукт без лица.
Подписаться
Что узнаешь из разбора
  • Что такое MCP и MCP-сервер — без академических определений, на пальцах
  • Как подключить любой сервер одной командой claude mcp add
  • Разницу между транспортами stdio, SSE и HTTP — и когда какой
  • Чем отличаются уровни local, project и user и где что подключать
  • Пять серверов, которые реально стоит поставить первыми
  • Как чинить, если сервер не подключается, через /mcp и claude mcp get

Что такое MCP простыми словами

Короткий ответ сразу, как любит поисковик: MCP (Model Context Protocol) — это открытый стандарт, по которому Claude Code подключается к внешним инструментам и данным. Файловая система, GitHub, база данных, браузер, поиск в интернете, твой Notion или таск-трекер — всё это Claude может получить «руками», если подключить соответствующий MCP-сервер.

Разберём на пальцах. MCP-сервер — это маленькая программа-переходник. Она умеет делать что-то одно конкретное: читать файлы в папке, ходить в GitHub-репозиторий, выполнять SQL-запросы, открывать страницы в браузере. И главное — она описывает Claude свои возможности на одном общем языке: «я умею вот эти действия, вот с такими параметрами». Claude видит этот список и может вызывать действия сам, по ходу разговора.

Claude Code в этой схеме — MCP-клиент. Ты один раз подключаешь к нему сервер, и его инструменты появляются у Claude прямо в диалоге. Дальше не нужно ничего копировать руками: попросил «посмотри открытые issue в репозитории» — Claude сам сходил через GitHub-сервер и принёс. Попросил «проверь, что лежит в таблице users» — сходил в базу через сервер БД.

Аналогия простая: MCP — это USB-разъём для нейросети. Раньше под каждый прибор был свой кабель и своя возня. USB сделал один разъём на всё. MCP делает то же для ИИ: один протокол, через который Claude подключается к любому инструменту, у которого есть MCP-сервер.

Стандарт открытый — его придумали в Anthropic и отдали сообществу, поэтому MCP-серверы пишут все кому не лень: и сама Anthropic, и компании под свои продукты, и энтузиасты. Отсюда главная ценность: серверов уже сотни, и подключить любой — это одна команда, а не отдельная интеграция под каждый сервис.

Зачем это нужно: какую боль закрывает

Без MCP Claude Code живёт внутри коробки: он видит файлы проекта, в котором ты его запустил, и больше ничего. Всё, что снаружи, ты таскаешь руками. И это та самая рутина, которая незаметно съедает и время, и токены.

Посмотри, как выглядит работа без MCP и с ним:

ЗадачаБез MCPС MCP
Глянуть открытые issueИдёшь в браузер, копируешь, вставляешь в чат«Покажи открытые issue» — Claude сходил сам
Проверить данные в базеОткрываешь клиент БД, пишешь SQL, копируешь вывод«Сколько заказов за вчера?» — Claude выполнил запрос
Проверить вёрстку страницыОписываешь словами, что видишь на экранеClaude сам открыл страницу в браузере и посмотрел
Найти свежую информациюГуглишь, выбираешь, пересказываешь ему«Поищи, как сейчас делают X» — Claude нашёл сам

Разница не в «удобнее», а в принципе. Когда Claude таскает данные сам, он работает с актуальным состоянием, а не с твоим пересказом трёхчасовой давности. Он видит реальную таблицу, реальный issue, реальную страницу — и ошибается реже, потому что не строит догадки поверх неполного контекста. А ты перестаёшь быть курьером между Claude и остальными твоими инструментами.

Где это особенно выстреливает

Сборка реального продукта почти всегда упирается в внешние системы: репозиторий, база, платёжка, страница, которую надо проверить. Чем больше из этого Claude достаёт сам через MCP, тем меньше ты переключаешься между окнами — и тем быстрее идёт сборка. Про экономию контекста при этом — в разборе «Как не сжечь лимиты Claude Code».

Как устроен MCP: клиент, сервер, транспорт

Чтобы подключать серверы осознанно, а не копипастом, держи в голове три понятия. Их всего три, и они объясняют почти всё, что ты увидишь в командах.

  1. Клиент. Это сам Claude Code. Он умеет говорить на языке MCP и вызывать инструменты, которые ему отдают серверы. Клиент — всегда на твоей стороне.
  2. Сервер. Это та самая программа-переходник под конкретный инструмент: server-github, server-filesystem, сервер браузера и так далее. Один сервер — один набор возможностей.
  3. Транспорт. Это способ, которым клиент и сервер общаются. Их три, и именно транспорт определяет, какой командой ты подключаешь сервер.

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

ТранспортЧто этоКогда
stdioСервер запускается у тебя на машине как локальный процесс; общение через ввод-выводБольшинство локальных серверов: файлы, БД, браузер
SSEУдалённый сервер по сети, поток событий через HTTPОблачные сервисы с готовым MCP-эндпоинтом
HTTPУдалённый сервер по обычному HTTP (streamable)Современные удалённые серверы, часто с OAuth-входом

Практический вывод простой. Если сервер ставится и крутится у тебя на компьютере (а таких большинство — файлы, база, браузер) — это stdio, и ты просто говоришь Claude Code, какой командой его запустить. Если сервер живёт где-то в облаке и у него есть готовый адрес — это SSE или HTTP, и ты передаёшь URL, а вход часто идёт через авторизацию прямо из /mcp.

Не запоминай транспорты наизусть — запомни развилку: сервер запускается у меня (stdio) или живёт по адресу в сети (sse/http). Этого хватает, чтобы понять, какую из команд ниже брать.

Как подключить MCP-сервер: claude mcp add

Теперь самое нужное. Подключение делается одной командой в терминале — claude mcp add. Дальше меняется только хвост в зависимости от типа сервера.

Локальный сервер (stdio) — самый частый случай

Формула: claude mcp add <имя> -- <команда запуска сервера>. Имя — любое, как тебе удобно его звать. После -- идёт команда, которой запускается сам сервер. Большинство серверов ставятся через npx (Node.js) и выглядят так:

Подключить GitHub-сервер
claude mcp add github -- npx -y @modelcontextprotocol/server-github

Если серверу нужен токен или ключ (а GitHub-серверу нужен), передаёшь его через флаг -e в виде КЛЮЧ=значение — он уйдёт серверу как переменная окружения:

GitHub-сервер с токеном доступа
claude mcp add github -e GITHUB_TOKEN=твой_токен -- npx -y @modelcontextprotocol/server-github

Для сервера файловой системы дополнительно указывают папку, к которой даёшь доступ — она идёт аргументом самой команды запуска:

Доступ к папке проекта
claude mcp add files -- npx -y @modelcontextprotocol/server-filesystem /путь/к/проекту

Удалённый сервер (SSE или HTTP)

Здесь вместо команды запуска ты передаёшь адрес и явно указываешь транспорт флагом --transport:

Удалённый сервер по SSE
claude mcp add --transport sse мойсервер https://example.com/mcp

Если удалённый сервер требует входа, он попросит авторизацию: набираешь /mcp в сессии Claude Code, видишь свой сервер со статусом «нужна авторизация» и проходишь вход (обычно OAuth — через браузер). После этого токен сохраняется, и сервер работает.

Проверить, посмотреть, удалить

Три служебные команды, которые нужны постоянно:

КомандаЧто делает
claude mcp listПоказать все подключённые серверы
claude mcp get <имя>Подробности конкретного сервера: команда, транспорт, scope
claude mcp remove <имя>Отключить сервер
/mcp (в сессии)Статус серверов и авторизация — прямо из Claude Code

Есть ещё два удобства. Если конфигурацию сервера тебе дали готовым JSON (так часто публикуют в документации сервисов), не разбирай его руками — добавь целиком: claude mcp add-json <имя> '<json>'. А если ты уже настраивал MCP-серверы в приложении Claude Desktop, перетащи их в Claude Code одной командой claude mcp add-from-claude-desktop — она подхватит то, что уже описано, и спросит, что добавить.

  1. Подключи. claude mcp add <имя> -- <команда> (или --transport для удалённого).
  2. Проверь. Открой сессию, набери /mcp — статус должен быть «connected».
  3. Используй. Проси Claude задачу, которая требует этого инструмента, — он вызовет сервер сам.

Уровни доступа: local, project, user

Один из главных вопросов, на котором путаются: «я подключил сервер — а где он теперь доступен?». Это решает scope (уровень видимости), и его задают флагом -s при добавлении. Уровня три.

ScopeГде доступенДля чего
local (по умолчанию)Только в текущем проекте, только у тебяЛичные эксперименты, временные серверы
projectВ этом проекте, у всех — конфиг едет в gitОбщие инструменты команды на проекте
userВо всех твоих проектах на этой машинеТо, что нужно всегда: поиск, файлы

Самый интересный здесь — project. Когда ты добавляешь сервер с -s project, его конфигурация пишется в файл .mcp.json в корне репозитория. Этот файл коммитится в git, и значит любой, кто склонирует проект, получит те же подключённые серверы. Это способ один раз настроить инструменты для всей команды, а не объяснять каждому, что куда вписать.

Сервер на весь проект (в .mcp.json)
claude mcp add -s project files -- npx -y @modelcontextprotocol/server-filesystem .

Логика выбора простая. Инструмент нужен только тебе и только здесь — оставляй local (это и так по умолчанию). Инструмент должен быть у всех на проекте — project, чтобы уехал в репозиторий. Инструмент нужен тебе всегда и везде (например, веб-поиск) — user, и он подключится глобально.

Не клади секреты в .mcp.json напрямую

Поскольку project-конфиг едет в git, не вписывай туда боевые токены в открытом виде — иначе они утекут в репозиторий. Передавай ключи через переменные окружения, а в общий конфиг клади только то, что не страшно показать команде. Это та же гигиена, что и с любыми секретами в коде.

Полезные серверы, с которых начать

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

1. Файловая система

Даёт Claude управляемый доступ к конкретной папке за пределами текущего проекта — читать и (если разрешишь) писать. Нужен, когда работаешь сразу с несколькими директориями или хочешь явно ограничить, куда Claude может лезть. Ставится через server-filesystem с указанием пути.

2. GitHub

Один из самых полезных. Claude сам читает issue и pull request'ы, смотрит код в репозитории, создаёт ветки и PR. Когда ведёшь проект на GitHub, это убирает половину переключений в браузер. Нужен токен доступа — передаёшь через -e.

3. Браузер (Playwright / Puppeteer)

Даёт Claude глаза и руки в браузере: открыть страницу, кликнуть, заполнить форму, снять состояние. Незаменимо, когда собираешь лендинг или интерфейс и хочешь, чтобы Claude сам проверял результат, а не верил твоему пересказу. Особенно мощно в связке «собрал страницу → Claude сам открыл и проверил вёрстку».

4. База данных (PostgreSQL и другие)

Подключаешь строку соединения — и Claude выполняет запросы к твоей базе, смотрит схему, проверяет данные. Для любого проекта с базой это разница между «опиши мне структуру таблиц» и «Claude, сам посмотри и скажи, чего не хватает».

5. Веб-поиск

Даёт доступ к актуальной информации из интернета — то, чего модели по умолчанию не хватает. Полезно держать на уровне user, чтобы поиск был во всех проектах. Серверов поиска несколько (например, на базе Brave Search) — выбираешь под себя.

Где брать серверы и не нарваться

Официальные серверы публикуются под неймспейсом @modelcontextprotocol/server-* — с них и начинай. Дальше есть каталоги и репозитории сообщества, но к ним относись как к чужому коду: смотри, кто автор и сколько у проекта звёзд, прежде чем давать доступ к данным. Подробнее про доверие — в разделе ниже.

Если не подключается: диагностика /mcp

Сервер добавил, а он не работает — нормальная ситуация на старте. Чинится почти всегда быстро, если идти по порядку, а не паниковать.

  1. Набери /mcp в сессии. Это первое действие. Команда покажет каждый сервер и его статус: connected (всё хорошо), failed (не поднялся) или «нужна авторизация».
  2. Статус «нужна авторизация» → пройди вход. Для удалённых серверов это частый случай: прямо из /mcp запускаешь авторизацию (OAuth через браузер), и сервер оживает.
  3. Статус failed → проверь команду запуска. Посмотри сохранённый конфиг через claude mcp get <имя> и выполни ту же команду запуска вручную в терминале — она покажет настоящую ошибку.

Самые частые причины failed и что с ними делать:

СимптомПричинаРешение
«command not found», сервер не стартуетНе установлен Node.js или npxПоставь Node.js, проверь npx -v в терминале
Сервер падает с ошибкой доступаНе передан обязательный токенДобавь ключ через -e КЛЮЧ=значение
Сервер просто не находитсяОпечатка в имени пакета или командеСверь команду запуска с документацией сервера
Удалённый сервер «отказано»Не пройдена авторизацияЗайди в /mcp и авторизуйся

Золотое правило диагностики: выполни команду запуска сервера напрямую в терминале. Claude Code запускает ровно её — и если она падает у тебя в консоли, ты сразу видишь причину открытым текстом, без догадок. Девять из десяти проблем — это либо отсутствующий пакет, либо непереданный токен.

Безопасность: чему ты даёшь доступ

Тема, которую новички проскакивают, а зря. MCP-сервер получает ровно те права, которые ты ему выдал: доступ к папке, токен GitHub, строку подключения к боевой базе. Это мощно — и поэтому требует головы.

Два риска, которые стоит держать в уме. Первый — источник сервера. Ты запускаешь чужой код, который получит доступ к твоим данным. Официальные серверы Anthropic и проверенные репозитории — это одно, случайный сервер с двумя звёздами на GitHub — совсем другое. Второй — prompt injection: сервер, который и читает веб, и пишет в твои системы, теоретически может выполнить нежелательное действие по команде, спрятанной во вредоносном контенте на странице. Звучит экзотично, но это реальный класс проблем.

  1. Ставь серверы из доверенных источников. Начинай с официальных @modelcontextprotocol, остальное — после проверки автора.
  2. Давай минимум прав. Доступ к нужной папке, а не ко всему диску. Тестовый токен, где хватает тестового.
  3. Отдельные ключи под Claude. Заведи токен специально для MCP, чтобы при чём что — отозвать только его, не ломая остальное.
  4. Осторожно с «веб + запись» в одном. Сервер, который и лазит в интернет, и пишет в твои системы, — самый рискованный, относись внимательнее.
Правило одно: MCP-сервер — это не магия, а программа с твоими ключами в руках. Дай ей ровно столько доступа, сколько нужно для задачи, и ни ключом больше.
А дальше — зачем всё это

Подключив серверы, ты дашь Claude руки в своих системах — и собирать на нём что-то реальное станет в разы быстрее. Но руки сами по себе денег не приносят. Куда направить эту мощь, чтобы вечера в терминале превращались в продукт, — разбираем по шагам на практикуме. Об этом — в финале.

С чего начать на этой неделе

Чтобы это не осталось теорией, вот короткий план. После него MCP перестанет быть страшной аббревиатурой и станет обычным рабочим инструментом.

  1. Подключи один сервер. Начни с GitHub или браузера — то, что ближе к твоей работе. Одна команда claude mcp add.
  2. Проверь через /mcp. Убедись, что статус connected. Если нет — пройди по диагностике выше, это 5 минут.
  3. Дай Claude задачу под этот сервер. «Покажи открытые issue» или «открой эту страницу и проверь вёрстку». Почувствуй, как он делает это сам.
  4. Реши, что сделать глобальным. То, что нужно всегда (поиск, файлы), переподключи с -s user.
  5. Если работаешь в команде — вынеси общее в .mcp.json. Добавь сервер с -s project, закоммить — у всех появится тот же инструмент.

Не пытайся подключить всё сразу. Один-два сервера, доведённые до автоматизма, дадут больше, чем десяток подключённых «на всякий случай», в которых ты путаешься. Расширишь набор, когда упрёшься в конкретную нехватку.

Зачем это всё на самом деле

А теперь честный разворот, ради которого всё затевалось. Можно подключить десяток MCP-серверов, дать Claude доступ ко всему — к GitHub, базе, браузеру, поиску — и остаться ровно там же, где был. Потому что обвязка инструментами — это не цель. Это мощность станка. И сама по себе она не приносит ни копейки.

У большинства всё так и застывает: человек освоил Claude Code, подключил MCP, собрал бота или лендинг с доступом к чему угодно — и оно лежит в папке. Вечера потрачены, навык реально крутой, а денег ноль. Это вайбкодинг в пустоту: ты кодишь, оно работает, тебе нравится — но это игрушка для себя, а не продукт для рынка.

Ловушка, в которой застревают 9 из 10

«Умею работать с ИИ» и «зарабатываю на ИИ» — две разные вселенные, и между ними пропасть. Освоить инструмент, подключить все серверы, отполировать каждую интеграцию легко — это делают тысячи. Превратить навык в актив, который приносит деньги, — почти никто. Не потому что сложно, а потому что дальше «прикольно получилось» мысль не идёт.

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

И вот тут появляется самое сильное направление — цифровой продукт без лица. Ты упаковываешь то, что научился собирать, в продукт, который продаётся много раз: без блога, без съёмок, без тебя в кадре. Лендинг, оффер, приём оплаты, нужные интеграции — собирается тем же Claude за тот же вечер. Один раз собрал — продаётся в фоне, пока ты делаешь следующий. А подключённые MCP-серверы работают на тебя напрямую: чем больше Claude умеет доставать и делать сам, тем быстрее и дешевле ты собираешь каждый следующий продукт.

Я зарабатываю не на том, что у меня подключён красивый стек MCP-серверов. Я зарабатываю на продуктах, собранных в Claude. Инструменты — это мощность станка. Без продукта станок крутится вхолостую, сколько серверов к нему ни подключи.
MCP даётруки Claude Собираешьбыстро Лендингили сервис Продажибез лица
Чем больше Claude умеет сам через MCP, тем быстрее ты собираешь продукт без лица. Серверы — это мощность станка, а не финиш.

Дальше у тебя два пути — и оба ведут к своему продукту. Разница в скорости и в том, сколько шишек набьёшь по дороге.

Путь 1 — сам

Разбираться по крупицам

  • Месяцами собирать процесс по гайдам
  • Самому искать, что и как продавать
  • Дойти реально, но дольше и через ошибки
Путь 2 — со мной

Собрать за 3 вечера на практикуме

  • Настраиваем Claude под твой продукт
  • Собираем продукт без лица по шагам
  • Доводим до лендинга и первой продажи
Прийти на практикум · 2 000 ₽

Частые вопросы

Что такое MCP в Claude Code простыми словами?

MCP (Model Context Protocol) — открытый стандарт, по которому Claude Code подключается к внешним инструментам и данным: файлам, GitHub, базе, браузеру, поиску. MCP-сервер — маленькая программа-переходник, которая умеет что-то конкретное и описывает Claude свои возможности на общем языке. Claude Code — это MCP-клиент: подключаешь сервер один раз, и его инструменты появляются у Claude прямо в диалоге. Смысл — дать модели руки за пределами чата по единому протоколу.

Как подключить MCP-сервер в Claude Code?

Базовая команда — claude mcp add <имя> -- <команда запуска>. Например, claude mcp add github -- npx -y @modelcontextprotocol/server-github. Для удалённого сервера: claude mcp add --transport sse <имя> <url> или --transport http. Ключи передаются через -e КЛЮЧ=значение. После добавления проверь подключение командой /mcp в сессии — она покажет статус и предложит авторизацию, где нужен вход.

Чем отличаются scope local, project и user?

local (по умолчанию) — сервер виден только в текущем проекте и только тебе. project — конфиг пишется в .mcp.json в корне репозитория и едет в git, поэтому сервер доступен всем на проекте. user (глобальный) — сервер работает во всех твоих проектах на этой машине. Scope задаётся флагом -s: например, claude mcp add -s project <имя> -- <команда>.

MCP-сервер не подключается — что делать?

Набери /mcp — увидишь статус: connected, failed или «нужна авторизация». При failed частые причины: не установлен Node.js или нужный пакет, опечатка в команде, не передан токен через -e, либо удалённый сервер требует входа. Посмотри конфиг через claude mcp get <имя> и выполни команду запуска сервера напрямую в терминале — она покажет настоящую ошибку. Чаще всего дело в отсутствующем пакете или токене.

Это безопасно — подключать MCP-серверы?

Сервер получает ровно те права, что ты ему дал: доступ к папке, токен, строку подключения к базе. Поэтому ставь серверы из доверенных источников (официальные @modelcontextprotocol и проверенные репозитории), давай минимум прав, заводи отдельные токены под Claude и будь внимателен с серверами, которые одновременно читают веб и пишут в твои системы (риск prompt injection). Минимум доступа — главное правило.

Можно ли перенести серверы из Claude Desktop?

Да. Если ты настроил MCP-серверы в приложении Claude Desktop, не прописывай их заново — выполни claude mcp add-from-claude-desktop. Команда подхватит уже описанные серверы, и ты выберешь, какие добавить в Claude Code. Удобно, когда настройка уже выстрадана в десктопе.

Хочешь, чтобы вечера в Claude Code превращались в деньги?

На практикуме за 3 вечера настраиваем Claude под тебя, собираем цифровой продукт без лица и доводим до лендинга и первой продажи. Онлайн, запись остаётся навсегда.

Пройти практикум за 2 000 ₽
Матвей Абрамов
Матвей Абрамов
Профессионально монетизирую Claude

Собираю цифровые продукты без лица на нейросетях и довожу до продаж. В блоге и канале — разборы по Claude и вайбкодингу и то, как на этом строить деньги, без инфоцыганщины.

Собери продукт без лица за 3 вечера на практикуме
2 000 ₽ →
{TAG}