MCP-серверы для Claude Code: что это и как подключить
Ты сидишь в Claude Code и упираешься в стену: он отлично пишет код, но не может сам сходить в твой GitHub, выполнить запрос к базе, проверить страницу в браузере или поискать в интернете. Каждый раз ты руками копируешь данные туда-сюда — выгружаешь логи, вставляешь содержимое таблицы, пересказываешь, что лежит в репозитории. MCP закрывает ровно эту дыру: он даёт Claude руки за пределами чата. Ниже — что такое MCP-серверы простыми словами, как они устроены, как подключить любой сервер одной командой claude mcp add, чем отличаются уровни local, project и user, какие серверы поставить первыми и что делать, если не подключается. А в конце — к чему вся эта обвязка ведёт на самом деле и почему именно она превращает 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: клиент, сервер, транспорт
Чтобы подключать серверы осознанно, а не копипастом, держи в голове три понятия. Их всего три, и они объясняют почти всё, что ты увидишь в командах.
- Клиент. Это сам Claude Code. Он умеет говорить на языке MCP и вызывать инструменты, которые ему отдают серверы. Клиент — всегда на твоей стороне.
- Сервер. Это та самая программа-переходник под конкретный инструмент:
server-github,server-filesystem, сервер браузера и так далее. Один сервер — один набор возможностей. - Транспорт. Это способ, которым клиент и сервер общаются. Их три, и именно транспорт определяет, какой командой ты подключаешь сервер.
Транспорты разобьём отдельно, потому что на них спотыкаются чаще всего:
| Транспорт | Что это | Когда |
|---|---|---|
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-серверу нужен), передаёшь его через флаг -e в виде КЛЮЧ=значение — он уйдёт серверу как переменная окружения:
Для сервера файловой системы дополнительно указывают папку, к которой даёшь доступ — она идёт аргументом самой команды запуска:
Удалённый сервер (SSE или HTTP)
Здесь вместо команды запуска ты передаёшь адрес и явно указываешь транспорт флагом --transport:
Если удалённый сервер требует входа, он попросит авторизацию: набираешь /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 — она подхватит то, что уже описано, и спросит, что добавить.
- Подключи.
claude mcp add <имя> -- <команда>(или--transportдля удалённого). - Проверь. Открой сессию, набери
/mcp— статус должен быть «connected». - Используй. Проси Claude задачу, которая требует этого инструмента, — он вызовет сервер сам.
Уровни доступа: local, project, user
Один из главных вопросов, на котором путаются: «я подключил сервер — а где он теперь доступен?». Это решает scope (уровень видимости), и его задают флагом -s при добавлении. Уровня три.
| Scope | Где доступен | Для чего |
|---|---|---|
local (по умолчанию) | Только в текущем проекте, только у тебя | Личные эксперименты, временные серверы |
project | В этом проекте, у всех — конфиг едет в git | Общие инструменты команды на проекте |
user | Во всех твоих проектах на этой машине | То, что нужно всегда: поиск, файлы |
Самый интересный здесь — project. Когда ты добавляешь сервер с -s project, его конфигурация пишется в файл .mcp.json в корне репозитория. Этот файл коммитится в git, и значит любой, кто склонирует проект, получит те же подключённые серверы. Это способ один раз настроить инструменты для всей команды, а не объяснять каждому, что куда вписать.
Логика выбора простая. Инструмент нужен только тебе и только здесь — оставляй local (это и так по умолчанию). Инструмент должен быть у всех на проекте — project, чтобы уехал в репозиторий. Инструмент нужен тебе всегда и везде (например, веб-поиск) — user, и он подключится глобально.
Поскольку 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
Сервер добавил, а он не работает — нормальная ситуация на старте. Чинится почти всегда быстро, если идти по порядку, а не паниковать.
- Набери
/mcpв сессии. Это первое действие. Команда покажет каждый сервер и его статус:connected(всё хорошо),failed(не поднялся) или «нужна авторизация». - Статус «нужна авторизация» → пройди вход. Для удалённых серверов это частый случай: прямо из
/mcpзапускаешь авторизацию (OAuth через браузер), и сервер оживает. - Статус
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: сервер, который и читает веб, и пишет в твои системы, теоретически может выполнить нежелательное действие по команде, спрятанной во вредоносном контенте на странице. Звучит экзотично, но это реальный класс проблем.
- Ставь серверы из доверенных источников. Начинай с официальных
@modelcontextprotocol, остальное — после проверки автора. - Давай минимум прав. Доступ к нужной папке, а не ко всему диску. Тестовый токен, где хватает тестового.
- Отдельные ключи под Claude. Заведи токен специально для MCP, чтобы при чём что — отозвать только его, не ломая остальное.
- Осторожно с «веб + запись» в одном. Сервер, который и лазит в интернет, и пишет в твои системы, — самый рискованный, относись внимательнее.
Правило одно: MCP-сервер — это не магия, а программа с твоими ключами в руках. Дай ей ровно столько доступа, сколько нужно для задачи, и ни ключом больше.
Подключив серверы, ты дашь Claude руки в своих системах — и собирать на нём что-то реальное станет в разы быстрее. Но руки сами по себе денег не приносят. Куда направить эту мощь, чтобы вечера в терминале превращались в продукт, — разбираем по шагам на практикуме. Об этом — в финале.
С чего начать на этой неделе
Чтобы это не осталось теорией, вот короткий план. После него MCP перестанет быть страшной аббревиатурой и станет обычным рабочим инструментом.
- Подключи один сервер. Начни с GitHub или браузера — то, что ближе к твоей работе. Одна команда
claude mcp add. - Проверь через
/mcp. Убедись, что статусconnected. Если нет — пройди по диагностике выше, это 5 минут. - Дай Claude задачу под этот сервер. «Покажи открытые issue» или «открой эту страницу и проверь вёрстку». Почувствуй, как он делает это сам.
- Реши, что сделать глобальным. То, что нужно всегда (поиск, файлы), переподключи с
-s user. - Если работаешь в команде — вынеси общее в
.mcp.json. Добавь сервер с-s project, закоммить — у всех появится тот же инструмент.
Не пытайся подключить всё сразу. Один-два сервера, доведённые до автоматизма, дадут больше, чем десяток подключённых «на всякий случай», в которых ты путаешься. Расширишь набор, когда упрёшься в конкретную нехватку.
Зачем это всё на самом деле
А теперь честный разворот, ради которого всё затевалось. Можно подключить десяток MCP-серверов, дать Claude доступ ко всему — к GitHub, базе, браузеру, поиску — и остаться ровно там же, где был. Потому что обвязка инструментами — это не цель. Это мощность станка. И сама по себе она не приносит ни копейки.
У большинства всё так и застывает: человек освоил Claude Code, подключил MCP, собрал бота или лендинг с доступом к чему угодно — и оно лежит в папке. Вечера потрачены, навык реально крутой, а денег ноль. Это вайбкодинг в пустоту: ты кодишь, оно работает, тебе нравится — но это игрушка для себя, а не продукт для рынка.
«Умею работать с ИИ» и «зарабатываю на ИИ» — две разные вселенные, и между ними пропасть. Освоить инструмент, подключить все серверы, отполировать каждую интеграцию легко — это делают тысячи. Превратить навык в актив, который приносит деньги, — почти никто. Не потому что сложно, а потому что дальше «прикольно получилось» мысль не идёт.
Вся суть в одном: и Claude, и MCP-серверы — это инструмент, а не цель. Цель — не красиво подключённый стек, а продукт, который продаётся. И всё, что ты освоил выше, ценно ровно тем, что на этом станке ты за вечер собираешь не игрушку, а продаваемую вещь: лендинг с оффером, бота-продавца, мини-сервис, который сам ходит в нужные системы через MCP.
И вот тут появляется самое сильное направление — цифровой продукт без лица. Ты упаковываешь то, что научился собирать, в продукт, который продаётся много раз: без блога, без съёмок, без тебя в кадре. Лендинг, оффер, приём оплаты, нужные интеграции — собирается тем же Claude за тот же вечер. Один раз собрал — продаётся в фоне, пока ты делаешь следующий. А подключённые MCP-серверы работают на тебя напрямую: чем больше Claude умеет доставать и делать сам, тем быстрее и дешевле ты собираешь каждый следующий продукт.
Я зарабатываю не на том, что у меня подключён красивый стек MCP-серверов. Я зарабатываю на продуктах, собранных в Claude. Инструменты — это мощность станка. Без продукта станок крутится вхолостую, сколько серверов к нему ни подключи.
Дальше у тебя два пути — и оба ведут к своему продукту. Разница в скорости и в том, сколько шишек набьёшь по дороге.
Разбираться по крупицам
- Месяцами собирать процесс по гайдам
- Самому искать, что и как продавать
- Дойти реально, но дольше и через ошибки
Собрать за 3 вечера на практикуме
- Настраиваем Claude под твой продукт
- Собираем продукт без лица по шагам
- Доводим до лендинга и первой продажи
Частые вопросы
Что такое 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 ₽Была статья полезной?
Матвей Абрамов