文档
快速开始

通过 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/mcp

Codex

在终端中添加 server 并开始 OAuth 登录流程:

codex mcp add mindmux --url https://mcp.mindmux.ai/mcp
codex mcp login mindmux

浏览器会打开 MindMux 授权页面。登录后选择“Authorize”,再回到 Codex。使用以下命令确认 server 已可用:

codex mcp list

Claude 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,直到你再次授权。