Настройка MCP в Claude Code в 2026 году: семь интеграций и установка

Дополнительные инструкции по работе с Ailoot доступны в документации.

Что представляет собой MCP-сервер и зачем он нужен Claude Code?#

Anthropic представила MCP как открытый стандарт 25 ноября 2024 года. За год протокол получил широкое распространение: его поддерживают OpenAI, Google DeepMind и Microsoft. В официальном репозитории проекта MCP modelcontextprotocol/servers размещены эталонные серверы, включая Filesystem, Memory, Sequential Thinking и Fetch. Вендоры, среди которых GitHub, Notion, Stripe, Linear, Cloudflare и Sentry, публикуют серверы MCP в собственных репозиториях. В общественных каталогах перечисляются тысячи серверов.

Техническая основа MCP — JSON-RPC 2.0. Схема проста: Claude Code выступает клиентом, внешний сервис — сервером, а сервер MCP предоставляет три вида возможностей: tools — вызываемые ИИ инструменты, resources — доступные для чтения данные и prompts — готовые шаблоны.

Для вайб-кодинга MCP упрощает интеграции: раньше для подключения Claude к каждому внешнему сервису требовалась отдельная обёртка. Теперь Postgres, Slack и GitHub подключаются командами одной формы; ненужную интеграцию можно так же просто удалить.

Чем MCP отличается от Skills и Subagents?#

Сравнить назначение механизмов поможет таблица:

Практическое правило такое: повторяемую текстовую процедуру оформляй как skill. Если нужен актуальный ответ из внешней системы — подключай MCP. Для долгой задачи с множеством этапов и отдельным контекстом подойдёт subagent.

Подробнее о смежных возможностях читайте в материалах «Claude Code Skills: как создать собственную библиотеку» и «Claude Code Subagents: пять примеров».

Настройка MCP в Claude Code: первая команда за пять минут#

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

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

Доступны три транспорта: --transport stdio — локальный процесс, используется по умолчанию; --transport http — удалённый HTTP-сервер; --transport sse — устаревающий вариант, который стоит выбирать только для серверов, ещё не перешедших на другой транспорт.

Флаг --scope задаёт одну из трёх областей видимости:

• local — сервер доступен только в текущей папке проекта; это значение используется по умолчанию.
• project — настройки записываются в .mcp.json, который можно включить в репозиторий и использовать всей командой.
• user — сервер доступен во всех проектах на компьютере.

Для первого запуска можно использовать эталонный Filesystem-сервер проекта MCP:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list

Если указанная папка существует, после команды list сервер filesystem появится в списке. Несуществующая папка не позволит запустить сервер. Сервер получает доступ к рабочим папкам Claude Code — в частности, к той, откуда запущен Claude Code. В разделе 5.2 ниже объясняется, в каких случаях такой сервер полезен.

Чтобы проверить подключение, выполните /mcp в сессии Claude Code: команда покажет серверы, их состояние и доступные инструменты. Дополнительные инструкции по Ailoot приведены в документации. Команды конкретного сервера проверяйте в его README.

Какой транспорт выбрать: stdio или HTTP?#

Основные различия собраны в таблице:

Практический ориентир: для файлов на компьютере и локальной базы данных выбирайте stdio, а для облачных сервисов — HTTP. SSE считается устаревшим транспортом.

Семь полезных MCP-серверов для предпринимателя#

5.1. GitHub MCP — официальный сервер GitHub

Сервер предоставляет Claude Code доступ к issues, pull request'ам, файлам репозитория и запускам GitHub Actions. Он имеет открытый исходный код; на GitHub у проекта более 30 тысяч звёзд.

Установка через HTTP с OAuth:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

Другой вариант — запуск через Docker с транспортом stdio, если вместо OAuth требуется PAT-токен.

Пример запроса: «Прочитай открытые issues с меткой bug, сгруппируй их по компонентам и предложи порядок исправления». Claude обратится к GitHub MCP, изучит задачи и составит упорядоченный список.

Репозиторий: github/github-mcp-server.

