Развёртывание туннелей MCP с помощью Docker Compose

Этот путь требует, чтобы у хоста был поставщик удостоверений OIDC (например, сервер метаданных облачной виртуальной машины или SPIFFE). Если его нет, используйте вместо этого вкладку Без программного доступа.

Компонент настройки использует Workload Identity Federation, чтобы получить токен туннеля, сгенерировать CA и серверный сертификат и зарегистрировать CA в Anthropic.

1. 1

   Подготовьте каталог развёртывания

   mkdir -p mcp-tunnel/{config,data}
   cd mcp-tunnel
   sudo chown 65532:65532 data

   

   Контейнеры запускаются от имени непривилегированного UID 65532 и нуждаются в доступе на запись к data/.

2. 2

   Напишите docker-compose.yaml

   Файл compose закрепляет образы по дайджесту SHA-256, запускает каждый контейнер от имени непривилегированного пользователя с файловой системой только для чтения, отбрасывает все возможности (capabilities) Linux и отключает повышение привилегий.

   cat > docker-compose.yaml <<'EOF'
   services:
     setup:
       image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
       entrypoint: ["/setup"]
       command:
         - init
         - --api-url=https://api.anthropic.com
         - --output=dir:/data
         - --token-version=1
       environment:
         - TUNNEL_ID
         - ANTHROPIC_FEDERATION_RULE_ID
         - ANTHROPIC_ORGANIZATION_ID
         - ANTHROPIC_WORKSPACE_ID
         - ANTHROPIC_IDENTITY_TOKEN
       volumes:
         - ./data:/data
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       profiles: ["setup"]
   
     cloudflared:
       image: cloudflare/cloudflared@sha256:6b599ca3e974349ead3286d178da61d291961182ec3fe9c505e1dd02c8ac31b0
       command: tunnel --no-autoupdate run --url http://localhost:8080
       environment:
         - TUNNEL_TOKEN
       # Используем netns прокси, чтобы localhost:8080 был доступен.
       network_mode: "service:mcp-proxy"
       restart: unless-stopped
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       stop_grace_period: 30s
       logging:
         options:
           max-size: "10m"
           max-file: "3"
   
     mcp-proxy:
       image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
       volumes:
         - ./config/mcp-proxy.yaml:/etc/mcp-gateway/config.yaml:ro
         - ./data:/data:ro
       restart: unless-stopped
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       stop_grace_period: 30s
       logging:
         options:
           max-size: "10m"
           max-file: "3"
   EOF

   

   Если вы используете пример сервера MCP, добавьте его как сервис:

   cat >> docker-compose.yaml <<'EOF'
   
     hello-mcp:
       image: python:3.13-slim
       working_dir: /app
       volumes:
         - ./hello_server.py:/app/hello_server.py:ro
       command: sh -c "pip install --quiet mcp && python hello_server.py"
       restart: unless-stopped
   EOF

   
3. 3

   Подготовьте туннель

   Задайте идентификаторы. Оставьте TUNNEL_ID незаданным, чтобы компонент настройки создал туннель; задайте его, чтобы подключиться к существующему туннелю из Console:

   # export TUNNEL_ID=tnl_...   # задайте, чтобы подключиться к существующему туннелю
   export ANTHROPIC_FEDERATION_RULE_ID=fdrl_...
   export ANTHROPIC_ORGANIZATION_ID=00000000-0000-0000-0000-000000000000

   

   Если ваше правило федерации ограничено рабочим пространством, отличным от рабочего пространства вашей организации по умолчанию, также задайте ANTHROPIC_WORKSPACE_ID=wrkspc_...; в противном случае компонент настройки использует рабочее пространство по умолчанию. Автоматически создаваемый туннель создаётся в этом рабочем пространстве.

   Задайте ANTHROPIC_IDENTITY_TOKEN равным OIDC JWT от поставщика удостоверений этого хоста. Следуйте руководству по WIF для вашего поставщика, чтобы зарегистрировать издателя, задать субъект правила и выпустить токен; аудитория правила должна совпадать с аудиторией, которую вы запрашиваете при выпуске.

   Запустите компонент настройки:

   docker compose run --rm setup

   

   setup init идемпотентен относительно data/: при повторном запуске он повторно использует уже сохранённые там идентификатор туннеля и CA и никогда не создаёт второй туннель. Новый CA генерируется и регистрируется только тогда, когда data/ пуст или TUNNEL_ID изменился; в этом случае действует ограничение в два активных сертификата, поэтому сначала отзовите один в Console, если оба слота заняты.

   См. раздел Сбои аутентификации компонента настройки, если возникает ошибка.

   Получите домен вашего туннеля и экспортируйте его для последующих шагов:

   export TUNNEL_DOMAIN=$(sudo cat data/tunnel-domain)
   echo "$TUNNEL_DOMAIN"

   
4. 4

   Напишите конфигурацию прокси

   tunnel_domain является обязательным: прокси использует его, чтобы удалить суффикс домена из входящих имён хостов перед поиском поддомена в routes. routes — это плоское отображение поддомена на URL вышестоящего сервера, а не список.

   cat > config/mcp-proxy.yaml <<EOF
   listen_addr: ":8080"
   log_level: info
   shutdown_timeout: 30s
   tunnel_domain: ${TUNNEL_DOMAIN}
   tls:
     cert_file: /data/tls.crt
     key_file: /data/tls.key
   routes:
     echo: http://hello-mcp:9000
   EOF

   

   Маршрут echo: указывает на пример сервера MCP; замените его своими маршрутами (или добавьте их). См. справочник по конфигурации прокси со всеми доступными полями.

5. 5

   Запустите развёртывание

   export TUNNEL_TOKEN=$(sudo cat data/tunnel-token)
   docker compose up -d

   