通过 MCP 连接 Cloud Brain
通过 MindMux Cloud Brain MCP server,让兼容 MCP 的客户端读取和更新你的 MindMux 账户可访问的 Cloud Brain。
服务使用 OAuth。配置时会在浏览器中登录 MindMux 账户;不需要创建、复制或粘贴 API Key。
开始前
- 你需要拥有有效 Plus 或 Team Workspace 的访问权限。
- 授权账户只能读取或更新其在该 Workspace 中有权限访问的 Cloud Brain。
- MindMux 会请求读取和写入权限。客户端会先展示授权页面,再取得访问权限。
推荐:让 Agent 帮你配置
在 Codex 或 Claude Code 中打开项目,复制并发送这段话:
请帮我安装最新版 `@mindmux/cli`,并用 `mmx setup -agent` 为当前 Agent 和项目完成配置,需要授权或选择时询问我,最后验证连接是否正常。CLI 会引导浏览器授权和 Workspace / Project 选择,并配置当前项目的 MCP 连接与记忆 hooks。完成后重启所选 Agent,按提示确认信任。浏览器授权和必要的选择仍需要你参与。
也可以自己安装:在装有 Node.js 22 或更高版本的 macOS / Linux 上,运行 npm install -g @mindmux/cli@latest 或 pnpm add -g @mindmux/cli@latest,然后在项目目录运行 mmx setup。使用 mmx doctor --online 检查连接。
升级 CLI
已经安装过?在已接入的项目目录运行:
mmx update命令会使用原来的 npm 或 pnpm 安装方式升级,并刷新 Hook、MCP 启动路径和项目指令。新版还会刷新本次 CLI 安装记录的其他已接入项目;未记录的项目需进入对应目录执行刷新。登录、Brain 绑定和内容都会保留,无需执行 clean 或重新 setup。
让 Agent 升级时,先执行 mmx update --check --json,再执行 mmx update --yes --json。可通过 mmx update --help 查看说明;报告成功前应检查警告和各项目的刷新结果。
旧版没有 update 命令,或需要手动升级时,沿用原来的安装方式:
npm install -g @mindmux/cli@latest使用 pnpm 则执行 pnpm add -g @mindmux/cli@latest。升级后刷新配置:
mmx update --refresh-integrations使用 mise 或源码安装的用户应沿用原来的升级方式,再执行同一刷新命令。完成后重启受影响的 Agent,并确认变更后的 Hook 信任提示。在项目内执行 mmx --version 和 mmx doctor --online 检查。如果当前安装的版本尚不支持自动刷新其他项目,请分别进入各已接入项目执行刷新。出现刷新失败时需继续修复;安装包升级成功不等于 Hook 已正常运行。
以下是其他客户端直接接入 MCP 的方式。直接接入可使用 MCP 工具,但不会安装 CLI 的项目记忆 hooks。
Server 地址
在客户端中使用以下 Remote Streamable HTTP MCP server 地址:
https://mcp.mindmux.ai/mcpCodex
在终端中添加 server 并开始 OAuth 登录流程:
codex mcp add mindmux --url https://mcp.mindmux.ai/mcp
codex mcp login mindmux浏览器会打开 MindMux 授权页面。登录后选择“Authorize”,再回到 Codex。使用以下命令确认 server 已可用:
codex mcp listClaude Code
在使用 Claude Code 的项目中添加远程 HTTP server:
claude mcp add --transport http mindmux https://mcp.mindmux.ai/mcp启动 Claude Code,运行 /mcp,选择 mindmux,然后在浏览器中完成登录和授权流程。使用 claude mcp list 确认 server 已添加。
Cursor
打开 Settings → Tools & MCP,添加一个远程 Streamable HTTP server,并使用上面的 server 地址。连接时,Cursor 会打开 MindMux OAuth 流程。
如果通过 mcp.json 配置 Cursor,请使用:
{
"mcpServers": {
"mindmux": {
"type": "http",
"url": "https://mcp.mindmux.ai/mcp"
}
}
}VS Code
使用 VS Code 的 MCP server 配置,在要使用的项目中将以下内容添加到 .vscode/mcp.json:
{
"servers": {
"mindmux": {
"type": "http",
"url": "https://mcp.mindmux.ai/mcp"
}
}
}在 Copilot Chat 中打开 Agent mode,在工具选择器中启用 mindmux,并在提示时完成 OAuth 流程。
其他 MCP 客户端
如果客户端支持带 OAuth 的远程 HTTP 或 Streamable HTTP MCP server,添加上面的 server 地址并完成其登录提示即可。如果客户端提供 Agent 辅助配置流程,可以向它发送以下指令:
Add the MindMux Cloud Brain MCP as an HTTP server named mindmux at https://mcp.mindmux.ai/mcp, then log in.使用 Cloud Brain
授权完成后,让客户端列出你可访问的 Workspace 或 Cloud Brain。需要使用 Brain 时,MindMux 会让你明确选择;它不会根据文件夹或仓库名称推断 Brain。
使用 MCP 客户端的“清除认证”或“移除连接”操作撤销连接;具体操作因客户端而异。撤销后,该客户端无法读取或修改你的 Cloud Brain,直到你再次授权。