WorkBuddy、Codex、Claude、千问、豆包怎么接入审小匠 MCP？

Q: 各个 AI 助手怎么接入？

服务地址统一是 https://api.opencpai.com/mcp，传输方式为 Streamable HTTP，登录方式为 OAuth 浏览器授权。不需要、也不支持填写 API Key。

结论先说：只要你用的 AI 助手支持"远程 MCP 服务 + 浏览器登录授权"，就能用同一个地址 https://api.opencpai.com/mcp 接入审小匠的审计数据处理服务，在对话里完成余额表清洗、序时账整理、现金流量表编制和审计底稿生成，不用切换到网页。WorkBuddy 和 Codex 已实测可用，配置只需两三步。

什么是 MCP 连接器？

MCP（Model Context Protocol，模型上下文协议）是指让 AI 助手调用外部工具的一套开放标准。AI 助手是"客户端"，审小匠的审计数据处理服务是"服务端"：你在对话里说"把这份余额表清洗一下"，AI 助手按协议调用服务端的工具，拿回结果再用自然语言告诉你。

接入后，AI 助手能调用的工具分三类：

类别	工具	说明
账号	查看套餐与剩余额度	只读
快速工具	清洗科目余额表、清洗序时账、明细账转余额表、明细账转序时账、清洗/汇总财务报表、编制现金流量表	不走审计流水线
审计流水线	上传资料、启动财审/预审/税审、查询进度、获取产物、修正识别结果后重跑	启动前会先请你确认消耗额度

各个 AI 助手怎么接入？

服务地址统一是 https://api.opencpai.com/mcp，传输方式为 Streamable HTTP，登录方式为 OAuth 浏览器授权。不需要、也不支持填写 API Key。

客户端	接入方式	状态
WorkBuddy	连接器 → 自定义连接器，粘贴下方 JSON	已验证
Codex（命令行 / IDE 插件）	两行命令	已验证
Claude Code	一行命令 + `/mcp` 登录	支持
claude.ai 网页版、千问、豆包等网页端助手	—	暂未开放，原因见下文

WorkBuddy 怎么添加？

在 WorkBuddy 左侧进入【专家·技能·连接器】→【连接器】，选择自定义连接器，粘贴：

{
  "mcpServers": {
    "opencpai-audit": {
      "type": "streamableHttp",
      "url": "https://api.opencpai.com/mcp",
      "timeout": 30000
    }
  }
}

保存后点"连接"，浏览器会打开授权页，登录账号后点"允许"即可。

Codex 怎么添加？

codex mcp add opencpai --url https://api.opencpai.com/mcp
codex mcp login opencpai

第二条命令会打开浏览器完成授权。授权回调走本机地址，所以浏览器要和 Codex 在同一台电脑上；如果命令提示不支持远程服务或登录，先把 Codex 升级到新版本。

Claude 怎么添加？

Claude Code 在终端执行：

claude mcp add --transport http opencpai https://api.opencpai.com/mcp

然后在 Claude Code 里输入 /mcp，选择 opencpai 完成登录。

千问、豆包、claude.ai 网页版能不能接入？

目前还不能。能接入的客户端要同时满足三个条件：

支持添加"远程 MCP 服务"（Streamable HTTP）；
支持 OAuth 浏览器授权登录（不需要填 API Key）；
授权完成后跳回的地址在审小匠的允许名单里。

第 3 条是关键：Codex、Claude Code、WorkBuddy 都运行在你自己的电脑上，授权后跳回本机地址，审小匠默认允许；网页端助手运行在各家厂商的服务器上，跳回的是厂商的网址，需要审小匠逐家核实后登记。登记前，这类助手在授权一步会被拒绝。只支持填写固定 API Key 或请求头的客户端，目前也无法接入。

接入前要知道的四件事

额度与套餐和网页端一致。MCP 只是审小匠的另一种使用入口，套餐、额度、并发限制都沿用你的账号；启动审计流水线前，AI 助手会把要消耗的额度告诉你，你确认后才会执行。
资料直传服务器。文件从你的电脑直接上传到存储，不经过 AI 厂商；但你的指令和工具返回的摘要文字，会经过你所用的 AI 助手处理。
授权最长 60 天，改密码立即失效。从第一次授权算起最长有效 60 天，期间 AI 助手会自动刷新，不用你操作；满 60 天后需要在浏览器里重新登录一次。在审小匠网页修改或重置密码、或被管理员强制下线时，所有 AI 助手上的授权会同时失效——怀疑电脑或账号泄露时，改密码就能一次切断。不想继续使用时，在 AI 客户端里断开或移除这个连接器即可。
产物是供审计师复核的工作底稿。工具负责数据整理与文书生成，职业判断、结论与签字仍由注册会计师完成。

常见问题

连接时为什么要打开浏览器登录？

这是 OAuth 授权：你在官网页面上登录并同意授权，AI 助手拿到的是一个限定权限、有期限的令牌，而不是你的账号密码。令牌只能调用上面列出的工具，改不了密码、也看不到网页端的其他设置。

下载链接打不开怎么办？

产物下载链接 10 分钟内有效，过期后让 AI 助手重新获取一次即可；服务器上的产物保留 24 小时。

为什么提示"已有作业在处理中"？

清洗、转换这类快速工具每个账号同时最多处理 3 个作业。让 AI 助手先查询已有作业的进度，完成后再提交新的即可。

没有账号能用吗？

授权页上可以直接注册审小匠账号，注册后回到 AI 助手继续操作。

下一步

想先在网页上试一遍流程，可以进入工作台上传一份科目余额表；准则原文可以在知识库检索，套餐与额度说明见价格页。