Saltar a contenido

Docker Streamable HTTP detrás de proxy inverso

Este patrón sirve cuando un reverse proxy termina TLS y aplica controles de acceso.

Iniciar el 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

El contenedor escucha en 0.0.0.0 internamente, pero Docker publica el puerto solo en loopback del host.

Proxy del endpoint

Configura tu proxy inverso para reenviar el tráfico HTTPS autenticado a:

http://127.0.0.1:3000/mcp

Reenvía las cabeceras Authorization y mcp-session-id sin cambios. Permite el acceso a /healthz y /readyz solo a comprobaciones de estado de confianza o exige el mismo 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

Después, configure el cliente MCP con la URL HTTPS pública, por ejemplo:

https://mcp.example.com/mcp

Relacionado