MCP-серверы Claude Code в 2026: 7 готовых связок и пошаговая установка

Опубликовано 22.05.202614 мин чтенияСредний
Футуристический USB-C порт в центре, от которого лучи света расходятся к иконкам цифровых сервисов.
Что узнаешь
  • Что такое MCP-сервер и почему Anthropic называет его «USB-C для ИИ»
  • Как установить первый MCP за 5 минут командой claude mcp add
  • 7 проверенных серверов: GitHub, Filesystem, Postgres, Slack, Notion, Sentry, Playwright
  • Когда брать MCP, а когда хватит skill или обычной CLI-команды
  • Как закрыть безопасность allowlist'ом через PreToolUse hook
Применить за 30 мин
Сэкономит 5 ч
Средний
41просмотров

Каждый день в 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 даёт стандартный способ подключать ИИ-модели к разным источникам данных и инструментам.

Model Context Protocol, https://modelcontextprotocol.io/

Зачем это вайб-кодеру: до 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 минут

Полный синтаксис из официальной документации:

bash
claude mcp add <name> [options] -- <command> [args...]

Поддерживаются три транспорта - --transport stdio (по умолчанию, локальный процесс), --transport http (удалённый HTTP) и --transport sse (помечен как deprecated, использовать только если сервер ещё не мигрировал).

Поддерживаются три области видимости через флаг --scope:

  • local - только в текущей папке проекта (по умолчанию).
  • project - пишется в .mcp.json, коммитится в репозиторий, доступен всей команде.
  • user - глобально для всех проектов на машине.

Минимальный пример с Filesystem-сервером Anthropic. Запускается за полминуты:

bash
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 выбрать?

Сравнение по основным критериям:

КритерийstdioHTTP
Где запускаетсяЛокально (процесс-ребёнок 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):

bash
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):

bash
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):

bash
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 или вендорский аналог):

bash
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):

bash
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):

bash
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Авторизация через OAuth Sentry. Доступ можно ограничить конкретным проектом.

Пример: «Возьми три самых частых issue за последние сутки. Объясни мне на пальцах, что произошло, и подскажи, как чинить».

Репозиторий: getsentry/sentry-mcp.

5.7. Playwright MCP - браузерные сценарии

Что делает: даёт Claude браузер. ИИ может открыть страницу, кликнуть, заполнить форму, сделать скриншот. Полезно для UI-проверок, ручного теста после публикации, парсинга сценариев.

Установка (stdio):

bash
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). Связка, без которой ИИ галлюцинирует.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - стек, метод, первый проект
Старт 26–28 мая  ·  2 000 ₽
Записаться →

Как контролировать безопасность через PreToolUse hook?

Конфиг кладётся в .claude/settings.json:

json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__postgres__.*",
        "hooks": [
          { "type": "command", "command": ".claude/hooks/allowlist-mcp.sh" }
        ]
      }
    ]
  }
}

Скрипт allowlist-mcp.sh читает входной JSON со stdin, решает что делать, и возвращает решение тем же JSON:

bash
#!/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-переменную:

bash
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 лучше?

Иерархия по цене токенов и сложности:

  1. CLI-команда через Bash - почти бесплатно. ИИ запускает gh pr list, psql -c, curl и получает ответ как обычный пользователь терминала.
  2. Skill - дёшево. Готовый промпт-шаблон с инструкцией, что вызвать и как обработать. Загружается по триггеру в имени папки.
  3. Subagent - средне. Отдельный контекст для длинной задачи, своя сессия токенов.
  4. MCP-сервер - дорого. Инструменты висят в контексте постоянно, плюс OAuth-сессия для HTTP.

Контр-интуитивный совет: для парсинга веб-страниц, работы с git, открытия PDF, обращения к open-source утилитам бери CLI, а не MCP. ИИ умеет вызывать команды в терминале не хуже человека, и токены при этом расходуются только на саму команду и ответ, а не на постоянное «висение» инструментов в контексте.

