Каждый день в Telegram-канале - что нового в вайб-кодинге: инструменты, кейсы, ошибки. Подпишись, чтобы быть в курсе.
Что такое MCP-сервер и зачем он Claude Code?
Anthropic анонсировал MCP 25 ноября 2024 года как открытый стандарт. За год протокол стал индустриальным: его поддерживают OpenAI, Google DeepMind и Microsoft. В официальном репозитории modelcontextprotocol/servers лежат reference-серверы от Anthropic (Filesystem, Memory, Sequential Thinking, Fetch и другие); вендоры - GitHub, Notion, Stripe, Linear, Cloudflare, Sentry - публикуют MCP-серверы в собственных репозиториях. Общее число серверов исчисляется тысячами в community-индексах.
Технически MCP работает поверх JSON-RPC 2.0. Архитектура простая: твой Claude Code = клиент, любой сервис = сервер, между ними MCP-сервер с тремя сущностями - tools (что ИИ может вызвать), resources (что ИИ может прочитать), prompts (готовые шаблоны).
Подобно тому, как USB-C даёт стандартный способ подключать устройства к разной периферии, MCP даёт стандартный способ подключать ИИ-модели к разным источникам данных и инструментам.
Зачем это вайб-кодеру: до MCP каждое подключение Claude к стороннему сервису было отдельной интеграцией с собственной обёрткой. С MCP подключение Postgres, Slack и GitHub занимает три однотипные команды и одинаково снимается, когда сервис больше не нужен.
Чем MCP отличается от Skills и Subagents?
Простая таблица, чтобы держать различия в голове:
| Механизм | Что это | Когда брать | Цена в токенах |
|---|---|---|---|
| Skill | Файл с инструкцией и промптами в .claude/skills/ | Сценарий повторяется: написать письмо, собрать отчёт, выпустить пост | Низкая. Загружается по триггеру |
| Subagent | Отдельный агент со своим контекстом и инструментами | Долгая параллельная задача: ревью, аудит, исследование | Средняя. Свой контекст |
| MCP-сервер | Сервис с tools/resources поверх JSON-RPC | Нужен живой доступ к данным: БД, почта, мессенджер, репозиторий | Высокая. Инструменты висят в контексте постоянно |
Практический вывод: если задача однажды сформулирована и повторяется текстом - это skill. Если ИИ нужен живой ответ из внешней системы - это MCP. Если задача длинная, ветвистая и нужен отдельный мозг - это subagent.
Подробнее о двух соседних механизмах: Claude Code Skills: как собрать библиотеку под себя и Claude Code Subagents: 5 готовых примеров.
Как установить MCP-сервер: первая команда за 5 минут
Полный синтаксис из официальной документации:
claude mcp add <name> [options] -- <command> [args...]Поддерживаются три транспорта - --transport stdio (по умолчанию, локальный процесс), --transport http (удалённый HTTP) и --transport sse (помечен как deprecated, использовать только если сервер ещё не мигрировал).
Поддерживаются три области видимости через флаг --scope:
local- только в текущей папке проекта (по умолчанию).project- пишется в.mcp.json, коммитится в репозиторий, доступен всей команде.user- глобально для всех проектов на машине.
Минимальный пример с Filesystem-сервером Anthropic. Запускается за полминуты:
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/me/projects
claude mcp listПосле list ты увидишь filesystem в списке. Запускаешь Claude Code - он умеет читать и писать файлы в указанной папке через MCP-инструменты, а не через свой Read/Write.
Проверка, что MCP подключился: команда /mcp внутри сессии Claude Code покажет все серверы, их статус и список инструментов.
stdio или HTTP: какой transport выбрать?
Сравнение по основным критериям:
| Критерий | stdio | HTTP |
|---|---|---|
| Где запускается | Локально (процесс-ребёнок Claude Code) | Удалённый сервер |
| Авторизация | Не нужна | OAuth 2.1 или Bearer-токен |
| Сетевые порты | Нет | Открытый адрес |
| Где применяется | Filesystem, Postgres, локальные утилиты | GitHub, Slack, Notion, Linear, Sentry |
| Переподключение | Не нужно | Exponential backoff, до 5 попыток |
| Развёртывание | Локальная установка пакета | Сервис вендора |
Практическое правило: всё, что лежит у тебя на диске или в локальной БД - stdio. Всё, что в облаке - HTTP. SSE официально устаревший, его не выбирай.
7 готовых MCP-серверов для предпринимателя
5.1. GitHub MCP - официальный сервер от GitHub
Что делает: даёт Claude Code доступ к issues, pull request'ам, файлам репозитория, action runs. Сервер опенсорсный, 30+ тысяч звёзд на GitHub.
Установка (HTTP, через OAuth):
claude mcp add --transport http github https://api.githubcopilot.com/mcp/Альтернативно - stdio через Docker, если нужен PAT-токен вместо OAuth.
Пример: «Прочитай open issues с лейблом bug, сгруппируй по компонентам, предложи в каком порядке закрывать». Claude дёрнет GitHub MCP, прочитает все issue и вернёт приоритезированный список.
Репозиторий: github/github-mcp-server.
5.2. Filesystem MCP - официальный референс от Anthropic
Что делает: даёт Claude доступ к локальной файловой системе с ограничением по разрешённым папкам. Полезно, когда нужно работать с файлами вне текущего проекта - например, читать дизайн-макеты из отдельной папки или собирать материалы из архива.
Установка (stdio):
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/me/projects /Users/me/Documents/designУказывай только те папки, к которым реально нужен доступ. Не давай корень диска - это первая дыра в безопасности.
Пример: «Перенеси все макеты из ~/Documents/design/landing-v3/ в текущий проект, переименуй по соглашению hero-*.png».
5.3. Postgres MCP - DBHub (Bytebase)
Что делает: подключает Claude к Postgres, MySQL, SQL Server, MariaDB или SQLite. Поддерживает read-only режим, чтобы ИИ-агент не дропнул базу одной командой. Часто используется как замена архивированному reference-серверу server-postgres от Anthropic.
Установка (HTTP, read-only):
claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonlyДля прод-базы - обязательно отдельный user с read-only грантами и обезличиванием персональных данных через VIEW или промежуточный API-роут. Не подключай прод-БД с правами write.
Пример: «Сделай выборку клиентов с подпиской expired за последний месяц, выведи топ-20 по сумме всех платежей».
Репозиторий: bytebase/dbhub.
5.4. Slack MCP - общение с командой
Что делает: даёт Claude чтение каналов и отправку сообщений в Slack. Удобно для автоматизации: «Когда сборка прошла, напиши в #releases», «Собери сводку за неделю из #engineering».
Установка (stdio через npx-обёртку, например @modelcontextprotocol/server-slack или вендорский аналог):
claude mcp add slack \
-e SLACK_BOT_TOKEN=xoxb-... \
-e SLACK_TEAM_ID=T0... \
-- npx -y @modelcontextprotocol/server-slackАвторизация - через Slack Bot Token, доступ ограничивается scope'ами на стороне Slack. Можно дать ИИ только chat:read и chat:write:user - тогда он не сможет редактировать настройки рабочего пространства. Актуальные команды смотри в README выбранного сервера, экосистема быстро меняется.
Пример: «Каждое утро в 9:00 присылай в #daily список вчерашних merged PR».
5.5. Notion MCP - база знаний
Что делает: открывает Claude доступ к страницам и базам данных Notion. Это второй мозг вне business/-папки - если у тебя там лежат заметки, реестр клиентов или редполитика, ИИ может их читать.
Установка (HTTP, через OAuth):
claude mcp add --transport http notion https://mcp.notion.com/mcpАльтернативно - официальный плагин Anthropic @makenotion/claude-code-notion-plugin.
Пример: «Найди в Notion базе «Клиенты» всех, у кого статус «активный» и не было созвона больше 2 недель. Сделай черновик письма каждому».
Гайд от Notion: developers.notion.com/guides/mcp.
5.6. Sentry MCP - отслеживание ошибок
Что делает: подключает Claude к ошибкам твоего прода. Когда страница падает с 500, можно спросить «Покажи последние 10 issue в Sentry по проекту, объясни корень каждой» - и сразу получить разбор.
Установка (HTTP):
claude mcp add --transport http sentry https://mcp.sentry.dev/mcpАвторизация через OAuth Sentry. Доступ можно ограничить конкретным проектом.
Пример: «Возьми три самых частых issue за последние сутки. Объясни мне на пальцах, что произошло, и подскажи, как чинить».
Репозиторий: getsentry/sentry-mcp.
5.7. Playwright MCP - браузерные сценарии
Что делает: даёт Claude браузер. ИИ может открыть страницу, кликнуть, заполнить форму, сделать скриншот. Полезно для UI-проверок, ручного теста после публикации, парсинга сценариев.
Установка (stdio):
claude mcp add playwright -- npx -y @playwright/mcp@latestВерсия v0.0.75 от 7 мая 2026, активно поддерживается Microsoft (32+ тысячи звёзд).
Пример: «Открой главную страницу нашего сайта, проверь что все карточки отображаются корректно, сделай скриншот на десктопе и мобильном».
Репозиторий: microsoft/playwright-mcp. Подробный обзор от Simon Willison: til.simonwillison.net/claude-code/playwright-mcp-claude-code.
Хочешь не просто подключить семь серверов, а собрать связку, которая делает Claude самостоятельным сотрудником? MCP - это часть контекст-инжиниринга: внешние инструменты, через которые ИИ видит мир. На практикуме за 3 эфира собираешь все три кита: ИИ-клон (Skills + своя методология) + Второй мозг (business/-папка) + Контекст-инжиниринг (MCP, Plan Mode, /compact). Связка, без которой ИИ галлюцинирует.
Как контролировать безопасность через PreToolUse hook?
Конфиг кладётся в .claude/settings.json:
{
"hooks": {
"PreToolUse": [
{
"matcher": "mcp__postgres__.*",
"hooks": [
{ "type": "command", "command": ".claude/hooks/allowlist-mcp.sh" }
]
}
]
}
}Скрипт allowlist-mcp.sh читает входной JSON со stdin, решает что делать, и возвращает решение тем же JSON:
#!/bin/bash
INPUT=$(cat)
TOOL=$(echo "$INPUT" | jq -r '.tool_name')
QUERY=$(echo "$INPUT" | jq -r '.tool_input.query // empty')
if [[ "$QUERY" =~ ^(DROP|TRUNCATE|DELETE) ]]; then
echo '{"decision":"block","reason":"Запрещены разрушительные SQL-запросы"}'
exit 0
fi
echo '{"decision":"approve"}'Что закрывает hook:
DROP TABLE,TRUNCATE,DELETE FROM ... WHERE 1=1через Postgres MCP.- Отправка сообщений в общие каналы Slack без явного подтверждения.
- Чтение
.env-файлов через Filesystem MCP. - Любые операции с пометкой «write» на сервисах с критичными данными.
Готовый рабочий шаблон с десятком хуков - disler/claude-code-hooks-mastery. Этот же подход подробнее в гайде Plan Mode в Claude Code - там аналогичная логика «проверь до того, как выполнить».
Что делать, если набралось 40+ инструментов и Claude теряется?
В Claude Code появился Tool Search. По замерам Scott Spence, режим режет контекст с 14 214 до 5 663 токенов - экономия около 60% на сессию.
Включается через ENV-переменную:
export ENABLE_TOOL_SEARCH=autoРежимы:
false- старое поведение, все инструменты постоянно в контексте.true- поиск всегда включён.auto- Claude сам решает, когда подгружать определения инструментов.auto:N- то же, но с явным порогом N инструментов, после которого включается поиск.
Для критичных tools, которые должны быть видны всегда, есть флаг alwaysLoad: true в .mcp.json рядом с описанием сервера.
Когда у тебя пять+ MCP-серверов и Claude путается какой инструмент звать - это первый кандидат на включение Tool Search.
Дополнительно полезно уменьшать контекст через /compact и архитектуру второго мозга.
Когда MCP не нужен: skill, subagent или CLI лучше?
Иерархия по цене токенов и сложности:
- CLI-команда через Bash - почти бесплатно. ИИ запускает
gh pr list,psql -c,curlи получает ответ как обычный пользователь терминала. - Skill - дёшево. Готовый промпт-шаблон с инструкцией, что вызвать и как обработать. Загружается по триггеру в имени папки.
- Subagent - средне. Отдельный контекст для длинной задачи, своя сессия токенов.
- MCP-сервер - дорого. Инструменты висят в контексте постоянно, плюс OAuth-сессия для HTTP.
Контр-интуитивный совет: для парсинга веб-страниц, работы с git, открытия PDF, обращения к open-source утилитам бери CLI, а не MCP. ИИ умеет вызывать команды в терминале не хуже человека, и токены при этом расходуются только на саму команду и ответ, а не на постоянное «висение» инструментов в контексте.
MCP оправдан в двух случаях:
- Сервис закрытый: Slack, Notion, Sentry, Linear. CLI-утилиты тоже есть, но через MCP получается тоньше - с OAuth и контролем scope'ов.
- Нужен живой двусторонний диалог: ИИ зашёл в Postgres, посмотрел схему, задал уточняющий запрос, получил данные, сделал следующий шаг. Через CLI это превратилось бы в 10 ручных команд.
6 антипаттернов подключения MCP
-
MCP-cabinet. Подключил 10 серверов «на всякий случай», все жрут контекст, Claude путается какой инструмент звать. Решение: оставить 3-5 серверов под текущий проект, остальные снимать через
claude mcp remove. -
Write-доступ к прод-БД. Подключил Postgres-MCP к прод-базе без
--readonly, без отдельного user'а, без allowlist-hook'а. Один промпт «удали тестовые записи» - и удалены боевые. Решение: read-only user + hook на blacklistDROP|TRUNCATE|DELETE. -
PII без обезличивания. Подключил БД с email, телефонами, паспортами клиентов напрямую. Claude видит данные, они попадают в логи Anthropic. Это нарушение 152-ФЗ. Решение: VIEW или промежуточный API-роут, который отдаёт данные с маской
j***@gmail.com. -
MCP вместо skill. Тебе нужно «составить отчёт по продажам в формате X» - это однообразная задача, она решается skill'ом с готовым промптом. Не плоди MCP-сервер.
-
MCP вместо open-source CLI. Тебе нужно сконвертировать PDF в текст. Есть
pdftotext. Не надо строить «PDF-MCP» - это лишний расход токенов. -
Не контролировать токеновый счёт. Подключённый сервер видно в
claude mcp list, но не видно сколько он жрёт в каждом диалоге. После недели работы у тебя нет понимания «MCP сжёг 40% контекста и я платил за это всё время». Решение: периодически отключать неиспользуемые и смотреть, как меняется счёт через контроль лимитов Claude Code.
Как отладить, если MCP не подключается?
Проверочный план по шагам:
-
Сервер виден в списке?
bashclaude mcp listЕсли нет -
claude mcp addне дошёл до конца. Чаще всего ошибка в--scope: добавил вlocal, а смотришь из другого проекта. -
Статус сервера зелёный?
bashclaude mcp status <name>Красный = процесс не запустился (для stdio) или сервер не ответил (для HTTP).
-
Логи сервера говорят что-то осмысленное?
bashclaude mcp logs <name>Видишь stack trace - обычно проблема с пакетом (
npxне нашёл, версия Node ниже 20). -
OAuth-возврат не возвращается? Проблема обычно в
--callback-portили сетевой фильтр'е. Прокинь конкретный порт:bashclaude mcp add --transport http --callback-port 8765 [name] [url] -
Конфликт имён tools? Два сервера выгружают tool с одним именем. Claude вызывает не тот. Лечится Tool Search (см. предыдущий H2) или ручным
claude mcp removeлишнего сервера. -
claude.ai расширения (connectors) не видны? Известная проблема - расширения (connectors) из веб-интерфейса claude.ai не доступны Claude Code, который ходит по API-ключу. Решение: подключать MCP именно через CLI, не через веб.
Что дальше: OAuth, свои MCP и Plugin Marketplace
Plugin Marketplace - ускорение для тех, кто не хочет вспоминать команды установки. Партнёры запуска: Dan Ávila, Seth Hobson, сама Anthropic. Формат - манифест .claude-plugin/marketplace.json, который описывает набор серверов в одном пакете.
Установка плагина из marketplace:
claude plugin install <plugin-name>Плагин может содержать несколько MCP-серверов, skill'ов и subagent'ов одновременно - это упакованная связка под конкретный сценарий: e-commerce, маркетинг, юр-отдел.
Свой MCP-сервер пишется по спецификации modelcontextprotocol.io. Минимальный шаблон - Python или TypeScript SDK от Anthropic, дальше - описать tools и подключить транспорт. Сложность сравнима с написанием REST API на FastAPI.
Если у тебя в проекте уже есть настроенный CLAUDE.md и понимание контекст-инжиниринга - добавление своего MCP занимает день. Без них - лучше сначала разобраться с базой.
Источники
- Model Context Protocol - официальный сайт
- Anthropic Introduces MCP - 25 ноября 2024
- Claude Code MCP documentation
- Claude Code Plugins announcement - 9 октября 2025
- Code with Claude 2026
- modelcontextprotocol/servers - официальный реестр
- github/github-mcp-server
- microsoft/playwright-mcp
- bytebase/dbhub - Postgres MCP
- getsentry/sentry-mcp
- makenotion/claude-code-notion-plugin
- disler/claude-code-hooks-mastery
- Notion MCP guide
- Simon Willison - Playwright MCP TIL
- Scott Spence - Optimising MCP server context usage
- Anthropic Claude Code repo - issues и changelog
Полная схема по вайб-кодингу за вечер: ИИ-клон + Второй мозг + Контекст-инжиниринг. 3 эфира, записи остаются у тебя.

