Claude Code MCP
Если Claude Code — превосходный наборщик текста (генерация кода) и тестировщик (проверка кода), то добавление MCP (Model Context Protocol) даёт Claude настоящие внешние органы чувств и конечности — он больше не ограничен файлами кода текущего проекта, а может активно подключаться к ресурсам и инструментам внешнего мира, становясь вашим партнёром по сквозной совместной разработке.
Что такое MCP (Model Context Protocol)?
MCP — это открытый стандартизированный протокол, представленный Anthropic, созданный для решения основных болевых точек взаимодействия между ИИ и внешними инструментами.
Основная логика MCP переворачивает традиционный подход: вместо того чтобы ИИ изучал правила использования каждого инструмента по отдельности, все инструменты предоставляют ИИ единый интерфейс.
Эта логика похожа на универсальную розетку в реальной жизни — вместо того чтобы заставлять приборы адаптироваться к разным розеткам, достаточно стандартизировать розетки, и все приборы можно использовать напрямую.
После подключения MCP-сервера вы можете позволить Claude Code:
- Получать требования из JIRA/тикет-систем и разрабатывать функции, создавать PR в GitHub
- Анализировать данные мониторинга Sentry, выявлять ошибки в продакшен-среде
- Запрашивать данные из баз данных, таких как PostgreSQL/MySQL
- Обновлять код на основе макетов Figma, автоматически создавать черновики писем и т. д.

