MOF 內建 MCP 服務。開啟後,Claude Desktop、Cursor、Dify 等 AI 用戶端可以查詢使用者有權限看到的費用資料,只能讀,不能改。
開啟 MCP
管理員
- 開啟 Admin → 設定 → MCP 存取。
- 開啟「允許 MCP 連線」。
- 點選「檢查連線」,「MCP 服務」應顯示「連線正常」。
部署範本已經包含 MCP 容器,不用另外安裝。檢查失敗時,請確認 mof-mcp 容器正在執行,且版本與 MOF 相符。
設定 OAuth
管理員 · Claude Desktop 需要
設定 OAuth 後,使用者在 AI 用戶端填一個位址、用 MOF 帳號登入就能連上。若不設定,只能手動建立權杖,而 Claude Desktop 不支援權杖。
- 讓 MOF 透過公網 HTTPS 存取。Claude 會從它自己的伺服器連線到 MOF,所以位址必須能從網際網路存取。
- 為 mof 服務加上兩個環境變數,然後重建:
compose.yaml · mof.environment
MOF_PUBLIC_URL: "https://mof.example.com"
MOF_MCP_OAUTH_SECRET: "REPLACE_WITH_A_RANDOM_SECRET_AT_LEAST_32_CHARACTERS"- 回到 Admin → 設定 → MCP 存取,再點選一次「檢查連線」,「OAuth 登入」應顯示「已設定」。
MOF_PUBLIC_URL 填使用者存取的位址,不帶路徑。密鑰至少 32 個字元,多台 MOF 必須一致。「已設定」只代表兩個變數都已填寫,公網回呼要等第一次從 Claude 登入成功才算確認。 環境變數
連接 Claude Desktop
每位使用者
- 在 MOF 開啟 設定 → MCP 連線,複製「伺服器位址」。
- 在 Claude Desktop 開啟 Settings → Connectors → Add custom connector,名稱填 MOF,貼上位址。
- 點選 Connect,在瀏覽器中用 MOF 帳號登入並授權。
- 向 Claude 提問,例如「上個月各個雲端花了多少錢?」
不支援 OAuth 的用戶端:使用權杖
在 設定 → MCP 連線 → 手動權杖 填寫名稱,點選「建立權杖」。權杖只顯示一次,請立即複製,有效期 90 天。用戶端以請求標頭攜帶:
Header
Authorization: Bearer YOUR_TOKEN撤銷連線
使用者在 設定 → MCP 連線 的「已授權的應用程式」和「我的權杖」中撤銷自己的連線。管理員在 Admin 關閉「允許 MCP 連線」後,所有連線立即失效。