配置它
1
打开 MCP 页
控制台 → MCP。它是一个高级功能,所以入口可能不在那里。
2
复制你客户端对应的片段
Cursor、Claude、VS Code 等各自要放在稍微不同的位置。那个页面会给出每种客户端的正确形状。
3
授权
客户端连接时会打开浏览器走 OAuth 2.1 加 PKCE。没有令牌需要你粘。
4
挑哪些工具开着
读类工具默认开。写类工具默认关,要你自己打开。
助手能读什么
list_methods 是最值得知道的那个:带上方法名时它返回完整的超参声明,含类型和取值范围,所以一个
提建议的助手可以在建议之前先确认那个改动合法。
你允许之后它能写什么
create_submit_plan 是同一意图更安全的形状:助手提议,人来批准。
确认成功
让你的客户端列出它的工具。你应该看到上面那些读类工具,除此以外没有别的 —— 除非你开了某个写类 工具。 然后问一件具体的事:对一次完成的运行调get_metrics_summary,会返回每个指标的最新值、最小值、
最大值,以及各自发生在哪一步。如果客户端报 not authenticated: complete the Connect / login authorization in your MCP client,说明那次 OAuth 往返没走完。
端点与协议
- 传输是 Streamable HTTP MCP,协议版本
2026-07-28。 - 同一个端点同时服务新客户端(用
server/discover发现,无握手)和在2025-11-25及更早版本上 发initialize的老客户端。 - 授权是 OAuth 2.1 加 PKCE。优先 Client ID Metadata Documents,Dynamic Client Registration 作为
兜底保留。授权码重定向带 RFC 9207 的
iss,只在本地TUNEPLANE_NO_AUTH=1调试时跳过。