Подключение Claude Code к инструментам через MCP

Claude Code может подключаться к сотням внешних инструментов и источников данных через Model Context Protocol (MCP), открытый стандарт для интеграций AI-инструментов. MCP серверы предоставляют Claude Code доступ к вашим инструментам, базам данных и API.

​

Что вы можете делать с MCP

С подключенными MCP серверами вы можете попросить Claude Code:

• Реализовать функции из трекеров задач: “Добавь функцию, описанную в задаче JIRA ENG-4521, и создай PR на GitHub.”
• Анализировать данные мониторинга: “Проверь Sentry и Statsig, чтобы проверить использование функции, описанной в ENG-4521.”
• Запрашивать базы данных: “Найди email адреса 10 случайных пользователей, которые использовали функцию ENG-4521, на основе нашей базы данных Postgres.”
• Интегрировать дизайны: “Обнови наш стандартный шаблон email на основе новых дизайнов Figma, которые были опубликованы в Slack”
• Автоматизировать рабочие процессы: “Создай черновики Gmail, приглашающие этих 10 пользователей на сессию обратной связи о новой функции.”

​

Популярные MCP серверы

Вот некоторые часто используемые MCP серверы, которые вы можете подключить к Claude Code:

​

Установка MCP серверов

MCP серверы могут быть настроены тремя различными способами в зависимости от ваших потребностей:

​

Вариант 1: Добавить локальный stdio сервер

Stdio серверы работают как локальные процессы на вашей машине. Они идеальны для инструментов, которым нужен прямой доступ к системе или пользовательские скрипты.

# Базовый синтаксис
claude mcp add <name> <command> [args...]

# Реальный пример: Добавить сервер Airtable
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

​

Вариант 2: Добавить удаленный SSE сервер

SSE (Server-Sent Events) серверы обеспечивают потоковые соединения в реальном времени. Многие облачные сервисы используют это для живых обновлений.

# Базовый синтаксис
claude mcp add --transport sse <name> <url>

# Реальный пример: Подключиться к Linear
claude mcp add --transport sse linear https://mcp.linear.app/sse

# Пример с заголовком аутентификации
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header "X-API-Key: your-key-here"

​

Вариант 3: Добавить удаленный HTTP сервер

HTTP серверы используют стандартные паттерны запрос/ответ. Большинство REST API и веб-сервисов используют этот транспорт.

# Базовый синтаксис
claude mcp add --transport http <name> <url>

# Реальный пример: Подключиться к Notion
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Пример с Bearer токеном
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

​

Управление вашими серверами

После настройки вы можете управлять своими MCP серверами с помощью этих команд:

# Список всех настроенных серверов
claude mcp list

# Получить детали для конкретного сервера
claude mcp get github

# Удалить сервер
claude mcp remove github

# (в Claude Code) Проверить статус сервера
/mcp

# Это создает command="cmd", которую Windows может выполнить
claude mcp add my-server -- cmd /c npx -y @some/package

​

Области установки MCP

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

​

Локальная область

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

# Добавить сервер локальной области (по умолчанию)
claude mcp add my-private-server /path/to/server

# Явно указать локальную область
claude mcp add my-private-server --scope local /path/to/server

​

Область проекта

Серверы области проекта обеспечивают командное сотрудничество, сохраняя конфигурации в файле .mcp.json в корневой директории вашего проекта. Этот файл предназначен для включения в систему контроля версий, обеспечивая всем членам команды доступ к одним и тем же MCP инструментам и сервисам. Когда вы добавляете сервер области проекта, Claude Code автоматически создает или обновляет этот файл с соответствующей структурой конфигурации.

# Добавить сервер области проекта
claude mcp add shared-server --scope project /path/to/server

Результирующий файл .mcp.json следует стандартизированному формату:

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

По соображениям безопасности Claude Code запрашивает одобрение перед использованием серверов области проекта из файлов .mcp.json. Если вам нужно сбросить эти выборы одобрения, используйте команду claude mcp reset-project-choices.

​

Пользовательская область

Серверы пользовательской области обеспечивают доступность между проектами, делая их доступными во всех проектах на вашей машине, оставаясь при этом приватными для вашей учетной записи пользователя. Эта область хорошо работает для персональных утилитарных серверов, инструментов разработки или сервисов, которые вы часто используете в разных проектах.

