[args...]
```
Доступны три транспорта: `--transport stdio` — локальный процесс, используется по умолчанию; `--transport http` — удалённый HTTP-сервер; `--transport sse` — устаревающий вариант, который стоит выбирать только для серверов, ещё не перешедших на другой транспорт.
Флаг `--scope` задаёт одну из трёх областей видимости:
- `local` — сервер доступен только в текущей папке проекта; это значение используется по умолчанию.
- `project` — настройки записываются в `.mcp.json`, который можно включить в репозиторий и использовать всей командой.
- `user` — сервер доступен во всех проектах на компьютере.
Для первого запуска можно использовать эталонный Filesystem-сервер проекта MCP:
```bash
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 приведены в [документации](https://ailoot.ai/docs/). Команды конкретного сервера проверяйте в его README.
## Какой транспорт выбрать: stdio или HTTP?
Кратко о главном
`stdio` запускает локальный процесс на компьютере: ему не требуется сеть или OAuth. HTTP подключает удалённый сервис через токен или OAuth и позволяет использовать его с разных устройств. Серверы, запускаемые через `npx` или `uvx`, обычно используют stdio. Если у сервиса есть собственный публичный адрес, подходит HTTP. Транспорт SSE отмечен как устаревший, поэтому не стоит выбирать его для новых подключений.
Основные различия собраны в таблице:
| Критерий | stdio | HTTP |
|----|----|----|
| Где запускается | Локально, как дочерний процесс Claude Code | На удалённом сервере |
| Авторизация | Не требуется | OAuth 2.1 или Bearer-токен |
| Сетевые порты | Не используются | Требуется доступный адрес |
| Типичные применения | Filesystem, Postgres, локальные утилиты | GitHub, Slack, Notion, Linear, Sentry |
| Переподключение | Не требуется | Exponential backoff, до 5 попыток |
| Развёртывание | Установка пакета локально | Сервис поставщика |
Практический ориентир: для файлов на компьютере и локальной базы данных выбирайте stdio, а для облачных сервисов — HTTP. SSE считается устаревшим транспортом.
## Семь полезных MCP-серверов для предпринимателя
Кратко о главном
Семь интеграций покрывают распространённые задачи при разработке с помощью ИИ: работа с кодом через GitHub, файлами через Filesystem, базами через Postgres и DBHub, командой через Slack, знаниями через Notion, ошибками через Sentry и браузером через Playwright. Ниже для каждого варианта приведена команда установки и пример запроса для Claude.
### 5.1. GitHub MCP — официальный сервер GitHub
Сервер предоставляет Claude Code доступ к issues, pull request'ам, файлам репозитория и запускам GitHub Actions. Он имеет открытый исходный код; на GitHub у проекта более 30 тысяч звёзд.
Установка через HTTP с OAuth:
```bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
```
Другой вариант — запуск через Docker с транспортом stdio, если вместо OAuth требуется PAT-токен.
Пример запроса: «Прочитай открытые issues с меткой `bug`, сгруппируй их по компонентам и предложи порядок исправления». Claude обратится к GitHub MCP, изучит задачи и составит упорядоченный список.
Репозиторий: [github/github-mcp-server](https://github.com/github/github-mcp-server).
### 5.2. Filesystem MCP — эталонный сервер проекта MCP
Сервер открывает ИИ доступ к файлам компьютера в пределах разрешённых папок. Его выпускает проект MCP; в реестре npm автором указана Model Context Protocol, a Series of LF Projects, LLC.
Установка через stdio с закреплённой версией:
```bash
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 в режиме чтения:
```bash
claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly
```
Для производственной базы создайте отдельного пользователя с правами только на чтение. Персональные данные следует обезличить через VIEW или промежуточный API-роут. Не подключайте производственную БД с правами записи.
Пример запроса: «Выбери клиентов с подпиской `expired` за последний месяц и покажи 20 клиентов с наибольшей общей суммой платежей».
Репозиторий: [bytebase/dbhub](https://github.com/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` список pull request'ов, объединённых вчера».
### 5.5. Notion MCP — база знаний
Сервер предоставляет Claude доступ к страницам и базам данных Notion. Его можно применять для поиска по заметкам, реестрам клиентов или редакционной политике, хранящимся в рабочем пространстве Notion.
Установка по HTTP с OAuth:
```bash
claude mcp add --transport http notion https://mcp.notion.com/mcp
```
В качестве альтернативы доступен официальный плагин Anthropic `@makenotion/claude-code-notion-plugin`.
Пример запроса: «В базе Notion „Клиенты“ найди всех со статусом „активный“, с кем не было созвона больше двух недель. Подготовь для каждого черновик письма».
Инструкция Notion: [developers.notion.com/guides/mcp](https://developers.notion.com/guides/mcp/get-started-with-mcp).
### 5.6. Sentry MCP — работа с ошибками
Интеграция подключает Claude к ошибкам производственного приложения. Например, после ошибки 500 можно попросить: «Покажи последние 10 issues этого проекта в Sentry и объясни причину каждой».
Установка через HTTP:
```bash
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
```
Для входа используется OAuth Sentry. Доступ можно ограничить одним проектом.
Пример запроса: «Возьми три самых частых issues за последние сутки, простыми словами объясни, что произошло, и предложи варианты исправления».
Репозиторий: [getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp).
### 5.7. Playwright MCP — автоматизация браузера
Сервер предоставляет Claude доступ к браузеру. ИИ может открыть страницу, нажать кнопки, заполнить форму и сделать снимок экрана. Это пригодится для проверки интерфейса, ручного тестирования после публикации и выполнения сценариев в браузере.
Установка через stdio:
```bash
claude mcp add playwright -- npx -y @playwright/mcp@latest
```
Версия v0.0.75 датирована 7 мая 2026 года. Проект активно поддерживает Microsoft; на GitHub у него более 32 тысяч звёзд.
Пример запроса: «Открой главную страницу нашего сайта, проверь отображение всех карточек и сделай снимки экрана для настольного компьютера и мобильного устройства».
Репозиторий: [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp).
Команду с закреплённой версией, параметр для одновременной работы нескольких сессий и распространённые ошибки установки проверяйте в README выбранной версии Playwright MCP.
## Как настроить безопасность через PreToolUse hook?
Кратко о главном
PreToolUse hook управляет совпадающими вызовами инструментов. Регулярное выражение SQL-префикса не является авторизацией базы, а matcher только Postgres не покрывает Slack и файлы. Сначала настройте права сервисов и файловой системы, а затем отдельно проверьте точный охват hook.
Чёрный список SQL-префиксов не обеспечивает доступ только на чтение: он пропускает нижний регистр, комментарии, UPDATE, INSERT, ALTER, несколько команд и функции с побочными действиями. Выдайте подключению отдельную роль с правами только на чтение и проверьте их на одноразовой тестовой базе. Hook — дополнительное управление вызовами, а не замена полномочий базы.
Ниже намеренно узкий пример карантина: запретить все вызовы трёх названных семейств MCP до проверки конкретной политики. Запрещаются и чтение, и запись. Сопоставьте настоящие имена серверов и инструментов: переименованный сервер, встроенный Bash и другой коннектор вне этих шаблонов.
Добавьте отдельные правила в `.claude/settings.json`:
```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](https://code.claude.com/docs/en/hooks#pretooluse-decision-control), а не старый верхнеуровневый decision: approve/block:
```bash
#!/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](https://ailoot.ai/blog/ru/claude-code-plan-mode/).
## Что делать, если инструментов стало больше 40 и Claude путается?
Кратко о главном
Семь серверов могут предоставить от 50 до 100 инструментов. В Claude Code по умолчанию используется Tool Search — поиск инструментов. При старте в контексте остаются названия инструментов и инструкции серверов, а полные описания Claude загружает при необходимости. Если поиск отключён, все описания загружаются сразу; примерно после 40 инструментов Claude может чаще выбирать неподходящие средства или обращаться к MCP там, где достаточно обычной команды.
Согласно [документации Claude Code](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search), 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`](https://ailoot.ai/blog/ru/claude-code-token-limits-saving/).
## Когда выбрать skill, subagent или CLI вместо MCP?
Кратко о главном
MCP может требовать больше токенов, чем другие способы дать Claude доступ к внешним функциям. Если задачу можно выполнить готовой CLI-утилитой (`gh issue list`, `psql`, `curl`) или одностраничным skill, используйте их вместо нового MCP-сервера. 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
Кратко о главном
Ниже перечислены шесть распространённых ошибок при настройке MCP и способы их исправить. Сначала просмотрите список серверов командой `claude mcp list`, затем проверьте области доступа и hooks. Часто достаточно отключить ненужный сервер, а не подключать новый.
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](https://ailoot.ai/blog/ru/claude-code-token-limits-saving/).
## Как разобраться, если MCP-сервер не подключается?
Кратко о главном
Частые причины проблем — OAuth не возвращает пользователя в приложение, имя сервера конфликтует с другим или после команды `add` интеграция не появляется в `claude mcp list`. Начните с проверки списка, затем состояния и журналов. При ошибке запуска изучите команду, scope и переменные окружения.
Проверьте подключение последовательно:
1. **Есть ли сервер в списке?**
```bash
claude mcp list
```
Если сервера нет, команда `claude mcp add` могла завершиться с ошибкой. Проверьте `--scope`: возможно, сервер добавлен в `local`, а проверка выполняется из другой папки проекта.
2. **Каково состояние сервера?**
```bash
claude mcp status
```
Красный статус может означать, что процесс stdio не запустился или HTTP-сервер не ответил.
3. **Что сообщают журналы?**
```bash
claude mcp logs
```
Если в журнале есть stack trace, проверьте пакет, наличие которого проверяет `npx`, и версию Node: требуется версия не ниже 20.
4. **Не срабатывает OAuth-возврат?** Часто причиной бывает параметр `--callback-port` или сетевой фильтр. Попробуйте явно задать порт:
```bash
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
Кратко о главном
После настройки готовых серверов можно изучить OAuth для собственных HTTP-серверов, разработать MCP для специализированного сервиса и посмотреть Plugin Marketplace от Anthropic. Marketplace был запущен 9 октября 2025 года; плагины позволяют устанавливать наборы компонентов одной командой.
Plugin Marketplace упрощает установку для тех, кто не хочет каждый раз вводить команды вручную. Манифест `.claude-plugin/marketplace.json` описывает набор серверов в одном пакете.
Установка плагина из marketplace:
```bash
claude plugin install
```
В один плагин могут входить несколько MCP-серверов, skills и subagents. Например, такой набор можно собрать для сценария электронной торговли, маркетинга или юридического отдела.
Собственный MCP-сервер разрабатывают по спецификации `modelcontextprotocol.io`. В качестве основы можно взять SDK для Python или TypeScript, а затем описать инструменты и настроить транспорт. По сложности такая работа сопоставима с созданием REST API на FastAPI.
Если проект уже использует [настроенный CLAUDE.md](https://ailoot.ai/blog/ru/kak-nastroit-claude-md/) и вы знакомы с [контекст-инжинирингом](https://ailoot.ai/blog/ru/context-engineering/), добавление собственного MCP может занять день. Если эти основы ещё не освоены, начните с них.
### Официальные источники
- [Model Context Protocol — официальный сайт](https://modelcontextprotocol.io/)
- [Anthropic представляет MCP — 25 ноября 2024 года](https://www.anthropic.com/news/model-context-protocol)
- [Документация Claude Code по MCP](https://code.claude.com/docs/en/mcp)
- [Поиск инструментов MCP в Claude Code (Tool Search)](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)
- [Объявление Anthropic о Claude Code Plugins — 9 октября 2025 года](https://claude.com/blog/claude-code-plugins)
- [Code with Claude 2026](https://claude.com/code-with-claude)
- [Официальный репозиторий серверов проекта MCP](https://github.com/modelcontextprotocol/servers)
- [GitHub MCP Server](https://github.com/github/github-mcp-server)
- [Playwright MCP от Microsoft](https://github.com/microsoft/playwright-mcp)
- [DBHub от Bytebase](https://github.com/bytebase/dbhub)
- [Sentry MCP](https://github.com/getsentry/sentry-mcp)
- [Плагин Notion для Claude Code](https://github.com/makenotion/claude-code-notion-plugin)
- [Руководство Notion по MCP](https://developers.notion.com/guides/mcp/get-started-with-mcp)
- [Репозиторий Claude Code от Anthropic: issues и журнал изменений](https://github.com/anthropics/claude-code)
Дополнительные материалы по работе с моделями доступны на [Ailoot](https://ailoot.ai/).
## Вопросы и ответы
### Сделает ли этот hook рабочую базу доступной только для чтения?
Нет. Пример блокирует все вызовы совпадающих семейств MCP, а не классифицирует SQL. Чтение без записи обеспечивается отдельной ролью базы с проверенными правами; hook служит дополнительным ограничением.
### Как проверить охват hook?
В изолированной сессии проверьте отклонение совпадающих инструментов и для чтения, и для записи, включая SQL с нижним регистром и начальными комментариями. Затем проверьте, что посторонний инструмент вне matcher: этому пути нужны собственные разрешения или политика.
## Ailoot · Компания и портфель её проектов
Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.
Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.
Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.