MCP 连接
从 Midmap 复制安装命令或配置，在你使用的智能体应用中连接画板。
MCP 连接是什么
MCP（Model Context Protocol，模型上下文协议）是一种开放协议，用于连接 AI 应用与外部工具和数据源。更多信息请见 MCP 官网。
Midmap 内置 MCP 服务，支持连接智能体或具备 MCP 接入能力的 AI 应用。连接后，应用中的智能体可以按你的要求读取或修改画板。
你可以在设置的 MCP 页面启用或停用服务，也可以修改服务端口。
在 Midmap 中添加应用
Midmap 的 MCP 服务默认开启，你可以在 设置 → MCP 中查看服务状态。
如果服务已关闭，可打开开关，并确认状态为“运行中”。
在“智能体”区域点击添加按钮，选择你正在使用的应用。目前已确认支持的智能体应用有：
- Claude Code
- Codex
- GitHub Copilot
- OpenCode
- Pi
- Qoder
- CodeBuddy
- WorkBuddy
- TraeCode
- TraeWork
如需接入其它支持 MCP 的应用，可以选择“其它”并填写应用名称。
将 Midmap 配置添加到应用
在 Midmap 中添加应用后，按应用类型完成配置：
- CLI 应用：点击“复制安装命令”，并在终端中运行。
- 桌面应用：点击“复制 MCP 配置”，然后粘贴到该应用的 MCP 设置中。
配置示例如下，端口和令牌请使用 Midmap 复制的实际值：
{
"mcpServers": {
"midmap": {
"type": "http",
"url": "http://localhost:<PORT>/mcp?token=<TOKEN>"
}
}
}添加配置时，请确认当前应用与 Midmap 中添加的智能体名称对应。如果应用需要重新加载 MCP 配置或重启，请按应用提示操作。
Midmap MCP 可以做什么
- 查看当前画板信息：读取当前画板、选中节点和当前画板的未读留言。智能体读取留言后，留言会标记为已读。
- 查找和管理画板：查看画板列表以查找目标画板，也可以创建或删除画板。
- 操作节点：读取节点层级和内容，添加、编辑、移动、排序或删除节点；也可以修改节点的标题、描述、待办、标记、图片和链接。
智能体通过 MCP 修改画板后，Midmap 会实时更新当前画板界面。
节点修改会形成操作记录，变更节点会显示标记，Midmap 也会显示操作通知。你可以在通知中查看本次修改，并选择保留或撤回。
管理连接
每个应用都有独立的配置。删除应用后，它将无法继续连接 Midmap；如需恢复连接，重新添加该应用，并用新配置替换应用中的旧配置。
如果你更改了 MCP 端口，或状态提示端口被占用并需要更换端口，请为每个应用重新复制配置，并更新应用中的旧配置。