MCP

MCP 页是 MaomiAgent 的“外部能力接入页”。
如果你想让 AI 不只是聊天，还能在对话里接工具、接浏览器、接文档处理、接系统能力，就会在这里配置和管理。

对个人用户来说，可以先这样理解 MCP：

• 它不是普通聊天内容。
• 它更像是“给 AI 增加可调用能力”。
• 配好以后，通常会在 05.chat.md 的 AI 对话页里配合使用。

先看懂这页：列表在下面，常用入口都在顶部

第一次来到这页时，你最常用到的就是顶部这一排：

• 搜索框：按名称、端点或传输方式快速找。
• 全部传输：按 stdio、http-streamable、sse 筛选。
• 批量按钮：批量启用、禁用、检查、删除。
• 刷新
• 打开 MCP 市场
• 查看推荐 MCP
• 新建 MCP

下方主表格则负责显示每一个 MCP 项目的状态和操作入口。

场景一：手动新建一个 MCP

如果你已经知道自己要接什么能力，最直接的方式就是手动新建。

操作步骤：

1. 点击顶部 新建 MCP。
2. 先填写基础字段：
   名称、作用域、传输协议、超时时间。
3. 如果你选择的是 工作区 作用域，再补 workspaceId。
4. 填写 端点。
5. 按需要补标签和描述。
6. 根据传输协议继续补充对应字段。
7. 先点 测试连接。
8. 检查通过后，再决定是否启用并保存。

新建弹窗里最重要的字段怎么填

名称

• 用来给自己识别这项能力。
• 建议简短、稳定、能看出用途。

作用域

• 要给很多对话共用，就选 全局。
• 只给某个工作区使用，就选 工作区。

传输协议

这项会直接影响下面要填什么内容：

• stdio
  更接近本地命令方式。
• http-streamable
  更接近网络服务方式。
• sse
  也是网络服务类接入方式。

端点

这是最关键的连接入口。
如果这里没填对，后面的检查和启用通常也不会顺利。

不同传输协议，下面会出现不同字段

当你选择 stdio 时，常见会继续填写：

• args
• env

当你选择 http-streamable 或 sse 时，常见会继续填写：

• headers
• query

你不需要死记这些字段背后的实现逻辑，只要知道：
不同协议需要的补充信息不一样，按弹窗里显示的字段填就行。

场景二：先检查，再启用

这是 MCP 页最值得养成的习惯。

操作步骤：

1. 新建或编辑完 MCP 后，先点 测试连接。
2. 测试通过后，看一下返回的状态和延迟。
3. 回到列表后，再点击操作列里的 检查。
4. 打开检查弹窗，确认这项能力当前是否健康。
5. 没问题后，再打开 启用 开关。

这样做的好处是，你不会把一条还没确认可用的连接，直接带进 AI 对话页里。

检查 弹窗是干什么的

操作列里的 检查 不是装饰，它相当于这条 MCP 的体检入口。

你通常会在里面看到：

• 当前名称
• 作用域
• 传输协议
• 端点
• 最近健康状态
• 检查记录
• 延迟
• 失败原因或提示信息

如果你发现某个 MCP 在 AI 对话里用不起来，先来这里看，通常比盲猜更有效。

场景三：从 MCP 市场安装

如果你不知道该怎么手动配，优先走市场会省时间很多。

操作步骤：

1. 点击 打开 MCP 市场。
2. 在搜索框里输入关键词。
3. 选择市场来源。
4. 点击 市场搜索。
5. 如果你更偏向“我要完成什么任务”，可以改用 需求匹配。
6. 在结果列表里看标题、描述、传输方式和端点。
7. 找到合适项后，点击 安装。
8. 安装后回到主列表，再决定是否启用。

市场弹窗里还有一个很实用的按钮：

• 自动安装最匹配

它适合你已经写清楚需求，但不想自己逐个挑选的时候使用。

市场搜索 和 需求匹配 的区别

• 市场搜索
  更适合你已经知道关键词，比如某个工具名、能力名。
• 需求匹配
  更适合你从用途出发，比如“我想让 AI 读取文档并整理摘要”。

如果你完全不确定该搜什么，可以先试 需求匹配。

使用建议

• 第一次使用时，优先从推荐项和市场安装开始，比手动配更稳。
• 新建或安装后，先检查再启用，不要跳过这一步。
• 全局 和 工作区 要分清：通用能力适合全局，项目专用能力适合工作区。
• 如果某项能力暂时不用，可以先禁用，不必马上删除。
• 真正要在 AI 对话里调用这些能力时，还要结合 05.chat.md 里的 启用 MCP 工具 一起使用。