Туннели MCP

Туннели MCP позволяют подключать Claude к серверам Model Context Protocol (MCP), которые работают внутри вашей частной сети. Трафик проходит через соединение, использующее только исходящие подключения, поэтому вам не нужно открывать входящие порты брандмауэра, предоставлять доступ к сервисам из публичного интернета или добавлять диапазоны IP-адресов Anthropic в список разрешённых на вашем сервере.

Информацию о соответствии требованиям Zero Data Retention и HIPAA BAA см. в разделе API и хранение данных.



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

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

• cloudflared: коннектор туннеля с открытым исходным кодом от Cloudflare. Он инициирует соединения только в исходящем направлении к границе туннеля (tunnel edge) и передаёт зашифрованный трафик от Anthropic к вашему прокси.
• Прокси: компонент маршрутизации от Anthropic. Он терминирует внутренний TLS, проверяет, что IP-адреса вышестоящих серверов попадают в разрешённый диапазон, и маршрутизирует каждый запрос к правильному вышестоящему серверу MCP (upstream MCP server) на основе имени хоста.

Каждый сервер MCP, который вы открываете, получает имя хоста в вашем домене туннеля (например, docs.<your-tunnel-domain>). Вы прикрепляете эти имена хостов к сессии Managed Agent в Claude Console или передаёте их в Messages API через коннектор MCP.



Предварительные требования

Перед развёртыванием убедитесь, что у вас есть:

• Цель развёртывания: кластер Kubernetes или виртуальная машина с Docker и Docker Compose.
• Туннель. Создайте его в Claude Console (см. Создание туннеля) или через API; хук настройки Helm-чарта также может создать его для вас во время установки.
• Способ аутентификации вашего стека в Tunnels API. Выберите один из вариантов:
  • Программный доступ (рекомендуется). Настройте Workload Identity Federation при создании туннеля. Ваш стек выпускает краткосрочные токены API от вашего провайдера идентификации, получает токен туннеля, а также автоматически генерирует и регистрирует сертификат CA. Требуется разрешение на управление правилами федерации, зарегистрированный издатель OIDC и правило федерации с областью действия workspace:manage_tunnels.
  • Вручную. Предоставьте статические учётные данные самостоятельно: токен туннеля из Console и сертификат сервера, подписанный CA, который вы там регистрируете. См. Получение сведений о подключении и Добавление сертификата CA.
• Один или несколько серверов MCP, работающих в вашей частной сети. Примеры см. в разделе Удалённые серверы MCP.
• Исходящее подключение, как указано в разделе Сетевые требования.



Сетевые требования



Модель безопасности



Уровни безопасности

Три независимых уровня защищают каждый запрос:

Транспорт туннеля работает в сети Cloudflare. Поскольку прокси терминирует внутренний TLS, используя сертификат, которым владеете только вы, Cloudflare не может читать полезную нагрузку запросов или ответов. Anthropic не подключается к туннелю до тех пор, пока не будет зарегистрирован сертификат CA, поэтому полезная нагрузка всегда зашифрована при прохождении через сеть Cloudflare. Cloudflare получает метаданные соединения; см. раздел Что может наблюдать транспортный провайдер.



Модель разделения ответственности



Что может наблюдать транспортный провайдер

Cloudflare предоставляет исходящий транспорт. Он не может читать полезную нагрузку запросов или ответов MCP, но получает следующие метаданные соединения:

• исходящий IP-адрес хоста, на котором работает cloudflared
• отпечаток хоста cloudflared
• время соединения и объём переданных байтов
• поддомен *.tunnel.anthropic.com, назначенный вашему туннелю

Соглашение Anthropic с Cloudflare ограничивает использование Cloudflare этой телеметрии. Cloudflare выступает в качестве субподрядчика по обработке данных для этого исследовательского предварительного просмотра.



Развёртывание туннеля

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

Как выбрать между ними:

• Цель развёртывания
  • Helm при развёртывании в Kubernetes.
  • Docker Compose для одного хоста или локального тестирования.
• Аутентификация для настройки
  • Программный доступ (через Workload Identity Federation), когда у вас есть провайдер идентификации OIDC, такой как кластер Kubernetes, облачный IAM или SPIFFE.
  • Учётные данные вручную, когда его нет или когда вы проводите тестирование.



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

Как только ваш туннель станет активным (у него есть активный сертификат CA и ваш стек туннеля подключён), вышестоящие серверы MCP становятся доступными из Claude Managed Agents и Messages API.

В обоих случаях туннель передаёт зашифрованный трафик на ваш сервер MCP, но не выполняет аутентификацию на нём. Если вышестоящий сервер MCP требует собственной аутентификации (OAuth, bearer-токен), предоставьте её так же, как и для любого другого сервера MCP; она не зависит от туннеля.



Managed Agents (Console)

1. В разделе Managed Agents > Sessions создайте сессию и выберите Create new agent, чтобы иметь возможность редактировать список серверов MCP.
2. Нажмите + MCP Server и откройте выпадающий список. Туннели в рабочем пространстве сессии, у которых есть хотя бы один активный сертификат, отображаются в верхней части списка, над каталогом публичных коннекторов.
3. Выберите туннель и укажите Subdomain, который ваш прокси маршрутизирует к конкретному серверу MCP, и Path, который ожидает вышестоящий сервер MCP. Строка Resolves to показывает точный URL.



Messages API

Передайте URL вышестоящего сервера MCP в массиве mcp_servers так же, как и для любого другого удалённого сервера MCP. Тело запроса и заголовок anthropic-beta соответствуют стандартному формату коннектора MCP; только url специфичен для туннеля. В следующем примере используется бета-заголовок mcp-client коннектора MCP, который отличается от беты mcp-tunnels, используемой Tunnels API. Используйте ключ API для рабочего пространства, в котором был создан туннель (Console Settings > API keys).

Хост URL — это <subdomain>.<your-tunnel-domain>. Путь зависит от вашего вышестоящего сервера MCP, а не от туннеля: транспорт streamable-http в FastMCP обслуживается по пути /mcp, а другие серверы могут использовать / или пользовательский путь (проверьте документацию сервера). Прокси пересылает путь без изменений.

client = anthropic.Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Use the hello tool to greet tunnel."}],
    mcp_servers=[
        {
            "type": "url",
            "url": "https://echo.YOUR_TUNNEL_DOMAIN_HERE/mcp",
            "name": "echo",
        }
    ],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "echo"}],
    betas=["mcp-client-2025-11-20"],
)

print(response)

Информацию об аутентификации на вышестоящем сервере MCP (authorization_token) и других параметрах mcp_servers см. в разделе Коннектор MCP.



Дальнейшие шаги