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 连接」,所有连接立即失效。