5.2. Filesystem MCP — эталонный сервер проекта MCP

Сервер открывает ИИ доступ к файлам компьютера в пределах разрешённых папок. Его выпускает проект MCP; в реестре npm автором указана Model Context Protocol, a Series of LF Projects, LLC.

Установка через stdio с закреплённой версией:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects

При подключении Claude Code передаёт серверу рабочие папки, заменяя ими пути, указанные в команде. К рабочим папкам относятся каталог, из которого запущен Claude Code, и каталоги, добавленные командой /add-dir или флагом --add-dir. Поэтому указать серверу отдельную папку с макетами только в команде не получится. Указанный каталог всё равно должен существовать, иначе сервер не запустится.

В Claude Code этот сервер во многом дублирует встроенные средства работы с файлами. Чтобы получить доступ к другому каталогу, можно добавить его через /add-dir; после этого с ним работают и встроенные инструменты Claude Code. Filesystem MCP полезнее приложениям, у которых нет собственного доступа к файлам. В Claude Desktop иногда возникают проблемы: инструменты сервера отклоняются из-за устаревшего формата схем в их описании; соответствующий вопрос пока остаётся открытым.

Ограничивайте доступ конкретными папками, указанными в команде и добавленных через /add-dir. Не предоставляйте доступ ко всему диску: так можно открыть лишние данные.

Пример: выполните /add-dir ~/Documents/design, затем попросите: «Перемести все макеты из ~/Documents/design/landing-v3/ в текущий проект и переименуй их по шаблону hero-*.png».

5.3. Postgres MCP — DBHub от Bytebase

DBHub подключает Claude к Postgres, MySQL, SQL Server, MariaDB или SQLite. В нём есть режим только для чтения, который ограничивает риск случайного изменения базы. Сервер часто используют вместо архивированного reference-сервера server-postgres от Anthropic.

Установка через HTTP в режиме чтения:

claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly

Для производственной базы создайте отдельного пользователя с правами только на чтение. Персональные данные следует обезличить через VIEW или промежуточный API-роут. Не подключайте производственную БД с правами записи.

Пример запроса: «Выбери клиентов с подпиской 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 список pull request'ов, объединённых вчера».

5.5. Notion MCP — база знаний

Сервер предоставляет Claude доступ к страницам и базам данных Notion. Его можно применять для поиска по заметкам, реестрам клиентов или редакционной политике, хранящимся в рабочем пространстве Notion.

Установка по HTTP с OAuth:

claude mcp add --transport http notion https://mcp.notion.com/mcp

В качестве альтернативы доступен официальный плагин Anthropic @makenotion/claude-code-notion-plugin.

Пример запроса: «В базе Notion „Клиенты“ найди всех со статусом „активный“, с кем не было созвона больше двух недель. Подготовь для каждого черновик письма».

Инструкция Notion: developers.notion.com/guides/mcp.

5.6. Sentry MCP — работа с ошибками

Интеграция подключает Claude к ошибкам производственного приложения. Например, после ошибки 500 можно попросить: «Покажи последние 10 issues этого проекта в Sentry и объясни причину каждой».

Установка через HTTP:

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

Для входа используется OAuth Sentry. Доступ можно ограничить одним проектом.

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

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

5.7. Playwright MCP — автоматизация браузера

Сервер предоставляет Claude доступ к браузеру. ИИ может открыть страницу, нажать кнопки, заполнить форму и сделать снимок экрана. Это пригодится для проверки интерфейса, ручного тестирования после публикации и выполнения сценариев в браузере.

Установка через stdio:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Версия v0.0.75 датирована 7 мая 2026 года. Проект активно поддерживает Microsoft; на GitHub у него более 32 тысяч звёзд.

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

Репозиторий: microsoft/playwright-mcp.

Команду с закреплённой версией, параметр для одновременной работы нескольких сессий и распространённые ошибки установки проверяйте в README выбранной версии Playwright MCP.

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

