EcholotMCP 服务器
连接到 MCP 服务器，查看它们提供的工具、资源和提示词，调用它们，并观察有什么变化。
“MCP 服务器”页面是你检查和调试 Model Context Protocol 服务器的地方：既包括你自己构建的，也包括你的 AI 客户端所使用的。Echolot 会连接、判断服务器使用哪个协议版本、 检查每一步是否正常、列出它提供的内容，并让你调用任何工具、资源或提示词，将这次调用存储为请求。
用边栏的模块切换器中的 MCP 服务器，或按 ⌘2 打开它。边栏列出工作区的服务器；页面显示你选中的那个。
用演示服务器试一试
演示 API 在 https://demo.echolot.dev/mcp 上运行着一个 MCP 服务器。Alpenglow 示例工作区已将它作为 Alpenglow MCP 包含在内。要将它添加到另一个工作区：
- 在边栏的服务器标题处点按 +，选取添加 MCP 服务器…
- 输入一个名称，例如
Alpenglow MCP，并将传输方式设为 HTTP（Streamable HTTP）。 - 输入 URL
https://demo.echolot.dev/mcp，然后点按添加。
Echolot 会立即检查该服务器。它提供三个工具（search_catalog、get_product、order_status）、一个资源和一个提示词。添加服务器介绍本地服务器、
从其他 App 导入服务器、标头和 OAuth。
服务器列表
每一行显示服务器的名称、它的连接方式，以及检查之后它有多少个工具：首次检查之前是 http · demo.echolot.dev，之后是 http · 3 tools，本地命令则是 stdio · npx。
绿点表示上次检查通过，红点表示失败。
在服务器上右键点按，可选取编辑…、检查连接和删除… 标题区中的 − 按钮会删除选中的服务器。Echolot 会先询问，服务器的文件会移到废纸篓。
每个服务器都是工作区的 mcp-servers 文件夹中的一个文件，所以它会随工作区一起通过 Git 传递。机密则不会：参见值和机密。
检查服务器
Echolot 在你打开服务器时检查它，在你点按检查时再检查一次。检查会连接、检测协议、ping 服务器，并列出它的工具、资源和提示词。Echolot 以前没有启动过的本地服务器是例外： 它们会等到你审查过它们的命令之后（参见运行前请审查）。
结果以卡片的形式从上到下显示：
| 卡片 | 显示什么 |
|---|---|
| 连接正常或连接问题 | 检查的每一步，通过或失败：服务器已启动（本地服务器）、服务器可访问、授权、协议、存活检测（即 ping）、工具、资源和提示词。失败的步骤会说明出了什么问题，并给出修复建议。 |
| 服务器 | 协议版本（协议（无状态） 或协议（会话））、 Ping 和连接耗时、工具数量、服务器的名称和版本、它的功能、服务器列出多个版本时它支持的版本，以及它给模型的指令。 |
| 工具、资源、提示词 | 服务器提供的内容，附带每一项的描述。点按其中一项即可调用它。 |
| 模型如何看待此服务器 | 工具列表每一轮占用模型多少开销，以及模型会在哪里出错。参见工具与质量。 |
| 用模型试试 | 模型会为你输入的提示词选择哪个工具。参见工具与质量。 |
| 实时 | 被监视的服务器宣布了什么。参见监视服务器。 |
| 消息 | 上一次检查的每条消息。参见消息日志。 |
服务器要求 OAuth 时，需要登录卡片会排在最前面。参见使用 OAuth 登录。
如果服务器把某个工具的定义写错了，会在工具步骤中计入，该步骤会失败，并指出该工具以及它的问题。
调用工具、资源和提示词
点按卡片中的工具、资源或提示词。会打开一个面板，显示它的名称和参数：
- 带有输入 Schema 的工具会得到一个表单，每个参数一个字段。必填字段的名称后面带有
*。将鼠标停在字段上会显示它的描述。将参数切换为 JSON，可以自己编写参数； JSON 会以 Schema 的每个字段开头。 - 提示词的每个参数都有一个字段。
- 资源不需要参数。
点按调用或按 ↩。答案会显示在参数下方，并附有耗时。报告错误的工具会以红色显示该错误。
存储为请求会将这次调用及其参数存储为工作区中的 MCP 请求，这样你可以再次运行它、添加检查，并在运行器中运行。参见 MCP 请求。关闭（esc）会不存储就离开。
参数中的值可以使用活动环境中的 {{variables}}。调用与每个请求经过同一个引擎，所以工作区的代理和证书设置都会生效，每次调用也会保存在历史记录中。
当服务器问你问题时
在你调用工具的过程中，服务器可以反过来请求某些内容。Echolot 会显示一个表单：
| 表单上写着 | 怎么做 |
|---|---|
| 服务器请求信息 | 填写服务器发来的表单并点按提交，或选取拒绝或取消。 |
| 服务器请求你打开一个页面 | 点按在浏览器中打开，在那里完成操作，然后点按完成。 |
| 服务器请求模型答复 | 表单会显示服务器希望模型回答的消息。你自己写出答复并点按发送答复，或点按拒绝。 |
只有提出请求的那个服务器会收到你的回答。
监视服务器
点按监视可以保持连接打开。按钮会变成正在监视，实时卡片会按最新在前的顺序显示服务器宣布的内容：它的工具、资源或提示词列表发生变化，以及资源的更新。列表变化时，Echolot 会重新读取它， 所以各卡片始终是最新的。点按正在监视即可停止。
消息日志
消息卡片列出上一次检查的每条 JSON-RPC 消息，并附有自检查开始以来的时间：发送给服务器的消息、收到的消息、连接的事件，以及对本地服务器而言，它写入错误输出的内容。 前 12 条会显示；显示全部会列出其余的。
将指针停在某条消息上，可以看到它完整的、格式化后的内容，以及它的方法、ID、它是结果、错误还是通知，还有它的大小。拷贝会将它拷贝下来。
检查失败时，这里是要看的地方：本地服务器的错误输出常常会说明它为什么停止，而 OAuth 的问题会显示每个发现步骤。
受保护的环境
受保护的环境处于活动状态时，检查、监视和每次调用都会先询问你，因为该服务器可能是生产服务器。该环境处于活动状态时， Echolot 不会自行检查服务器；需要时请点按检查。
协议版本
Echolot 支持两种 MCP：
- 无状态 MCP，修订版
2026-07-28，通过server/discover发现。服务器卡片会显示协议（无状态）。 - 基于握手的修订版
2025-11-25、2025-06-18、2025-03-26和2024-11-05，它们通过initialize开始会话。卡片会显示协议（会话）。
通过 HTTP 时，Echolot 使用 Streamable HTTP。服务器拒绝它时，Echolot 会自行尝试 2024-11-05 的较旧的 HTTP+SSE 传输。以 /sse 结尾的 URL 会先尝试 HTTP+SSE。
通过命令行
echolot mcp check 在终端或 CI 中运行相同的检查，echolot mcp sign-in 则登录要求 OAuth 的服务器。参见 echolot mcp。
要让 AI 客户端通过 Echolot 自己的 MCP 服务器使用你的工作区，参见智能体。教程检查和调试 MCP 服务器会一步步带你走完这个页面。