# Добавить пользовательский сервер
claude mcp add my-user-server --scope user /path/to/server

​

Выбор правильной области

Выбирайте область на основе:

• Локальная область: Персональные серверы, экспериментальные конфигурации или чувствительные учетные данные, специфичные для одного проекта
• Область проекта: Серверы, разделяемые командой, инструменты, специфичные для проекта, или сервисы, необходимые для сотрудничества
• Пользовательская область: Персональные утилиты, необходимые в нескольких проектах, инструменты разработки или часто используемые сервисы

​

Иерархия областей и приоритет

Конфигурации MCP серверов следуют четкой иерархии приоритетов. Когда серверы с одинаковыми именами существуют в нескольких областях, система разрешает конфликты, приоритизируя серверы локальной области сначала, затем серверы области проекта и, наконец, серверы пользовательской области. Этот дизайн обеспечивает, что персональные конфигурации могут переопределять разделяемые при необходимости.

​

Расширение переменных окружения в .mcp.json

Claude Code поддерживает расширение переменных окружения в файлах .mcp.json, позволяя командам разделять конфигурации, сохраняя при этом гибкость для путей, специфичных для машины, и чувствительных значений, таких как API ключи.

Поддерживаемый синтаксис:

• ${VAR} - Расширяется до значения переменной окружения VAR
• ${VAR:-default} - Расширяется до VAR, если установлена, иначе использует default

Места расширения: Переменные окружения могут быть расширены в:

• command - Путь к исполняемому файлу сервера
• args - Аргументы командной строки
• env - Переменные окружения, передаваемые серверу
• url - Для типов серверов SSE/HTTP
• headers - Для аутентификации серверов SSE/HTTP

Пример с расширением переменных:

{
  "mcpServers": {
    "api-server": {
      "type": "sse",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

Если требуемая переменная окружения не установлена и не имеет значения по умолчанию, Claude Code не сможет разобрать конфигурацию.

​

Практические примеры

​

Пример: Мониторинг ошибок с Sentry

# 1. Добавить MCP сервер Sentry
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. Использовать /mcp для аутентификации с вашей учетной записью Sentry
> /mcp

# 3. Отладка проблем в продакшене
> "Какие самые распространенные ошибки за последние 24 часа?"
> "Покажи мне трассировку стека для ошибки ID abc123"
> "Какое развертывание внесло эти новые ошибки?"

​

Аутентификация с удаленными MCP серверами

Многие облачные MCP серверы требуют аутентификации. Claude Code поддерживает OAuth 2.0 для безопасных соединений.

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

> /mcp

​

Добавление MCP серверов из JSON конфигурации

Если у вас есть JSON конфигурация для MCP сервера, вы можете добавить ее напрямую:

# Базовый синтаксис
claude mcp add-json <name> '<json>'

# Пример: Добавление stdio сервера с JSON конфигурацией
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

​

Импорт MCP серверов из Claude Desktop

Если вы уже настроили MCP серверы в Claude Desktop, вы можете импортировать их:

# Базовый синтаксис 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Использование Claude Code как MCP сервера

Вы можете использовать сам Claude Code как MCP сервер, к которому могут подключаться другие приложения:

# Запустить Claude как stdio MCP сервер
claude mcp serve

Вы можете использовать это в Claude Desktop, добавив эту конфигурацию в claude_desktop_config.json:

{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

Использование MCP ресурсов

MCP серверы могут предоставлять ресурсы, на которые вы можете ссылаться, используя @ упоминания, аналогично тому, как вы ссылаетесь на файлы.

​

Ссылка на MCP ресурсы

> Можешь проанализировать @github:issue://123 и предложить исправление?

> Пожалуйста, просмотри документацию API по адресу @docs:file://api/authentication

> Сравни @postgres:schema://users с @docs:file://database/user-model

​

Использование MCP промптов как slash команд

MCP серверы могут предоставлять промпты, которые становятся доступными как slash команды в Claude Code.

​

Выполнение MCP промптов

> /mcp__github__list_prs

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Баг в потоке входа" high