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

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

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

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

​

Поиск и создание MCP servers

/plugin install mcp-server-dev@claude-plugins-official

/mcp-server-dev:build-mcp-server

​

Установка MCP servers

​

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

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

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

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

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

​

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

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

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

# Удалить server
claude mcp remove github

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

​

Динамические обновления инструментов

​

Автоматическое переподключение

​

Отправка сообщений через каналы

​

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

• Плагины определяют MCP servers в .mcp.json в корне плагина или встроенные в plugin.json
• Когда плагин включен, его MCP servers запускаются автоматически
• Plugin MCP tools отображаются рядом с вручную настроенными MCP tools
• Plugin servers управляются через установку плагина (не через команды /mcp)

{
  "mcpServers": {
    "database-tools": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
      "env": {
        "DB_URL": "${DB_URL}"
      }
    }
  }
}

{
  "name": "my-plugin",
  "mcpServers": {
    "plugin-api": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
      "args": ["--port", "8080"]
    }
  }
}

• Автоматический жизненный цикл: При запуске сеанса servers для включенных плагинов подключаются автоматически. Если вы включите или отключите плагин во время сеанса, запустите /reload-plugins для подключения или отключения его MCP servers
• Переменные окружения: используйте ${CLAUDE_PLUGIN_ROOT} для файлов плагина, ${CLAUDE_PLUGIN_DATA} для постоянного состояния, которое сохраняется при обновлении плагина, и ${CLAUDE_PROJECT_DIR} для стабильного корня проекта
• Доступ к переменным окружения пользователя: доступ к тем же переменным окружения, что и вручную настроенные servers
• Несколько типов транспорта: поддержка stdio, SSE и HTTP транспортов (поддержка транспорта может варьироваться в зависимости от server)

# В Claude Code, см. все MCP servers, включая plugin ones
/mcp

• Упакованное распределение: инструменты и servers упакованы вместе
• Автоматическая настройка: не требуется ручная конфигурация MCP
• Согласованность команды: все получают одинаковые инструменты при установке плагина

​

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

​

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

# Добавить server с локальной областью (по умолчанию)
claude mcp add --transport http stripe https://mcp.stripe.com

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

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "stripe": {
          "type": "http",
          "url": "https://mcp.stripe.com"
        }
      }
    }
  }
}

​

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

# Добавить server с областью проекта
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

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

​

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

# Добавить server пользователя
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

​

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

1. Локальная область
2. Область проекта
3. Область пользователя
4. Plugin-provided servers
5. claude.ai connectors

​

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

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

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

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

​

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

​

Пример: мониторинг ошибок с помощью Sentry

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

/mcp

Какие наиболее распространенные ошибки за последние 24 часа?

Покажите мне трассировку стека для ошибки ID abc123

Какое развертывание внесло эти новые ошибки?

​

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

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Проверьте PR #456 и предложите улучшения

Создайте новую проблему для найденной нами ошибки

Покажите мне все открытые PR, назначенные мне

​

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

claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"

Какой у нас общий доход в этом месяце?

Покажите мне схему для таблицы orders

Найдите клиентов, которые не совершали покупку в течение 90 дней

​

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

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

/mcp

​

Используйте фиксированный порт обратного вызова OAuth

# Фиксированный порт обратного вызова с динамической регистрацией клиента
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Используйте предварительно настроенные учетные данные OAuth

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' \
  --client-secret

claude mcp add-json my-server \
  '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"callbackPort":8080}}'

MCP_CLIENT_SECRET=your-secret claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

​

Переопределите обнаружение метаданных OAuth

{
  "mcpServers": {
    "my-server": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "oauth": {
        "authServerMetadataUrl": "https://auth.example.com/.well-known/openid-configuration"
      }
    }
  }
}

​

Ограничьте области OAuth

{
  "mcpServers": {
    "slack": {
      "type": "http",
      "url": "https://mcp.slack.com/mcp",
      "oauth": {
        "scopes": "channels:read chat:write search:read"
      }
    }
  }
}

