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

​

Что вы можете делать с 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 серверов

​

Вариант 1: Добавление удалённого HTTP сервера

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

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

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

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

​

Вариант 4: Добавление удалённого WebSocket сервера

claude mcp add-json events-server \
  '{"type":"ws","url":"wss://mcp.example.com/socket","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'

​

Добавление сервера из инструкций по настройке, написанных для другого клиента

• URL такой как https://mcp.example.com/mcp: сервер удалённый.
• Команда запуска такая как npx -y @example/mcp-server: сервер работает на вашей машине.
• Блок JSON mcpServers: конфигурация, написанная для файла параметров другого клиента.

​

Из URL

claude mcp add --transport http example https://mcp.example.com/mcp

​

Из команды npx, uvx или двоичного файла

claude mcp add example --env API_KEY=your-key -- npx -y @example/mcp-server

​

Из блока JSON mcpServers

• url без type: добавьте "type": "http", "type": "sse" или "type": "ws" для соответствия конечной точке. Claude Code читает запись без type как stdio сервер, поэтому запись url без type не работает.
• Ключ с символами, отличными от букв, цифр, дефисов и подчёркиваний: выберите имя сервера, которое использует только эти символы. В противном случае ключ — это имя сервера.

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "@example/mcp-server"]
    }
  }
}

claude mcp add-json example '{"command":"npx","args":["-y","@example/mcp-server"]}'

​

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

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

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

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

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

​

Статус сервера

• ⏸ Pending approval (run `claude` to approve): сервер с областью проекта из .mcp.json, который вы ещё не одобрили. Claude Code показывает его как в claude mcp list, так и в claude mcp get <name>. Запустите claude интерактивно, чтобы просмотреть и одобрить его.
• ✘ Rejected (see disabledMcpjsonServers in settings): сервер .mcp.json, который запись disabledMcpjsonServers отклоняет. Claude Code показывает его только в claude mcp get <name>.
• ⊘ Disabled for this project (re-enable via /mcp): сервер, который список disabledMcpServers проекта называет. Claude Code показывает его как в claude mcp list, так и в claude mcp get <name>. Включите сервер обратно из панели /mcp. До версии v2.1.238 обе команды подключались к отключённому серверу для проверки здоровья и сообщали результат подключения.

​

Одобрения серверов проекта и доверие рабочей области

• ваш пользовательский ~/.claude/settings.json
• управляемые параметры
• параметры, переданные с --settings

​

Деталь статуса сервера

• Путь и запрос никогда не появляются в этом сообщении.
• Для сервера в локальной, проектной или пользовательской области или в управляемой конфигурации MCP источник показывает хост, как написано в этой конфигурации, поэтому ссылка ${VAR} в хосте не развёрнута в сообщении.
• Для отказа без статуса или кода ошибки Claude Code показывает текст ошибки без источника.

​

Предупреждения конфигурации

• Скрытое пробельное пространство: Claude Code предупреждает, когда значение конфигурации MCP несёт скрытое ведущее или конечное пробельное пространство, которое часто происходит из вставки токена с конечным переводом строки. Claude Code проверяет command, url, каждую запись args и значения и имена ключей под env и headers. Claude Code показывает предупреждение в выводе claude mcp list и в /mcp, называя затронутые поля без повторения их значений, например Leading or trailing whitespace in: headers.Authorization. Claude Code не обрезает пробельное пространство и использует значения точно так, как написано, поэтому отредактируйте конфигурацию, чтобы удалить его.
• Одно имя в более чем одной области: если вы определяете одно имя сервера в более чем одной области с разными конечными точками, Claude Code предупреждает о конфликте в выводе claude mcp list и в /mcp. Claude Code хранит входы OAuth для каждой конечной точки, поэтому когда вы аутентифицируете определение, которое загружается в одном проекте, вам по-прежнему нужно отдельно войти в проект, где загружается другое определение. Сохраните конечную точку, которую вы хотите, и удалите остальные с помощью claude mcp remove <name> --scope <scope>. В предупреждении Claude Code цитирует конечную точку каждой области, как написано в вашей конфигурации, с ссылками ${VAR} не развёрнутыми, поэтому она никогда не показывает разрешённое значение, такое как ключ API.
• Зарезервированные имена: Claude Code резервирует имена своих встроенных серверов, включая workspace, claude-in-chrome, computer-use, Claude Preview и Claude Browser. Если ваша конфигурация определяет сервер с зарезервированным именем, Claude Code пропускает его при загрузке и показывает предупреждение, прося вас переименовать его. claude mcp add отклоняет зарезервированное имя с ошибкой. Claude Preview и Claude Browser оба называют встроенный сервер, который использует панель предпросмотра настольного приложения Claude Code. До версии v2.1.205 Claude Browser не был зарезервирован, поэтому пользовательский сервер мог зарегистрироваться под этим именем.
• Отсутствующая переменная окружения: если ссылка ${VAR} в конфигурации сервера называет переменную, которая не установлена и не имеет :-default, Claude Code предупреждает в выводе claude mcp list и в /mcp, называя переменную, и по-прежнему загружает сервер с текстом ${VAR} не развёрнутым. Установите переменную или добавьте резервный вариант ${VAR:-default}. В url и headers удалённого сервера некоторые переменные учётных данных читаются как пустые вместо этого, без предупреждения.

