Skip to content

AgentDock Bridge · 网关端点与 MCP 工具参考

5 项端点/工具

覆盖 Cloudflare Worker OAuth 2.1 + PKCE 网关端点、WSS 设备中继、Approve.cmd 精确批准沙箱约束,以及 10 个核心 MCP 工作区工具。

GEThealthz 公开 · bridge Bearer BRIDGE_TOKEN网关基石

服务体检与连接器长连接桥

GET /healthz · WSS /bridge

/healthz 检查网关与连接器实时在线状态(心跳超 65 秒判离线);/bridge 供 Windows 受保护连接器以至少 32 字符密钥建立单条反向长连接。

查看网关HTTP与心跳契约 ↗

✅ 能做到

  • 本地连接器主动拨号 WSS /bridge,无需在家庭或办公路由器开放任何入站端口
  • 单条活动 WSS 连接与 10s 首心跳宽限(FIRST_HEARTBEAT_GRACE);空闲/孤立旧连接按 65s 超时回收

⛔ 明确限制 / 拒绝条件

  • 连接器掉线时 /healthz 返回 503;若已存在活跃或宽限期长连接,新 /bridge 建连直接返回 409
  • 当前生产连接器凭据 loadSecrets 与 ACL 检查严格依赖 Windows x64(DPAPI + NTFS DACL)

参数、作用域与校验规则

Authorization (WSS /bridge)headerBearer <BRIDGE_TOKEN>必填

最小长度 32 字符的服务连接器长连接口令,禁止与浏览器 OAuth Token 混用。

响应状态与错误码

200 OK (/healthz)网关与连接器在线
503 Offline / 409 Conflict无在线连接器返回 503;重复设备抢占长连接返回 409