​

Используйте динамические заголовки для пользовательской аутентификации

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "echo '{\"Authorization\": \"Bearer '\"$(get-token)\"'\"}'"
    }
  }
}

• Команда должна записать объект JSON пар строк ключ-значение в stdout
• Команда запускается в оболочке с timeout в 10 секунд
• Динамические заголовки переопределяют любые статические headers с тем же именем

​

Добавьте MCP servers из конфигурации JSON

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

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

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

# Пример: добавление HTTP server с предварительно настроенными учетными данными OAuth
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

claude mcp get weather-api

​

Импортируйте MCP servers из Claude Desktop

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

claude mcp list 

​

Используйте MCP servers из Claude.ai

/mcp

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

​

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

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

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

which claude

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

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

• Порог предупреждения выхода: Claude Code отображает предупреждение, когда выход любого инструмента MCP превышает 10 000 токенов
• Настраиваемый лимит: вы можете отрегулировать максимальное количество разрешенных токенов выхода MCP, используя переменную окружения MAX_MCP_OUTPUT_TOKENS
• Лимит по умолчанию: максимум по умолчанию составляет 25 000 токенов
• Область: переменная окружения применяется к инструментам, которые не объявляют свой собственный лимит. Инструменты, которые устанавливают anthropic/maxResultSizeChars, используют это значение вместо этого для текстового контента, независимо от того, что установлено MAX_MCP_OUTPUT_TOKENS. Инструменты, которые возвращают данные изображения, все еще подлежат MAX_MCP_OUTPUT_TOKENS

export MAX_MCP_OUTPUT_TOKENS=50000
claude

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

​

Повысьте лимит для конкретного инструмента

{
  "name": "get_schema",
  "description": "Returns the full database schema",
  "_meta": {
    "anthropic/maxResultSizeChars": 200000
  }
}

​

Ответьте на запросы MCP elicitation

• Режим формы: Claude Code показывает диалог с полями формы, определенными server (например, приглашение имени пользователя и пароля). Заполните поля и отправьте.
• Режим URL: Claude Code открывает URL браузера для аутентификации или одобрения. Завершите процесс в браузере, затем подтвердите в CLI.

​

Используйте MCP ресурсы

​

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

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

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

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

​

Масштабирование с помощью MCP Tool Search

​

Как это работает

​

Для авторов MCP server

• какую категорию задач обрабатывают ваши инструменты
• когда Claude должен искать ваши инструменты
• ключевые возможности, которые предоставляет ваш server

​

Настройте tool search

# Используйте пользовательский порог 5%
ENABLE_TOOL_SEARCH=auto:5 claude

# Полностью отключите tool search
ENABLE_TOOL_SEARCH=false claude

{
  "permissions": {
    "deny": ["ToolSearch"]
  }
}

​

Исключите server из откладывания

{
  "mcpServers": {
    "core-tools": {
      "type": "http",
      "url": "https://mcp.example.com/mcp",
      "alwaysLoad": true
    }
  }
}

​

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

​

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

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue "Bug in login flow" high

​

Управляемая конфигурация MCP

1. Исключительный контроль с managed-mcp.json: развертывание фиксированного набора MCP servers, которые пользователи не могут изменять или расширять
2. Контроль на основе политики с allowlists/denylists: позволить пользователям добавлять свои собственные servers, но ограничить, какие из них разрешены

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

​

Вариант 1: Исключительный контроль с managed-mcp.json

• macOS: /Library/Application Support/ClaudeCode/managed-mcp.json
• Linux и WSL: /etc/claude-code/managed-mcp.json
• Windows: C:\Program Files\ClaudeCode\managed-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"
      }
    }
  }
}

​

Вариант 2: Контроль на основе политики с allowlists и denylists

​

Опции ограничения