​

Доступность инструментов

• С поиском инструментов, по умолчанию: ожидание происходит внутри вызова ToolSearch.
• Без поиска инструментов: Claude использует инструмент WaitForMcpServers вместо этого. Конфигурации без поиска инструментов включают пользовательский ANTHROPIC_BASE_URL, ENABLE_TOOL_SEARCH=false и модель более ранней версии, чем поколение Claude 4.5 на платформе Agent Platform Google Cloud.
• На развёртывании Microsoft Foundry размещённом на Azure: Claude начинает на пути поиска инструментов, а не с WaitForMcpServers, так как Claude Code обнаруживает отклонение на стороне сервера развёртывания только из API. После того как Claude Code переключит это развёртывание на предварительную загрузку, инструменты с сервера, который завершает подключение, становятся доступны при следующем запросе Claude.

​

Отключение сервера без его удаления

• disabledMcpServers: список отказа для пользовательских серверов, серверов плагинов, серверов, которые ваша организация предоставляет через управляемые параметры, соединителей claude.ai, которые Claude Code получает сам, и встроенных серверов, которые по умолчанию включены. Claude Code не подключается к серверу, который вы перечисляете здесь. Когда вы отключаете соединитель claude.ai с помощью переключателя /mcp для каждого проекта, описанного в Отключение соединителей claude.ai, Claude Code записывает его в этот список под его отображаемым именем, например claude.ai Slack.
• enabledMcpServers: список включения для встроенных серверов, которые по умолчанию отключены, такие как computer-use. Claude Code подключается к серверу, отключённому по умолчанию, только когда вы перечисляете его здесь.

​

Среды выполнения клиента MCP

• Сеансы на Amazon Bedrock, Claude Platform на AWS, платформе Agent Platform Google Cloud или Microsoft Foundry, если платформа-хост, которая встраивает Claude Code, не устанавливает CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST
• Сеансы, вошедшие через шлюз приложений Claude
• Сеансы, где вы отключаете телеметрию или получение флагов функций, например с DISABLE_TELEMETRY

• Спрашивает HTTP серверы, поддерживают ли они более новый пересмотр, и использует его с теми, которые это делают. Он также спрашивает серверы соединителей claude.ai в сеансах, где он получает флаги функций. Чтобы заставить его спрашивать stdio серверы или серверы соединителей в каждом сеансе, установите MCP_PROTOCOL_NEGOTIATION на auto. Он подключается к каждому другому серверу, как v1 это делает.
• Получает уведомления list_changed с серверов на более новом пересмотре через поток, который он держит открытым.
• Не регистрирует сервер канала, который подключается на более новом пересмотре, потому что этот пересмотр не может нести сообщения канала.
• Не удаётся вход MCP OAuth, чей ответ авторизации называет неожиданного издателя.

​

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

​

Потоки уведомлений на среде выполнения v2

• Поток закрывается снова в течение 10 секунд: Claude Code переоткрывает его до трёх раз, затем останавливается для этого соединения.
• Поток остаётся открытым дольше 10 секунд, затем закрывается, как потоки к бессерверным хостам обычно делают: после пяти переоткрытий в час Claude Code ждёт около шести часов перед следующим.

​

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

​

Отключения удалённого сервера во время сеанса

• В интерактивном сеансе: /mcp показывает сервер как ожидающий, пока Claude Code переподключается. После пяти неудачных попыток Claude Code отмечает сервер как неудачный или как нуждающийся в аутентификации, когда сервер нуждается в авторизации снова. Когда он отмечает сервер как неудачный, вы видите уведомление MCP server "<name>" disconnected · open /mcp to reconnect. Вы можете повторить попытку вручную из /mcp.
• В запусках claude -p и сеансах Agent SDK: Claude Code переподключается по тому же расписанию, без панели /mcp для показа попыток.

