MCP Playground：在文档中实时运行你的智能体工具
上周，我们把 MCP 工具变成了一等公民的 API Contract：把 Archyl 指向一个运行中的 MCP 服务器，它会发现每个工具及其输入 schema，并像任何 REST 或 GraphQL 契约一样，与你的 C4 模型关联并记录在案。
这回答了第一个问题：我的智能体能做什么？
今天我们回答第二个问题：它真的能做到吗？
这就是 MCP Playground——每个 live MCP 契约上的全新标签页，让你针对真实服务器调用任何工具并查看真实结果。无需配置客户端，无需手写 JSON-RPC，也无需离开你的架构文档。
从 schema 到表单，全自动
打开一个 live MCP 契约，你会在 schema 旁边看到 Playground 标签页。从列表中选择一个工具——就是你已经记录在案的那个可搜索列表——Archyl 会把它的 inputSchema 转换成表单：
- 字符串、数字和布尔值变成带类型的输入框。
- 枚举变成包含允许值的下拉框。
- 必填参数会被标记，并在发送前完成校验。
- 嵌套对象和数组使用原始 JSON 输入框，提交时校验。
填写完毕，点击运行工具，结果连同耗时一起返回——并以结果应有的方式呈现。格式化视图将响应显示为整洁缩进的 JSON。树视图让大型 payload 可以自由导航：折叠你不关心的部分，展开你关心的部分。工具返回的文本、图片和资源都会原生渲染。
如果工具返回错误，你看到的正是智能体会看到的——错误标志和 payload，以红色醒目呈现，绝不被吞掉。
你的令牌永远不会离开浏览器
Playground 遵循与实时发现相同的安全模型，这一点值得反复强调，因为它正是关键所在：
每次调用都从你的浏览器发起。 当你点击运行工具时，你的浏览器直接与你的 MCP 服务器通信。Archyl 的后端不在链路中。
- 令牌永远不会被存储。 你在会话中输入它；它只存在于页面中，别无他处。
- 结果永远不会被持久化。 返回的内容被渲染、被阅读，关闭标签页后即消失。
- 服务端无法触达你的网络。 由于请求从你的机器发出，Playground 可以访问
localhost和私有服务器——而且不存在任何可被滥用的服务端请求路径。
与发现功能一样，唯一的权衡是 CORS：目标服务器必须允许 Archyl 的来源。对于你控制的服务器，这只是一行配置。
为什么这很重要
MCP 工具是你的 AI 智能体真正使用的接口。在此之前，验证一个工具意味着搭建客户端、手工构造 JSON-RPC 信封，或者干脆……相信描述。
现在，文档就是测试台：
- 在审查智能体的能力面？ 运行这些工具，看到真实的返回结构，而不是描述中的结构。
- 在调试智能体调用为何失败？ 用完全相同的参数，两次点击即可复现。
- 在为新成员介绍某个服务？ 把契约发给他——每个工具既能阅读，也能试用。
这就是我们所说的活文档。可以被执行的规范不会悄悄漂移；它一说谎就会被当场抓住。
一如既往，自己先用
Archyl 本身就是一个 MCP 服务器——本周已有 181 个工具。Playground 的第一个用户就是我们自己的契约：我们每天都在自己的文档里，对自己的端点运行 list_projects、get_project_c4_model 等工具。上面的截图正是如此。
试试看
打开项目 → API Contracts → 任意带有 live 端点的 MCP 契约 → Playground。输入令牌，选择工具，运行。
你的架构文档刚刚学会了执行自己。