对外接口

这一组文档面向 MDP client，按“建立链接”“消息事件”“外部接口”三类拆开。

按任务阅读

目标	入口
建立一个双向会话	WebSocket 建立链接
用请求响应方式代替 socket	HTTP Loop 建立链接
浏览器在开 websocket 前先鉴权	鉴权引导
判断某个端口是不是 MDP 服务	GET /mdp/meta
更新一个已连接 client 的路径目录	updateClientCatalog
查看 websocket 有哪些消息事件	registerClient、callClient、ping
查看精确的 HTTP 接口契约	POST /mdp/http-loop/connect、POST /mdp/auth、GET /mdp/meta

建立链接

方式	入口	说明
WebSocket 建立链接	ws://127.0.0.1:47372	双向 JSON MDP 消息
HTTP Loop 建立链接	/mdp/http-loop/connect	基于 session 的 long-poll transport
鉴权引导	/mdp/auth	主要给浏览器 websocket client 做 cookie 引导
元数据探针	/mdp/meta	识别一个 MDP server 并读取发现提示

消息事件

事件	方向	作用
registerClient	Client -> Server	注册一个 client descriptor 与路径
updateClientCatalog	Client -> Server	替换一个已注册的路径目录
unregisterClient	Client -> Server	删除一个已注册 client 会话
callClient	Server -> Client	调用一个 method + path 目标
callClientResult	Client -> Server	回传调用结果
ping	双向	心跳保活
pong	双向	心跳确认

外部接口

接口	方法	作用
POST /mdp/http-loop/connect	POST	创建一个 HTTP loop session
POST /mdp/http-loop/send	POST	发送一条 client-to-server 消息
GET /mdp/http-loop/poll	GET	拉取一条 server-to-client 消息
POST /mdp/http-loop/disconnect	POST	关闭一个 HTTP loop session
POST /mdp/auth	POST	签发一个 auth cookie
DELETE /mdp/auth	DELETE	清除一个 auth cookie
GET /mdp/meta	GET	探测一个 server 的 MDP 元数据
GET /skills/:clientId/*skillPath	GET	通过直接路由读取一个 skill
GET /:clientId/skills/*skillPath	GET	通过嵌套路由读取一个 skill

共享 JSON 类型

AuthContext：

{
  "scheme": "Bearer",
  "token": "client-session-token",
  "headers": {
    "x-mdp-auth-tenant": "demo"
  },
  "metadata": {
    "role": "operator"
  }
}

SerializedError：

{
  "code": "handler_error",
  "message": "Something failed",
  "details": {
    "reason": "optional"
  }
}

MDP 的 client 目录是 path-based。client.paths 里的 descriptor 只会是下面三种之一：

• 带显式 method 和 path 的 endpoint
• 位于 *.prompt.md 路径、通过 GET 调用的 prompt
• 位于 *.skill.md 路径、通过 GET 调用的 skill

与 bridge 工具的关系

这组接口是给 MDP client 用的，MCP host 不直接调用它们。MCP host 面向的是 工具集。