​

Неудачные первые подключения

• Первое подключение WebSocket сервера
• Ошибка аутентификации или не найдено, потому что это требует изменения конфигурации для разрешения. Когда headersHelper — единственный источник сервера заголовка Authorization, Claude Code повторяет попытку ошибки аутентификации в любом случае, потому что он повторно запускает помощника при каждой попытке и может подобрать свежие учётные данные

​

Неудачные запросы обнаружения

​

Как Claude узнаёт, что сервер не удался

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

​

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

​

Автоматическое фоновое выполнение долгих вызовов инструментов

• Вызовы из подагентов; Claude Code фоновое выполнение только вызовов основного разговора
• Вызовы к IDE серверам
• Вызовы в неинтерактивном режиме, если только CLAUDE_AUTO_BACKGROUND_TASKS не установлена на 1, так как одноразовый запуск может завершиться до прибытия результата

​

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

• Плагины определяют MCP серверы в .mcp.json в корне плагина или встроенные в plugin.json
• Когда вы включаете плагин, Claude Code автоматически запускает его MCP серверы
• Claude Code предлагает инструменты MCP плагинов наряду с вручную настроенными инструментами MCP
• Вы добавляете и удаляете серверы плагинов, устанавливая или удаляя плагин, а не с помощью команд /mcp. Вы по-прежнему можете переключить установленный сервер плагина в /mcp, что останавливает Claude Code от подключения к нему без удаления плагина

{
  "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"]
    }
  }
}

• Автоматический жизненный цикл: серверы подключаются и отключаются в этих точках:
  • При запуске сеанса Claude Code автоматически подключает серверы для включённых плагинов. В /mcp удалённый (HTTP или SSE) сервер плагина, который вы использовали раньше, может показать статус cached вместо этого; Claude Code подключает его, когда Claude впервые вызывает один из его инструментов
  • Если вы включаете или отключаете плагин во время сеанса, Claude Code подключает или отключает его MCP серверы, когда изменение применяется. Применение изменений плагина без перезагрузки описывает, когда это происходит. В сеансе без интерактивного терминала /reload-plugins не подключает и не отключает MCP серверы плагинов; эти изменения вступают в силу в вашем следующем сеансе
  • Когда вы перезагружаете, Claude Code сохраняет живые соединения серверов плагинов, чья конфигурация не изменилась, и делает то же самое, когда вы заменяете список MCP сервера сеанса из Agent SDK без их названия
  • Когда вы перемещаете сеанс с /cd на v2.1.246 или позже, Claude Code подключает серверы плагинов, которые включают параметры новой директории, и отключает серверы плагинов, которые больше не включены, поэтому вам не нужно запускать /reload-plugins после перемещения
  • В облачных сеансах вызов MCP к серверу плагина, который ещё не подключён, такой как сразу после пробуждения неактивного сеанса, запускает сервер по требованию и ждёт его подключения
• Заполнители пути: ${CLAUDE_PLUGIN_ROOT} разрешается в директорию установки плагина, ${CLAUDE_PLUGIN_DATA} в его директорию постоянного состояния и ${CLAUDE_PROJECT_DIR} в стабильный корень проекта. Подстановка применяется к:
  • серверам stdio: command, args, env
  • серверам http, sse и ws: url, headers и headersHelper. До версии v2.1.195 headersHelper передавал заполнитель как буквальную строку
• Доступ к пользовательскому окружению: доступ к тем же переменным окружения, что и вручную настроенные серверы
• Несколько типов транспорта: поддержка транспортов stdio, SSE, HTTP и WebSocket, хотя поддержка транспорта может варьироваться по серверам

mcp__plugin_my-plugin_database-tools__query

​

Области установки 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 shared-server --scope project https://example.com/mcp

{
  "mcpServers": {
    "shared-server": {
      "type": "http",
      "url": "https://example.com/mcp"
    }
  }
}

• Добавьте его в disabledMcpjsonServers, что блокирует его в каждом режиме разрешений.
• Исключите параметры проекта полностью с помощью --setting-sources или опции settingSources SDK.
• Запустите сеанс с --strict-mcp-config. Claude Code затем использует только MCP servers, которые вы передаете с --mcp-config. Пропуск запроса одобрения для servers с областью проекта, которые Claude Code не загружает, требует Claude Code v2.1.246 или позже; до v2.1.246 строгий сеанс все еще ждал одобрения для них, что оставляло фоновые сеансы в ожидании при запуске. См. Исключительный контроль с managed-mcp.json для того, что флаг делает под управляемым файлом MCP.

