Справочник по туннелям MCP

Конфигурация прокси

Прокси считывает свою конфигурацию из /etc/mcp-gateway/config.yaml (Compose) или из отрендеренного ConfigMap (Helm, заполняется из gateway.config.*).

Для маршрутов с вышестоящими серверами по https:// задайте хотя бы одно из значений upstream.tls.ca_file или upstream.tls.include_system_cas; в противном случае у прокси не будет якоря доверия для сертификата вышестоящего сервера.

Сопоставление маршрутов

routes — это плоское строковое сопоставление (map[string]string), а не список. Прокси сначала ищет входящее имя хоста по точному совпадению, затем удаляет суффикс tunnel_domain и сопоставляет оставшийся поддомен. При сопоставлении учитывается только имя хоста; путь запроса и строка запроса передаются вышестоящему MCP-серверу без изменений.

Каждое значение вышестоящего сервера должно иметь строго вид scheme://host:port. Порт обязателен. Указание пути отклоняется при загрузке конфигурации с ошибкой invalid upstream (must be scheme://host:port).

API туннелей

См. справочник по Admin API туннелей MCP для всех конечных точек, схем запросов и ответов, а также примеров для разных языков.

Обязательные заголовки для каждого запроса:

Требования к сертификатам

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

CA-сертификат

Загружается с помощью POST /v1/organizations/tunnels/{tunnel_id}/certificates. Туннель может содержать до двух активных CA-сертификатов одновременно, что позволяет выполнять ротацию без простоя.

• В кодировке PEM, один сертификат, размером до 8 кБ.
• Присутствует расширение BasicConstraints с CA:TRUE, помеченное как критическое.
• Присутствует расширение SubjectKeyIdentifier.
• KeyUsage включает keyCertSign.
• В пределах срока действия.
• RSA 2048 бит или больше, либо ECDSA P-256 или больше, с подписью SHA-256 или более стойкой.

Серверный сертификат

Предъявляется прокси во время внутреннего TLS.

• Подписан непосредственно зарегистрированным CA (без промежуточных сертификатов).
• Присутствует расширение AuthorityKeyIdentifier, совпадающее с SubjectKeyIdentifier CA.
• Subject Alternative Name включает DNS-имя, соответствующее <route>.<tunnel-domain>. Подстановочное имя *.<tunnel-domain> покрывает все маршруты.
• Если присутствует расширение ExtendedKeyUsage, оно включает serverAuth.
• В пределах срока действия.
• RSA 2048 бит или больше, либо ECDSA P-256 или больше, с подписью SHA-256 или более стойкой.

Компонент настройки генерирует CA на основе ECDSA P-256 со сроком действия пять лет и серверный сертификат RSA 4096 бит с подстановочным SAN и сроком действия 90 дней.

Компонент настройки

Компонент настройки поставляется внутри образа mcp-proxy в виде исполняемого файла setup. Запускайте его с помощью docker compose run --rm setup <subcommand> (Compose) или полагайтесь на хуки и CronJob чарта (Helm).

setup init

Подключается к туннелю, созданному вами в Console, генерирует CA и серверный сертификат, регистрирует CA, получает токен туннеля и записывает все выходные данные в указанное место назначения.

Команда аутентифицируется через Workload Identity Federation. Она считывает ANTHROPIC_FEDERATION_RULE_ID, ANTHROPIC_ORGANIZATION_ID, ANTHROPIC_WORKSPACE_ID (необязательно) и ровно одно из ANTHROPIC_IDENTITY_TOKEN_FILE или ANTHROPIC_IDENTITY_TOKEN. См. справочник по WIF для актуальной семантики этих переменных; компонент настройки определяет сервисный аккаунт из правила федерации, поэтому отдельно ANTHROPIC_SERVICE_ACCOUNT_ID не требуется.

setup renew-cert

Выпускает новый серверный сертификат, подписанный сохранённым CA. Не выполняет вызовов API.

Установка --renew-before=720h делает команду холостой операцией, если остаётся более 30 дней срока действия, поэтому её безопасно запускать по фиксированному расписанию.