Skip to content

AgentDock Bridge · Gateway & MCP Reference

5 endpoints/tools

Interactive specification covering Cloudflare Workers OAuth 2.1 + PKCE routes, WSS connector relay, exact Approve.cmd confirmation, and all 10 hardened MCP workspace tools.

GEThealthz public · bridge Bearer BRIDGE_TOKENCore Relay

Health Probe & Reverse Connector Relay

GET /healthz · WSS /bridge

/healthz reports connector liveness against a 65s heartbeat limit; /bridge accepts a single active reverse WebSocket from the hardened local Windows connector.

View HTTP & liveness specs ↗

✅ Capabilities

  • Outbound WSS requires zero open inbound firewall or router ports
  • Enforces 10s FIRST_HEARTBEAT_GRACE and 65s HEARTBEAT_MAX_AGE per session

⛔ Explicit Limits / Rejections

  • Returns 503 when connector is offline and 409 if a live/grace WSS socket already exists
  • Production secret decryption (DPAPI) and NTFS ACL guards require Windows x64 (`win32`)

Parameters, Scopes & Bounds

Authorization (WSS /bridge)headerBearer <BRIDGE_TOKEN>Required

Connector token (>=32 chars), strictly isolated from browser OAuth access tokens.

Status & Error Contracts

200 OKGateway and connector healthy
503 Offline / 409 ConflictConnector offline or duplicate socket claim