​

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

# Добавить 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}"
      }
    }
  }
}

​

Неустановленные переменные без значения по умолчанию

​

Переменные учетных данных, которые читаются как пустые

• Собственные учетные данные Claude Code, такие как ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN
• Учетные данные вашего облачного провайдера, такие как AWS_BEARER_TOKEN_BEDROCK
• Другие учетные данные, которые несет ваше окружение, такие как HTTPS_PROXY и NPM_TOKEN

​

Как ссылки отображаются в /mcp и выводе CLI

• URL или командная строка в представлении деталей /mcp server
• Вывод claude mcp list и claude mcp get

​

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

​

Пример: подключение к 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 серверами

• Для сервера, на который вы еще не вошли, любой из этих кодов состояния помечает его в /mcp, чтобы вы могли завершить поток OAuth.
• Для коннектора claude.ai, 401, вызванный отклонением claude.ai вашего токена сеанса, не помечает коннектор, потому что повторная авторизация коннектора не может исправить вашу учетную запись. Claude Code показывает состояние отклонения токена сеанса вместо этого.
• Для сервера, чей заголовок Authorization вы настроили в headers или через headersHelper, 401 или 403 при подключении не помечает сервер, потому что учетные данные для исправления — это те, которые вы настроили. Claude Code вместо этого сообщает о неудачном соединении. Если вы установили этот заголовок из ссылки ${VAR}, проверьте, является ли эта переменная одной из тех, которые Claude Code читает как пустые.
• Для коннектора доставленного в облачный сеанс, Claude Code не запускает поток входа, потому что прокси сеанса аутентифицируется на коннекторе с авторизацией, которую вы предоставили в claude.ai. Когда коннектор там требует повторной авторизации, переподключитесь на claude.ai/customize/connectors вместо сеанса.

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

/mcp

​

Аутентификация из командной строки

claude mcp login sentry

claude mcp login sentry --no-browser

​

Используйте фиксированный порт обратного вызова 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
• Claude Code запускает команду в оболочке и отказывается от нее через 10 секунд
• Claude Code выбирает рабочий каталог команды по месту, где вы настроили сервер, поэтому дайте скрипт как абсолютный путь или поместите его на PATH
• Динамические заголовки переопределяют любые статические headers с тем же именем

​

Где запускается помощник

​

Какие переменные может читать помощник

• Удалено: сервер в проекте .mcp.json или в плагине, и встроенный сервер в файле агента из вашего проекта или из каталога --add-dir
• Не удалено: сервер в области пользователя или локальной области, в управляемом MCP, из коннектора claude.ai, или предоставленный SDK или --mcp-config, и встроенный сервер в файле агента из ~/.claude/agents/, из управляемых параметров или переданный с --agents

​

Доверьте папку перед запуском ее headersHelper

• Доверие, которое не считается: доверие родительской папки и автоматическое доверие, которое получает сеанс claude -p или SDK для hooks в файлах параметров
• Пока вы не доверите папке: Claude Code подключает сервер только с его статическими headers. В сеансе claude -p или SDK он также выводит одну строку headersHelper not run на stderr, сообщая вам, как предоставить доверие.
• Доверие без диалога: установите projects["<path>"].hasTrustDialogAccepted на true в ~/.claude.json. <path> — это папка, на которой Project allow rules and workspace trust говорит Claude Code ключ доверия.

​

Добавьте 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 серверов из claude.ai

/mcp

• ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper активны
• Активен сторонний поставщик, такой как Amazon Bedrock или Agent Platform Google Cloud
• ANTHROPIC_PROFILE, переменные федерации или активный профиль Anthropic предоставляют учётные данные
• CLAUDE_CODE_OAUTH_TOKEN содержит токен из claude setup-token, который может только делать запросы к модели

1. Запустите /login, чтобы войти снова.
2. Переподключите connector из /mcp.

​

Как connectors достигают Claude Code

