文件
快速開始

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