Зачем Claude Code нужен MCP?
До появления MCP возможности Claude Code были строго ограничены папкой проекта, открытой в данный момент, словно помощник, смотрящий на небо со дна колодца: он видел только код перед собой и не мог воспринимать никакую информацию за пределами проекта. Появление MCP полностью разрушает эту информационную изоляцию, позволяя Claude глубоко участвовать во всём процессе разработки:
Вот несколько наглядных сравнений сценариев, которые помогут вам быстро понять ценность MCP:
| Сценарий | Без MCP | С MCP |
|---|---|---|
| Кросс-репозиторный анализ | Можно анализировать только код в текущей папке, нельзя связать его с другими репозиториями | Кросс-репозиторное взаимодействие: «Помоги мне проанализировать документацию API репозитория A, а затем написать соответствующие методы вызова в репозитории B.» |
| Синхронизация требований/обсуждений | Приходится вручную копировать и вставлять документы с требованиями и записи обсуждений команды в чат | Синхронизация информации о совместной работе в реальном времени: «Проверь записи обсуждений в канале #feature-x в Slack и посмотри предложения участников по изменению этой функции.» |
| Проверка базы данных | Нельзя напрямую проверить совместимость кода и базы данных; можно только вручную просматривать структуры таблиц | Прямая интеграция с базой данных: «Пойди проверь структуру и первые 5 строк таблицы users в MySQL и определи, соответствует ли интерфейс пользовательских запросов, который я написал.» |
| Автоматизированные рабочие процессы | Может только генерировать фрагменты кода для ручного копирования и использования | Автоматизированное выполнение: «Помоги мне написать скрипт автоматизации браузера и с помощью MCP вызвать Puppeteer, чтобы запустить его и проверить логику взаимодействия страницы входа.» |
Короче говоря, MCP превращает Claude Code из ассистента, который пассивно получает информацию, в партнёра по сотрудничеству, который активно получает информацию и выполняет действия.
Базовое использование MCP в Claude Code
Claude Code имеет встроенные полноценные возможности управления MCP, при этом есть только одна основная команда:
claude mcp
Часто используемые подкоманды:
| Команда | Описание |
|---|---|
claude mcp add |
Добавить сервер MCP |
claude mcp list |
Просмотреть все настроенные серверы |
claude mcp get <name> |
Просмотреть сведения о конкретном сервере |
claude mcp remove <name> |
Удалить сервер |
/mcp |
Просмотр статуса / аутентификации в Claude Code |
Установка серверов MCP
MCP-серверы поддерживают три способа подключения: HTTP/SSE/stdio. Рекомендуется HTTP (SSE устарел).
1. Удалённый HTTP-сервер (рекомендуется)
Подходит для инструментов облачных сервисов; это наиболее универсальный способ:
# 基础语法 claude mcp add --transport http <服务器名称> <服务器URL> # 示例1:连接Notion claude mcp add --transport http notion https://mcp.notion.com/mcp # 示例2:带身份验证的HTTP服务器 claude mcp add --transport http secure-api https://api.example.com/mcp \ --header "Authorization: Bearer 你的令牌"
2. Удалённый SSE-сервер (устарел)
Совместим только с устаревшими инструментами; вместо этого предпочтите HTTP:
# 基础语法(仅兼容用) claude mcp add --transport sse <服务器名称> <服务器URL> # 示例:连接Asana claude mcp add --transport sse asana https://mcp.asana.com/sse
3. Локальный stdio-сервер
Подходит для инструментов, требующих доступа к локальной системе (например, локальные базы данных, пользовательские скрипты):
# 基础语法(注意:--前是Claude参数,--后是服务器命令) claude mcp add --transport stdio [--env 环境变量] <服务器名称> -- <启动命令> # 示例:连接Airtable(需替换自己的API密钥) claude mcp add --transport stdio --env AIRTABLE_API_KEY=你的密钥 airtable \ -- npx -y airtable-mcp-server
Ключевые примечания:
--transport/--envТакие параметры, как ..., должны быть размещены передименем сервера,--Используется для отделения параметров Claude от команд сервера, чтобы избежать конфликтов параметров.
Управление MCP-серверами
После завершения настройки вы можете управлять серверами с помощью следующих команд:
# 列出所有已配置的服务器 claude mcp list # 查看指定服务器详情(如github) claude mcp get github # 删除指定服务器 claude mcp remove github # 在Claude Code中检查服务器状态 /mcp
Область конфигурации (управление видимостью сервера)
Вы можете указать действующую область MCP-сервера в соответствии со сценариями личного/командного использования:
| Область действия | Назначение | Пример команды настройки |
|---|---|---|
| local (по умолчанию) | Доступна только текущему проекту; приватная конфигурация (например, конфиденциальные ключи) | claude mcp add --scope local ... |
| project | Общий для команды (хранится в .mcp.json, можно закоммитить в репозиторий) | claude mcp add --scope project ... |
| user | Доступно всем проектам (персональная глобальная конфигурация) | claude mcp add --scope user ... |
Приоритет: local > project > user (для серверов с одинаковым именем локальная конфигурация переопределяет общую конфигурацию)
Практические примеры
Пример 1: ревью кода на GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/
В Claude Code:
> Review PR #456 and suggest improvements > Show me all open PRs assigned to me
Пример 2: диагностика проблем в production с Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
> /mcp # 完成 OAuth 登录 > What are the most common errors in the last 24 hours?
Пример 3: прямой запрос к PostgreSQL
claude mcp add --transport stdio db \ -- npx -y @bytebase/dbhub \ --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"
> Show me the schema for the orders table > Which users haven't purchased in 90 days?
Продвинутые способы использования MCP в диалогах
1. Использование@ссылок на ресурсы MCP
> Analyze @github:issue://123 and suggest a fix
Поддерживает сравнение нескольких ресурсов:
> Compare @postgres:schema://users with @docs:file://user-model
2. Промпты MCP как слэш-команды
MCP может предоставлять команды:
/mcp__github__list_prs /mcp__jira__create_issue "Login bug" high
Claude выполнит их так же, как встроенные команды.
Ключевые моменты
- Аутентификация: Удалённые MCP-серверы (такие как GitHub/Sentry) должны запускаться в Claude Code
/mcpчтобы завершить авторизацию OAuth 2.0; - Совместимость с Windows: Если вы используете npx для локальных stdio-серверов, нужно добавить
cmd /cобёртку (например,-- cmd /c npx -y 包名), иначе появится ошибка "Connection closed"; - Риск третьих сторон: При использовании неофициальных MCP-серверов убедитесь, что источник заслуживает доверия, чтобы избежать рисков внедрения промптов/угроз безопасности;
- Порядок параметров: При настройке stdio-сервера,
--параметры до и после нельзя менять местами, иначе выполнение завершится ошибкой.