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

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

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

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

Вот некоторые часто используемые серверы MCP, которые вы можете подключить к Claude Code:
Используйте серверы MCP третьих сторон на свой риск - Anthropic не проверил корректность или безопасность всех этих серверов. Убедитесь, что вы доверяете серверам MCP, которые устанавливаете. Будьте особенно осторожны при использовании серверов MCP, которые могут получать ненадежный контент, так как это может подвергнуть вас риску инъекции подсказок.
Нужна конкретная интеграция? Найдите сотни других серверов MCP на GitHub, или создайте свой собственный, используя MCP SDK.

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

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

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

HTTP-серверы - это рекомендуемый вариант для подключения к удаленным серверам MCP. Это наиболее широко поддерживаемый транспорт для облачных сервисов. 
# Базовый синтаксис
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"

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

Транспорт SSE (Server-Sent Events) устарел. Используйте вместо этого HTTP-серверы, где они доступны.
# Базовый синтаксис
claude mcp add --transport sse <name> <url>

# Реальный пример: подключение к Asana
claude mcp add --transport sse asana https://mcp.asana.com/sse

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

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

Серверы Stdio работают как локальные процессы на вашей машине. Они идеальны для инструментов, которым требуется прямой доступ к системе или пользовательские скрипты. 
# Базовый синтаксис
claude mcp add --transport stdio <name> <command> [args...]

# Реальный пример: добавление сервера Airtable
claude mcp add --transport stdio airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server
Понимание параметра ”—”: -- (двойной дефис) разделяет собственные флаги CLI Claude от команды и аргументов, которые передаются серверу MCP. Все, что находится перед --, - это опции для Claude (например, --env, --scope), а все, что находится после --, - это фактическая команда для запуска сервера MCP.Например:
  • claude mcp add --transport stdio myserver -- npx server → запускает npx server
  • claude mcp add --transport stdio myserver --env KEY=value -- python server.py --port 8080 → запускает python server.py --port 8080 с KEY=value в окружении
Это предотвращает конфликты между флагами Claude и флагами сервера.

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

После настройки вы можете управлять своими серверами 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 --transport stdio my-server -- cmd /c npx -y @some/package
Без обертки cmd /c вы столкнетесь с ошибками “Connection closed”, потому что Windows не может напрямую выполнить npx. (См. примечание выше для объяснения параметра --.)

​
Серверы MCP, предоставляемые плагинами

Плагины могут включать серверы MCP, автоматически предоставляя инструменты и интеграции при включении плагина. Серверы MCP плагинов работают идентично пользовательским настроенным серверам. Как работают серверы MCP плагинов:
  • Плагины определяют серверы MCP в .mcp.json в корне плагина или встроенные в plugin.json
  • Когда плагин включен, его серверы MCP запускаются автоматически
  • Инструменты MCP плагина отображаются рядом с вручную настроенными инструментами MCP
  • Серверы плагинов управляются через установку плагина (не через команды /mcp)
Пример конфигурации MCP плагина: В .mcp.json в корне плагина: 
{
  "database-tools": {
    "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
    "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
    "env": {
      "DB_URL": "${DB_URL}"
    }
  }
}
Или встроенные в plugin.json: 
{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}
Функции MCP плагинов:
  • Автоматический жизненный цикл: Серверы запускаются при включении плагина, но вы должны перезагрузить Claude Code, чтобы применить изменения сервера MCP (включение или отключение)
  • Переменные окружения: Используйте ${CLAUDE_PLUGIN_ROOT} для путей относительно плагина
  • Доступ к окружению пользователя: Доступ к тем же переменным окружения, что и вручную настроенные серверы
  • Несколько типов транспорта: Поддержка транспортов stdio, SSE и HTTP (поддержка транспорта может варьироваться в зависимости от сервера)
Просмотр серверов MCP плагинов: 
# В Claude Code посмотрите все серверы MCP, включая серверы плагинов
/mcp
Серверы плагинов отображаются в списке с индикаторами, показывающими, что они поступают из плагинов. Преимущества серверов MCP плагинов:
  • Упакованное распределение: Инструменты и серверы упакованы вместе
  • Автоматическая настройка: Не требуется ручная конфигурация MCP
  • Согласованность команды: Все получают одинаковые инструменты при установке плагина
См. справочник компонентов плагинов для получения подробной информации о включении серверов MCP в плагины.

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

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

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

