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