文档
快速开始

通过 MCP 连接 Cloud Brain

通过 MindMux Cloud Brain MCP server,让兼容 MCP 的客户端读取和更新你的 MindMux 账户可访问的 Cloud Brain。

服务使用 OAuth。配置时会在浏览器中登录 MindMux 账户;不需要创建、复制或粘贴 API Key。

开始前

  • 你需要拥有有效 Plus 或 Team Workspace 的访问权限。
  • 授权账户只能读取或更新其在该 Workspace 中有权限访问的 Cloud Brain。
  • MindMux 会请求读取和写入权限。客户端会先展示授权页面,再取得访问权限。

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