1. По имени server (serverName): соответствует настроенному имени server
2. По команде (serverCommand): соответствует точной команде и аргументам, используемым для запуска stdio servers
3. По шаблону URL (serverUrl): соответствует URL-адресам удаленных servers с поддержкой подстановочных символов

​

Пример конфигурации

{
  "allowedMcpServers": [
    // Разрешить по имени server
    { "serverName": "github" },
    { "serverName": "sentry" },

    // Разрешить по точной команде (для stdio servers)
    { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem"] },
    { "serverCommand": ["python", "/usr/local/bin/approved-server.py"] },

    // Разрешить по шаблону URL (для удаленных servers)
    { "serverUrl": "https://mcp.company.com/*" },
    { "serverUrl": "https://*.internal.corp/*" }
  ],
  "deniedMcpServers": [
    // Заблокировать по имени server
    { "serverName": "dangerous-server" },

    // Заблокировать по точной команде (для stdio servers)
    { "serverCommand": ["npx", "-y", "unapproved-package"] },

    // Заблокировать по шаблону URL (для удаленных servers)
    { "serverUrl": "https://*.untrusted.com/*" }
  ]
}

​

Как работают ограничения на основе команд

• Массивы команд должны совпадать точно — как команда, так и все аргументы в правильном порядке
• Пример: ["npx", "-y", "server"] НЕ будет совпадать с ["npx", "server"] или ["npx", "-y", "server", "--flag"]

• Когда allowlist содержит любые записи serverCommand, stdio servers должны совпадать с одной из этих команд
• Stdio servers не могут пройти только по имени, когда присутствуют ограничения команд
• Это гарантирует, что администраторы могут применять, какие команды разрешены для запуска

• Удаленные servers (HTTP, SSE, WebSocket) используют сопоставление на основе URL, когда в allowlist существуют записи serverUrl
• Если записей URL не существует, удаленные servers возвращаются к сопоставлению на основе имени
• Ограничения команд не применяются к удаленным servers

​

Как работают ограничения на основе URL

• https://mcp.company.com/* - разрешить все пути на конкретном домене
• https://*.example.com/* - разрешить любой поддомен example.com
• http://localhost:*/* - разрешить любой порт на localhost

• Когда allowlist содержит любые записи serverUrl, удаленные servers должны совпадать с одним из этих шаблонов URL
• Удаленные servers не могут пройти только по имени, когда присутствуют ограничения URL
• Это гарантирует, что администраторы могут применять, какие удаленные конечные точки разрешены

{
  "allowedMcpServers": [
    { "serverUrl": "https://mcp.company.com/*" },
    { "serverUrl": "https://*.internal.corp/*" }
  ]
}

{
  "allowedMcpServers": [
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverCommand": ["npx", "-y", "approved-package"] }
  ]
}

{
  "allowedMcpServers": [
    { "serverName": "github" },
    { "serverName": "internal-tool" }
  ]
}

​

Поведение allowlist (allowedMcpServers)

• undefined (по умолчанию): нет ограничений - пользователи могут настроить любой MCP server
• Пустой массив []: полная блокировка - пользователи не могут настроить какие-либо MCP servers
• Список записей: пользователи могут настроить только servers, которые совпадают по имени, команде или шаблону URL

​

Поведение denylist (deniedMcpServers)

• undefined (по умолчанию): никакие servers не блокируются
• Пустой массив []: никакие servers не блокируются
• Список записей: указанные servers явно блокируются во всех областях

​

Важные примечания

• Вариант 1 и вариант 2 можно комбинировать: если существует managed-mcp.json, он имеет исключительный контроль и пользователи не могут добавлять servers. Allowlists/denylists все еще применяются к самим управляемым servers.
• Denylist имеет абсолютный приоритет: если server совпадает с записью denylist (по имени, команде или URL), он будет заблокирован, даже если он находится в allowlist
• Ограничения на основе имени, команды и URL работают вместе: server проходит, если он совпадает с либо записью имени, записью команды, либо шаблоном URL (если не заблокирован denylist)