Чёрный список SQL-префиксов не обеспечивает доступ только на чтение: он пропускает нижний регистр, комментарии, UPDATE, INSERT, ALTER, несколько команд и функции с побочными действиями. Выдайте подключению отдельную роль с правами только на чтение и проверьте их на одноразовой тестовой базе. Hook — дополнительное управление вызовами, а не замена полномочий базы.

Ниже намеренно узкий пример карантина: запретить все вызовы трёх названных семейств MCP до проверки конкретной политики. Запрещаются и чтение, и запись. Сопоставьте настоящие имена серверов и инструментов: переименованный сервер, встроенный Bash и другой коннектор вне этих шаблонов.

Добавьте отдельные правила в .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__postgres__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__slack__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__filesystem__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      }
    ]
  }
}

Сохраните скрипт как .claude/hooks/deny-unapproved-mcp.sh. Он возвращает документированный формат решения PreToolUse, а не старый верхнеуровневый decision: approve/block:

#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'

Скрипт не разбирает SQL: каждый совпавший вызов отклоняется. В изолированной сессии до подключения ценных данных проверьте запрет SELECT 1, delete в нижнем регистре, UPDATE с начальным комментарием, чтения и отправки Slack, чтения .env через Filesystem при совпадении имени. Инструмент другого семейства должен оставаться вне примера; проверьте эту отдельную границу.

Для чтения базы используйте проверенные права базы и замените карантин проверенной политикой настоящих инструментов. Для чтения Slack нужен ключ без отправки сообщений. Для файлов ограничьте разрешённые корни сервера и права процесса. Hook не предотвращает доступ через другие инструменты, оболочку, вложения запросов или изменяемый агентом файл политики.

Принцип «сначала проверить, потом выполнять» также рассматривается в руководстве Plan Mode в Claude Code.

Что делать, если инструментов стало больше 40 и Claude путается?#

Согласно документации Claude Code, Tool Search включён по умолчанию и не требует ручной настройки.

Есть исключения, когда Claude Code загружает все инструменты сразу: использование стороннего прокси, если ANTHROPIC_BASE_URL указывает не на Anthropic; модели поколения ниже 4.5 в Google Cloud; развёртывания Microsoft Foundry на Azure. Режим задаётся переменной ENABLE_TOOL_SEARCH:

• Если переменная не задана, описания инструментов MCP откладываются и загружаются по запросу.
• Значение true включает тот же режим и позволяет Claude Code пробовать поиск через прокси.
• Значение auto включает пороговый режим: описания загружаются сразу, пока занимают менее 10% окна контекста, а затем откладываются.
• Значение auto:N задаёт такой же режим с собственным порогом в процентах, например auto:5.
• Значение false возвращает прежнее поведение — все инструменты загружаются в контекст сразу.

Для инструментов, которые должны быть доступны всегда, в .mcp.json рядом с описанием сервера предусмотрен флаг alwaysLoad: true. Каждый инструмент с этим флагом занимает место в контексте с начала работы, поэтому добавляйте его только тем инструментам, которые нужны почти в каждом ответе.

Если у вас подключено пять или больше MCP-серверов и Claude затрудняется выбрать нужный инструмент, проверьте, не задано ли ENABLE_TOOL_SEARCH=false и не используется ли прокси.

Чтобы управлять объёмом контекста, также можно воспользоваться руководством по команде /compact.

Когда выбрать skill, subagent или CLI вместо MCP?#

По расходу токенов и сложности варианты можно расположить так:

1. Команда CLI через Bash — обычно требует минимального контекста. ИИ запускает gh pr list, psql -c или curl и получает результат так же, как пользователь терминала.
2. Skill — готовая инструкция с шаблоном запроса: что запустить и как обработать результат. Загружается при совпадении с триггером в имени папки.
3. Subagent — отдельный контекст для долгой задачи с собственной сессией и расходом токенов.
4. MCP-сервер — описания инструментов загружаются, когда Claude находит подходящий инструмент перед вызовом, а ответы сервисов могут быть объёмными. Claude Code показывает предупреждение, если ответ инструмента превышает 10 000 токенов. Для HTTP также используется OAuth-сессия.

