Подключение 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 серверы могут быть настроены тремя различными способами в зависимости от ваших потребностей:

Вариант 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

Понимание параметра ”—”: -- (двойное тире) разделяет собственные CLI флаги Claude от команды и аргументов, которые передаются MCP серверу. Все до -- являются опциями для Claude (например, --env, --scope), а все после -- - это фактическая команда для запуска MCP сервера.Например:

claude mcp add myserver -- npx server → запускает npx server
claude mcp add myserver --env KEY=value -- python server.py --port 8080 → запускает python server.py --port 8080 с KEY=value в окружении

Это предотвращает конфликты между флагами Claude и флагами сервера.

Вариант 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

Советы:

Используйте флаг --scope для указания места хранения конфигурации:
- local (по умолчанию): Доступен только вам в текущем проекте (ранее назывался project в старых версиях)
- project: Разделяется со всеми в проекте через файл .mcp.json
- user: Доступен вам во всех проектах (ранее назывался global в старых версиях)
Устанавливайте переменные окружения с флагами --env (например, --env KEY=value)
Настройте таймаут запуска MCP сервера, используя переменную окружения MCP_TIMEOUT (например, MCP_TIMEOUT=10000 claude устанавливает 10-секундный таймаут)
Claude Code будет отображать предупреждение, когда вывод MCP инструмента превышает 10,000 токенов. Чтобы увеличить этот лимит, установите переменную окружения MAX_MCP_OUTPUT_TOKENS (например, MAX_MCP_OUTPUT_TOKENS=50000)
Используйте /mcp для аутентификации с удаленными серверами, которые требуют OAuth 2.0 аутентификацию

Пользователи Windows: В нативной Windows (не WSL), локальные MCP серверы, которые используют npx, требуют обертку cmd /c для обеспечения правильного выполнения.

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

Без обертки cmd /c вы столкнетесь с ошибками “Connection closed”, потому что Windows не может напрямую выполнить npx. (См. примечание выше для объяснения параметра --.)

Области установки 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 в Claude Code

В Claude code используйте команду:

> /mcp

Затем следуйте шагам в вашем браузере для входа.

Советы:

Токены аутентификации хранятся безопасно и обновляются автоматически
Используйте “Clear authentication” в меню /mcp для отзыва доступа
Если ваш браузер не открывается автоматически, скопируйте предоставленный URL
OAuth аутентификация работает как с SSE, так и с HTTP транспортами

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

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

Добавить MCP сервер из JSON

# Базовый синтаксис
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

Советы:

Убедитесь, что JSON правильно экранирован в вашей оболочке
JSON должен соответствовать схеме конфигурации MCP сервера
Вы можете использовать --scope user для добавления сервера в вашу пользовательскую конфигурацию вместо специфичной для проекта

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

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

Импортировать серверы из Claude Desktop

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

Выбрать, какие серверы импортировать

После выполнения команды вы увидите интерактивный диалог, который позволяет выбрать, какие серверы вы хотите импортировать.

Проверить, что серверы были импортированы

claude mcp list

Советы:

Эта функция работает только на macOS и Windows Subsystem for Linux (WSL)
Она читает файл конфигурации Claude Desktop из его стандартного расположения на этих платформах
Используйте флаг --scope user для добавления серверов в вашу пользовательскую конфигурацию
Импортированные серверы будут иметь те же имена, что и в Claude Desktop
Если серверы с такими же именами уже существуют, они получат числовой суффикс (например, server_1)

Использование 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": {}
    }
  }
}

Советы:

Сервер предоставляет доступ к инструментам Claude, таким как View, Edit, LS и т.д.
В Claude Desktop попробуйте попросить Claude прочитать файлы в директории, внести изменения и многое другое.
Обратите внимание, что этот MCP сервер просто предоставляет инструменты Claude Code вашему MCP клиенту, поэтому ваш собственный клиент отвечает за реализацию пользовательского подтверждения для отдельных вызовов инструментов.

Лимиты и предуп��еждения вывода MCP

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

Порог предупреждения вывода: Claude Code отображает предупреждение, когда любой вывод MCP инструмента превышает 10,000 токенов
Настраиваемый лимит: Вы можете настроить максимально разрешенные токены вывода MCP, используя переменную окружения MAX_MCP_OUTPUT_TOKENS
Лимит по умолчанию: Максимум по умолчанию составляет 25,000 токенов

Чтобы увеличить лимит для инструментов, которые производят большие выводы:

# Установить более высокий лимит для выводов MCP инструментов
export MAX_MCP_OUTPUT_TOKENS=50000
claude

Это особенно полезно при работе с MCP серверами, которые:

Запрашивают большие наборы данных или базы данных
Генерируют подробные отчеты или документацию
Обрабатывают обширные файлы журналов или отладочную информацию

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

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

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

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

Список доступных ресурсов

Введите @ в вашем промпте, чтобы увидеть доступные ресурсы от всех подключенных MCP серверов. Ресурсы появляются рядом с файлами в меню автозаполнения.

Ссылка на конкретный ресурс

Используйте формат @server:protocol://resource/path для ссылки на ресурс:

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

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

Множественные ссылки на ресурсы

Вы можете ссылаться на несколько ресурсов в одном промпте:

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

Советы:

Ресурсы автоматически извлекаются и включаются как вложения при ссылке
Пути ресурсов доступны для нечеткого поиска в автозаполнении @ упоминаний
Claude Code автоматически предоставляет инструменты для перечисления и чтения MCP ресурсов, когда серверы их поддерживают
Ресурсы могут содержать любой тип контента, который предоставляет MCP сервер (текст, JSON, структурированные данные и т.д.)

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

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

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

Обнаружение доступных промптов

Введите /, чтобы увидеть все доступные команды, включая те, что от MCP серверов. MCP промпты появляются в формате /mcp__servername__promptname.

Выполнить промпт без аргументов

> /mcp__github__list_prs

Выполнить промпт с аргументами

Многие промпты принимают аргументы. Передавайте их через пробел после команды:

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "Ошибка в потоке входа" high

Советы:

MCP промпты динамически обнаруживаются от подключенных серверов
Аргументы разбираются на основе определенных параметров промпта
Результаты промптов вставляются напрямую в разговор
Имена серверов и промптов нормализуются (пробелы становятся подчеркиваниями)

Начало работы

Создавайте с Claude Code

Claude Code SDK

Развертывание

Администрирование

Конфигурация

Справочник

Ресурсы

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

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

Development & Testing Tools

Project Management & Documentation

Databases & Data Management

Payments & Commerce

Design & Media

Infrastructure & DevOps

Automation & Integration

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

​Лимиты и предуп��еждения вывода MCP

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

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

​Использование MCP промптов как слэш-команд

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Лимиты и предуп��еждения вывода MCP

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

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

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

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