• Облачные сеансы: записи allowedMcpServers и deniedMcpServers, которые достигают сеанса, например через параметры, управляемые сервером, также фильтруют доставленные connectors. Прокси сеанса переписывает URL каждого connector, поэтому шаблон serverUrl, написанный для собственного URL connector, не совпадает с ним. Чтобы допустить доставленные connectors наряду со списком разрешений URL в самостоятельной среде, добавьте записи serverUrl, указанные в разделе Трафик Connector покидает вашу сеть. Claude Code отбрасывает доставленные connectors, когда на хосте, который запускает сеанс, присутствует managed-mcp.json, например хост самостоятельного runner, независимо от того, установили ли вы allowAllClaudeAiMcps.
• Локальные и SSH сеансы настольного приложения: настольное приложение регистрирует connectors как внутрипроцессные серверы type: "sdk", и никакой параметр MCP или managed-mcp.json не достигает их. Пользователь держит connector вне своих собственных сеансов, отключив его на claude.ai/customize/connectors. Организация блокирует инструменты connector или полностью отключает Claude Code в настольном приложении.

​

Элементы управления организацией для инструментов connector

• Инструмент установлен на ask: Claude Code запрашивает при каждом вызове с причиной Your organization requires approval for this tool. Запрос появляется даже в режимах разрешений acceptEdits, auto и bypassPermissions permission modes, и никогда не предлагает опцию запомнить ваш выбор. Правила разрешений, которые совпадают с инструментом, также не пропускают запрос. В режиме dontAsk, который никогда не запрашивает, Claude Code отклоняет вызов вместо этого.
• Инструмент установлен на blocked: Claude Code фильтрует инструмент перед тем, как Claude его видит, поэтому он никогда не появляется в списке инструментов. Настольное приложение и чат claude.ai применяют тот же параметр blocked, поэтому Claude не может использовать инструмент там либо, и вы не можете скрыть инструмент из сеансов настольного приложения, сохраняя его доступным в чате. Настольное приложение пропускает connector, все инструменты которого заблокированы.

​

Отключение connectors claude.ai

{
  "disableClaudeAiConnectors": true
}

ENABLE_CLAUDEAI_MCP_SERVERS=false claude

​

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

# Запустить Claude как stdio MCP сервер
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
• Превышение лимита: когда результат без содержимого изображения превышает лимит, Claude Code сохраняет его в файл и заменяет его в разговоре сообщением, которое указывает путь к файлу, чтобы Claude прочитал файл, когда ему нужно содержимое. Файл находится в директории tool-results сеанса в ~/.claude/projects/.

export MAX_MCP_OUTPUT_TOKENS=50000
claude

​

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

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

​

Изображения в результатах инструментов

​

Схемы входных данных инструментов с комбинатором корневого уровня

• allOf: свойства из каждой ветви объединяются, и список required каждой ветви по-прежнему применяется
• anyOf и oneOf: свойства из каждой ветви объединяются, и список required каждой ветви описывается в описании инструмента вместо того, чтобы быть принудительно применяемым схемой

​

Инструменты с недействительными схемами входных данных

• Имена свойств верхнего уровня должны быть длиной от 1 до 64 символов и использовать только буквы и цифры ASCII, _, . и -
• Схема должна быть действительной в соответствии с метасхемой JSON Schema draft 2020-12. Claude Code применяет эту проверку к схемам, которые не объявляют $schema, и к схемам, которые объявляют draft 2020-12. Схема, которая объявляет любой другой диалект, пропускает эту проверку, хотя проверка имен свойств выше все еще применяется

​

Требование одобрения для конкретного инструмента

{
  "name": "grant_access",
  "description": "Requests access to a protected resource",
  "_meta": {
    "anthropic/requiresUserInteraction": true
  }
}

​

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

• Режим формы: Claude Code показывает диалог с полями формы, определенными сервером (например, запрос имени пользователя и пароля). Заполните поля и отправьте.
• Режим URL: Claude Code спрашивает, открыть ли ссылку в вашем браузере, и открывает её при вашем согласии. Серверы используют этот режим для потока, который завершается вне терминала, например для входа в систему.

​

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

​

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

Can you analyze @github:issue://123 and suggest a fix?

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

Compare @postgres:schema://users with @docs:file://database/user-model

​

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

​

Для авторов серверов MCP

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

​

Настройка поиска инструментов

• Claude Opus 4.5, Sonnet 4.5, Haiku 4.5 и позже: поиск инструментов включен по умолчанию, как и на API Anthropic.
• Более ранние модели Agent Platform: Claude Code загружает все инструменты MCP заранее, потому что их стеки обслуживания отклоняют требуемый заголовок бета-версии. ENABLE_TOOL_SEARCH=true не переопределяет это.

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

# Полное отключение поиска инструментов
ENABLE_TOOL_SEARCH=false claude

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

​

Исключение сервера из отложения

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

​

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

​

Выполнение MCP prompts

/mcp__github__list_prs

/mcp__github__pr_review 456

/mcp__jira__create_issue login-bug high

​

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