Для обработки веб-страниц, работы с git, открытия PDF и вызова утилит с открытым исходным кодом часто достаточно CLI. ИИ может запускать терминальные команды; тогда в контекст попадают команда и её результат, без описаний инструментов и служебного слоя MCP-сервера.

MCP особенно уместен в двух ситуациях:

• Сервис закрытый, например Slack, Notion, Sentry или Linear. Для некоторых сервисов есть CLI-утилиты, но MCP может дать удобный доступ через OAuth с контролем разрешений.
• Требуется двусторонний обмен в несколько этапов: ИИ изучает схему Postgres, формулирует запрос, получает данные и продолжает работу с результатом. При работе через CLI это может потребовать множества отдельных команд.

Шесть ошибок при подключении MCP#

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

2. Доступ на запись к производственной БД. Postgres MCP подключён к рабочей базе без --readonly, отдельного пользователя и allowlist-hook. Запрос удалить тестовые записи может затронуть реальные данные. Решение: отдельная роль базы с проверенными правами только на чтение, режим сервера только на чтение при его наличии и проверенные ограничения инструментов. Чёрный список префиксов DROP|TRUNCATE|DELETE не обеспечивает достаточной авторизации.

3. Персональные данные без обезличивания. При прямом подключении к базе Claude может получить адреса почты, номера телефонов и паспортные данные клиентов. Решение: предоставить VIEW или промежуточный API-роут, который маскирует значения, например j***@gmail.com.

4. MCP вместо skill. Для составления отчёта о продажах по постоянному шаблону достаточно skill с готовой инструкцией. Для такого сценария новый MCP-сервер избыточен.

5. MCP вместо CLI-утилиты с открытым исходным кодом. Чтобы извлечь текст из PDF, можно использовать pdftotext; отдельный «PDF-MCP» в этом случае лишь усложнит работу и добавит расход токенов.

6. Отсутствие контроля расхода токенов. Команда claude mcp list показывает подключённые серверы, но не разбивку расхода по ним в каждом диалоге. Если стоимость и объём контекста растут, отключайте неиспользуемые серверы и следите за расходом через руководство по контролю лимитов Claude Code.

Как разобраться, если MCP-сервер не подключается?#

Проверьте подключение последовательно:

1. Есть ли сервер в списке?

   claude mcp list
   

   Если сервера нет, команда claude mcp add могла завершиться с ошибкой. Проверьте --scope: возможно, сервер добавлен в local, а проверка выполняется из другой папки проекта.

2. Каково состояние сервера?

   claude mcp status <name>
   

   Красный статус может означать, что процесс stdio не запустился или HTTP-сервер не ответил.

3. Что сообщают журналы?

   claude mcp logs <name>
   

   Если в журнале есть stack trace, проверьте пакет, наличие которого проверяет npx, и версию Node: требуется версия не ниже 20.

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

   claude mcp add --transport http --callback-port 8765 [name] [url]
   

5. Совпадают имена инструментов? Два сервера могут предоставлять инструмент с одинаковым именем, из-за чего Claude выберет не тот. Проверьте Tool Search или удалите лишний сервер командой claude mcp remove.

6. Не видны расширения claude.ai? Расширения (connectors), подключённые через веб-интерфейс claude.ai, могут быть недоступны Claude Code при работе с API-ключом. Подключайте сервер MCP через CLI.

Что изучить дальше: OAuth, собственные MCP и Plugin Marketplace#

Plugin Marketplace упрощает установку для тех, кто не хочет каждый раз вводить команды вручную. Манифест .claude-plugin/marketplace.json описывает набор серверов в одном пакете.

Установка плагина из marketplace:

claude plugin install <plugin-name>

В один плагин могут входить несколько MCP-серверов, skills и subagents. Например, такой набор можно собрать для сценария электронной торговли, маркетинга или юридического отдела.

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

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

Дополнительные материалы по работе с моделями доступны на Ailoot.