MCP оправдан в двух случаях:

  • Сервис закрытый: Slack, Notion, Sentry, Linear. CLI-утилиты тоже есть, но через MCP получается тоньше - с OAuth и контролем scope'ов.
  • Нужен живой двусторонний диалог: ИИ зашёл в Postgres, посмотрел схему, задал уточняющий запрос, получил данные, сделал следующий шаг. Через CLI это превратилось бы в 10 ручных команд.

6 антипаттернов подключения MCP

  1. MCP-cabinet. Подключил 10 серверов «на всякий случай», все жрут контекст, Claude путается какой инструмент звать. Решение: оставить 3-5 серверов под текущий проект, остальные снимать через claude mcp remove.

  2. Write-доступ к прод-БД. Подключил Postgres-MCP к прод-базе без --readonly, без отдельного user'а, без allowlist-hook'а. Один промпт «удали тестовые записи» - и удалены боевые. Решение: read-only user + hook на blacklist DROP|TRUNCATE|DELETE.

  3. PII без обезличивания. Подключил БД с email, телефонами, паспортами клиентов напрямую. Claude видит данные, они попадают в логи Anthropic. Это нарушение 152-ФЗ. Решение: VIEW или промежуточный API-роут, который отдаёт данные с маской j***@gmail.com.

  4. MCP вместо skill. Тебе нужно «составить отчёт по продажам в формате X» - это однообразная задача, она решается skill'ом с готовым промптом. Не плоди MCP-сервер.

  5. MCP вместо open-source CLI. Тебе нужно сконвертировать PDF в текст. Есть pdftotext. Не надо строить «PDF-MCP» - это лишний расход токенов.

  6. Не контролировать токеновый счёт. Подключённый сервер видно в claude mcp list, но не видно сколько он жрёт в каждом диалоге. После недели работы у тебя нет понимания «MCP сжёг 40% контекста и я платил за это всё время». Решение: периодически отключать неиспользуемые и смотреть, как меняется счёт через контроль лимитов Claude Code.

Как отладить, если MCP не подключается?

Проверочный план по шагам:

  1. Сервер виден в списке?

    bash
    claude mcp list

    Если нет - claude mcp add не дошёл до конца. Чаще всего ошибка в --scope: добавил в local, а смотришь из другого проекта.

  2. Статус сервера зелёный?

    bash
    claude mcp status <name>

    Красный = процесс не запустился (для stdio) или сервер не ответил (для HTTP).

  3. Логи сервера говорят что-то осмысленное?

    bash
    claude mcp logs <name>

    Видишь stack trace - обычно проблема с пакетом (npx не нашёл, версия Node ниже 20).

  4. OAuth-возврат не возвращается? Проблема обычно в --callback-port или сетевой фильтр'е. Прокинь конкретный порт:

    bash
    claude mcp add --transport http --callback-port 8765 [name] [url]
  5. Конфликт имён tools? Два сервера выгружают tool с одним именем. Claude вызывает не тот. Лечится Tool Search (см. предыдущий H2) или ручным claude mcp remove лишнего сервера.

  6. 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:

bash
claude plugin install <plugin-name>

Плагин может содержать несколько MCP-серверов, skill'ов и subagent'ов одновременно - это упакованная связка под конкретный сценарий: e-commerce, маркетинг, юр-отдел.

Свой MCP-сервер пишется по спецификации modelcontextprotocol.io. Минимальный шаблон - Python или TypeScript SDK от Anthropic, дальше - описать tools и подключить транспорт. Сложность сравнима с написанием REST API на FastAPI.

Если у тебя в проекте уже есть настроенный CLAUDE.md и понимание контекст-инжиниринга - добавление своего MCP занимает день. Без них - лучше сначала разобраться с базой.

Источники

Полная схема по вайб-кодингу за вечер: ИИ-клон + Второй мозг + Контекст-инжиниринг. 3 эфира, записи остаются у тебя.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - стек, метод, первый проект
Старт 26–28 мая  ·  2 000 ₽
Записаться →
Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные концепты