Серверы с локальной областью представляют уровень конфигурации по умолчанию и хранятся в параметрах пользователя, специфичных для проекта. Эти серверы остаются приватными для вас и доступны только при работе в текущем каталоге проекта. Эта область идеальна для личных серверов разработки, экспериментальных конфигураций или серверов, содержащих конфиденциальные учетные данные, которые не должны быть общими. 
# Добавить сервер с локальной областью (по умолчанию)
claude mcp add --transport http stripe https://mcp.stripe.com

# Явно указать локальную область
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

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

Серверы с областью проекта обеспечивают командное сотрудничество, сохраняя конфигурации в файле .mcp.json в корневом каталоге вашего проекта. Этот файл предназначен для проверки в системе контроля версий, обеспечивая всем членам команды доступ к одним и тем же инструментам и сервисам MCP. Когда вы добавляете сервер с областью проекта, Claude Code автоматически создает или обновляет этот файл с соответствующей структурой конфигурации. 
# Добавить сервер с областью проекта
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
Результирующий файл .mcp.json следует стандартизированному формату: 
{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}
По соображениям безопасности Claude Code запрашивает одобрение перед использованием серверов с областью проекта из файлов .mcp.json. Если вам нужно сбросить эти выборы одобрения, используйте команду claude mcp reset-project-choices.

​
Область пользователя

Серверы с областью пользователя обеспечивают доступность между проектами, делая их доступными во всех проектах на вашей машине, оставаясь приватными для вашей учетной записи пользователя. Эта область хорошо подходит для личных служебных серверов, инструментов разработки или сервисов, которые вы часто используете в разных проектах. 
# Добавить сервер пользователя
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

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

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

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

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

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

Claude Code поддерживает расширение переменных окружения в файлах .mcp.json, позволяя командам делиться конфигурациями, сохраняя гибкость для путей, специфичных для машины, и конфиденциальных значений, таких как ключи API. Поддерживаемый синтаксис:
  • ${VAR} - Расширяется до значения переменной окружения VAR
  • ${VAR:-default} - Расширяется до VAR, если установлена, иначе использует default
Места расширения: Переменные окружения можно расширить в:
  • command - Путь к исполняемому файлу сервера
  • args - Аргументы командной строки
  • env - Переменные окружения, передаваемые серверу
  • url - Для типов HTTP-серверов
  • headers - Для аутентификации HTTP-сервера
