跳转到内容
mofcloud

MCP 与 OAuth

最近更新:

MOF 自带 MCP 服务。开启后,Claude Desktop、Cursor、Dify 等 AI 客户端可以查询用户有权限看到的费用数据,只能读,不能改。

开启 MCP

管理员

  1. 打开 Admin → 设置 → MCP 接入。
  2. 打开「允许 MCP 连接」。
  3. 点「检测连接」,「MCP 服务」应显示「连接正常」。

部署模板已经包含 MCP 容器,不用另外安装。检测失败时,确认 mof-mcp 容器在运行,并且版本与 MOF 配套。

配置 OAuth

管理员 · Claude Desktop 需要

配了 OAuth,用户在 AI 客户端填一个地址、用 MOF 账号登录就能连上。不配的话只能手动创建令牌,而 Claude Desktop 不支持令牌。

  1. 让 MOF 通过公网 HTTPS 访问。Claude 从它自己的服务器连接 MOF,所以地址必须能从公网访问。
  2. 给 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"
  1. 回到 Admin → 设置 → MCP 接入,再点一次「检测连接」,「OAuth 登录」应显示「已配置」。

MOF_PUBLIC_URL 填用户访问的地址,不带路径。密钥至少 32 个字符,多台 MOF 必须一致。「已配置」只说明两个变量都填对了,公网回调要等第一次从 Claude 登录成功才算确认。 环境变量

连接 Claude Desktop

每个用户

  1. 在 MOF 里打开 设置 → MCP 连接,复制「服务器地址」。
  2. 在 Claude Desktop 打开 Settings → Connectors → Add custom connector,名称填 MOF,粘贴地址。
  3. 点 Connect,在浏览器里用 MOF 账号登录并授权。
  4. 向 Claude 提问,例如「上个月各个云花了多少钱?」
不支持 OAuth 的客户端:用令牌

在 设置 → MCP 连接 → 手动令牌 里填名称,点「创建令牌」。令牌只显示一次,请立即复制,有效期 90 天。客户端用请求头携带:

Header
Authorization: Bearer YOUR_TOKEN

撤销连接

用户在 设置 → MCP 连接 的「已授权的应用」和「我的令牌」里撤销自己的连接。管理员在 Admin 里关闭「允许 MCP 连接」,所有连接立即失效。