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 выполнит их так же, как встроенные команды.


Ключевые моменты

  1. Аутентификация: Удалённые MCP-серверы (такие как GitHub/Sentry) должны запускаться в Claude Code/mcpчтобы завершить авторизацию OAuth 2.0;
  2. Совместимость с Windows: Если вы используете npx для локальных stdio-серверов, нужно добавитьcmd /cобёртку (например,-- cmd /c npx -y 包名), иначе появится ошибка "Connection closed";
  3. Риск третьих сторон: При использовании неофициальных MCP-серверов убедитесь, что источник заслуживает доверия, чтобы избежать рисков внедрения промптов/угроз безопасности;
  4. Порядок параметров: При настройке stdio-сервера,--параметры до и после нельзя менять местами, иначе выполнение завершится ошибкой.
Другие расширения