Пример с расширением переменных: 
{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "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. Отладка проблем в производстве
> "What are the most common errors in the last 24 hours?"
> "Show me the stack trace for error ID abc123"
> "Which deployment introduced these new errors?"

​
Пример: Подключение к GitHub для проверки кода

# 1. Добавьте сервер MCP GitHub
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 2. В Claude Code выполните аутентификацию, если необходимо
> /mcp
# Выберите "Authenticate" для GitHub

# 3. Теперь вы можете попросить Claude работать с GitHub
> "Review PR #456 and suggest improvements"
> "Create a new issue for the bug we just found"
> "Show me all open PRs assigned to me"

​
Пример: Запрос к базе данных PostgreSQL

# 1. Добавьте сервер базы данных со строкой подключения
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:[email protected]:5432/analytics"

# 2. Запрашивайте вашу базу данных естественным образом
> "What's our total revenue this month?"
> "Show me the schema for the orders table"
> "Find customers who haven't made a purchase in 90 days"

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

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

Добавьте сервер, требующий аутентификации

Например:
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp
2

Используйте команду /mcp в Claude Code

В Claude Code используйте команду:
> /mcp
Затем следуйте инструкциям в браузере для входа.
Советы:
  • Токены аутентификации хранятся безопасно и автоматически обновляются
  • Используйте “Clear authentication” в меню /mcp для отзыва доступа
  • Если ваш браузер не открывается автоматически, скопируйте предоставленный URL
  • Аутентификация OAuth работает с HTTP-серверами

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

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

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

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

# Пример: добавление HTTP-сервера с конфигурацией JSON
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

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

Проверьте, что сервер был добавлен

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

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

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

Импортируйте серверы из Claude Desktop

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

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

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

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

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

​
Используйте Claude Code как сервер MCP

Вы можете использовать сам Claude Code как сервер MCP, к которому могут подключаться другие приложения: 
# Запустите Claude как сервер MCP stdio
claude mcp serve
Вы можете использовать это в Claude Desktop, добавив эту конфигурацию в claude_desktop_config.json: 
{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
Настройка пути к исполняемому файлу: Поле command должно ссылаться на исполняемый файл Claude Code. Если команда claude не находится в PATH вашей системы, вам нужно указать полный путь к исполняемому файлу.Чтобы найти полный путь:
which claude
Затем используйте полный путь в вашей конфигурации:
{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}
Без правильного пути к исполняемому файлу вы столкнетесь с ошибками типа spawn claude ENOENT.
Советы:
  • Сервер предоставляет доступ к инструментам 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

1

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

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

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

Используйте формат @server:protocol://resource/path для ссылки на ресурс:
> Can you analyze @github:issue://123 and suggest a fix?

> Please review the API documentation at @docs:file://api/authentication
3

Несколько ссылок на ресурсы

Вы можете ссылаться на несколько ресурсов в одной подсказке:
> Compare @postgres:schema://users with @docs:file://database/user-model
Советы:
  • Ресурсы автоматически получаются и включаются как вложения при ссылке на них
  • Пути ресурсов поддерживают нечеткий поиск в автодополнении упоминания @
  • Claude Code автоматически предоставляет инструменты для перечисления и чтения ресурсов MCP, когда серверы их поддерживают
  • Ресурсы могут содержать любой тип контента, который предоставляет сервер MCP (текст, JSON, структурированные данные и т. д.)

​
Используйте подсказки MCP как команды слэша

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

​
Выполнение подсказок MCP

1

Откройте доступные подсказки

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

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

> /mcp__github__list_prs
3

Выполните подсказку с аргументами

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

> /mcp__jira__create_issue "Bug in login flow" high
Советы:
  • Подсказки MCP динамически обнаруживаются из подключенных серверов
  • Аргументы анализируются на основе определенных параметров подсказки
  • Результаты подсказки вводятся непосредственно в разговор
  • Имена серверов и подсказок нормализуются (пробелы становятся подчеркиваниями)

​
Конфигурация MCP для предприятия

Для организаций, которым требуется централизованный контроль над серверами MCP, Claude Code поддерживает управляемые предприятием конфигурации MCP. Это позволяет администраторам IT:
  • Контролировать, какие серверы MCP могут использовать сотрудники: Развертывание стандартного набора одобренных серверов MCP по всей организации
  • Предотвращать неавторизованные серверы MCP: Опционально ограничить пользователей от добавления собственных серверов MCP
  • Отключить MCP полностью: Полностью удалить функциональность MCP, если необходимо

​
Настройка конфигурации MCP для предприятия

Администраторы системы могут развернуть файл конфигурации MCP для предприятия рядом с файлом управляемых параметров:
  • macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
  • Windows: C:\ProgramData\ClaudeCode\managed-mcp.json
  • Linux: /etc/claude-code/managed-mcp.json
Файл managed-mcp.json использует тот же формат, что и стандартный файл .mcp.json: 
{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    },
    "company-internal": {
      "type": "stdio",
      "command": "/usr/local/bin/company-mcp-server",
      "args": ["--config", "/etc/company/mcp-config.json"],
      "env": {
        "COMPANY_API_URL": "https://internal.company.com"
      }
    }
  }
}

​
Ограничение серверов MCP с помощью списков разрешений и запретов

В дополнение к предоставлению управляемых предприятием серверов администраторы могут контролировать, какие серверы MCP пользователи могут настраивать, используя allowedMcpServers и deniedMcpServers в файле managed-settings.json:
  • macOS: /Library/Application Support/ClaudeCode/managed-settings.json
  • Windows: C:\ProgramData\ClaudeCode\managed-settings.json
  • Linux: /etc/claude-code/managed-settings.json
{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "sentry" },
    { "serverName": "company-internal" }
  ],
  "deniedMcpServers": [
    { "serverName": "filesystem" }
  ]
}
Поведение списка разрешений (allowedMcpServers):
  • undefined (по умолчанию): Нет ограничений - пользователи могут настраивать любой сервер MCP
  • Пустой массив []: Полная блокировка - пользователи не могут настраивать никакие серверы MCP
  • Список имен серверов: Пользователи могут настраивать только указанные серверы
Поведение списка запретов (deniedMcpServers):
  • undefined (по умолчанию): Никакие серверы не блокируются
  • Пустой массив []: Никакие серверы не блокируются
  • Список имен серверов: Указанные серверы явно блокируются во всех областях
Важные примечания:
  • Эти ограничения применяются ко всем областям: пользователь, проект, локальная и даже серверы предприятия из managed-mcp.json
  • Список запретов имеет абсолютный приоритет: Если сервер появляется в обоих списках, он будет заблокирован
Приоритет конфигурации предприятия: Конфигурация MCP предприятия имеет наивысший приоритет и не может быть переопределена пользовательскими, локальными или конфигурациями проекта.