Docker Streamable HTTP atrás de proxy reverso¶
Use este padrão quando um reverse proxy termina TLS e aplica controles de acesso.
Iniciar o servidor¶
export MCP_AUTH_TOKEN="replace-with-a-secret-token"
docker run --rm -p 127.0.0.1:3000:3000 \
-e CLOAK_PLAYWRIGHT_MCP_HTTP_AUTH_TOKEN="$MCP_AUTH_TOKEN" \
-v "$PWD/artifacts:/data" \
swimmwatch/cloakbrowser-mcp:latest \
--transport streamable-http --http-host 0.0.0.0 --http-port 3000
O contêiner escuta 0.0.0.0 internamente, mas o Docker publica a porta apenas no loopback do host.
Proxy do endpoint¶
Configure seu proxy reverso para encaminhar tráfego HTTPS autenticado para:
Encaminhe os cabeçalhos Authorization e mcp-session-id sem alterações. Restrinja /healthz e /readyz a verificações de saúde confiáveis ou exija o mesmo token Bearer.
Verificar¶
curl -H "Authorization: Bearer $MCP_AUTH_TOKEN" http://127.0.0.1:3000/healthz
curl -H "Authorization: Bearer $MCP_AUTH_TOKEN" http://127.0.0.1:3000/readyz
Em seguida, configure o cliente MCP com a URL HTTPS pública, por exemplo: