接入 AI 客户端（MCP）

除了站内 AI 助手，贝壳记账还可以接入支持 MCP 的 AI 客户端（如 Claude Desktop、Cherry Studio、Cursor 等），在你自己常用的 AI 工具里直接问账、记账。

本页说明如何创建访问密钥、如何配置客户端，以及 AI 客户端目前能做与不能做的事。

入口

密钥管理在 Web 端：

端	位置
Web 端	头像菜单 → 个人中心 → 安全中心 →「API 密钥」标签页
Android 端 / 桌面端	暂未提供密钥管理入口，配置请在 Web 端完成

创建访问密钥

1. 打开「API 密钥」标签页，点右上角「新建密钥」
2. 填写密钥名称，便于日后识别用途（例如「Claude Desktop」），最多 30 个字符
3. 权限范围选择「仅 MCP（推荐）」
4. 创建完成后，在弹窗中复制完整密钥
5. 之后如需再次获取，点密钥那一行的「复制密钥」即可复制完整密钥；泄露或不再使用时点「撤销」

密钥规则：

项	说明
数量上限	每个账号最多保留 10 个有效密钥
权限范围	「仅 MCP」只能用于 AI 客户端接入，不能调用其他接口；「全接口」等同登录令牌，可调用所有接口
密钥展示	列表显示密钥前缀，点密钥后的「复制密钥」可直接复制完整密钥
最近使用	列表中显示最近一次使用时间，从未使用会标注「从未使用」
撤销	撤销后该密钥立即失效，无法恢复

在 AI 客户端中配置

在客户端的「添加 MCP 服务器 / 自定义连接器」里填写：

配置项	值
传输方式	远程 / Streamable HTTP（不要选本地命令 / stdio）
服务地址	https://bk.minbb.cn/mcp（自建部署时换成你的服务地址）
请求头	Authorization: Bearer <你的密钥>

有些客户端把请求头拆成「名称 / 值」两栏，此时名称填 Authorization，值填 Bearer sk- 开头的完整密钥。

如果客户端不支持自定义请求头，可以把密钥放在地址的查询参数里： https://bk.minbb.cn/mcp?apiKey=<你的密钥>。这样密钥会出现在地址栏与客户端本地记录中，能用请求头就优先用请求头；一旦怀疑泄露请立即撤销该密钥。

只支持本地命令（stdio）的客户端：这类客户端（部分以配置文件添加服务器的桌面端）不能直接填远程地址，需要先在本机安装一个桥接程序，再由桥接程序指向上面的服务地址。各客户端的桥接方式差异较大，请以该客户端的官方说明为准；本页只覆盖支持远程 MCP 的客户端。

怎么确认已经接好

1. 保存后客户端会拉取到服务器 bookkeep 与一批工具，工具名形如 queryCashItems、getCurrentUser、getBudgetInfo
2. 在客户端里问一句「我有哪些账本？」
3. 回到 Web 端「API 密钥」列表看该密钥的「最近使用」——有新的时间戳说明调用确实打到了你的账号

如果工具列表是空的，通常是传输方式选成了本地命令，或服务地址结尾不是 /mcp。

密钥要当密码看待

密钥与你的账号绑定，持有密钥即可读写你的账目。不要发到群聊、截图或公开仓库；发现泄露请立即在「API 密钥」中撤销。

AI 客户端能做什么

接入后，站内 AI 助手具备的能力在外部客户端同样可用：

能力	可以这样问
查账目明细	「上个月餐饮花了多少」「9 月超过 500 元的支出有哪些」
期间收支统计	「这个月收支怎么样」「今年一共花了多少」
分类 / 标签排行	「钱都花在哪了」「哪个标签花得最多」
财务概览与趋势	「我的储蓄率是多少」「近 12 个月支出趋势」
净资产时间线	「我的净资产变化」「历史最高结余出现在什么时候」
收支健康分	「这个月健康分多少」「为什么分数低」
预算	「这个月预算还剩多少」「今年预算用得怎么样」「这个月每天花了多少」
储蓄计划	「我的储蓄计划进度」「哪些计划已完成」
负债	「我还有多少负债」「还要还多久」
账本 / 分类 / 标签 / 小计 / 资金账户	「我有哪些账本」「各账户余额多少」
记账	「记一笔：午饭 35 元，用微信」
修改 / 删除账目	「把刚才那笔改成 40 元」「删掉重复的那笔」

修改与删除账目时，AI 会先查出该笔记录再执行；如果这笔账目在这期间被其他端改过，AI 会提示冲突，需要重新查询后再改。

这些操作要在 App 内完成

以下功能目前没有开放给 AI 客户端，请仍在各端 App 中操作：

• 账本、分类、标签、小计、资金账户、负债、预算、储蓄计划的新建、修改与删除
• 退款的新增与查看
• 消费画像、大额交易、消费结构、资金流向、消费集中度、储蓄分析等分析页面
• 数据导出与备份

数据与统计口径

• 数据范围：AI 只能访问密钥所属账号的数据，看不到其他账号的账目
• 实时性：查询读到的就是账本当前数据；AI 新增、修改、删除账目会立即写入
• 金额口径：统计与排行的金额按账目的记账金额汇总；部分账目上的优惠额与退款金额不参与汇总，退款金额只在账目明细中单独给出

常见问题

客户端提示连接失败

依次检查：传输方式是否选了「远程 / Streamable HTTP」、服务地址是否以 /mcp 结尾、密钥是否已撤销或超额；若客户端不支持自定义请求头，改用地址里的 ?apiKey= 方式。

配置里提示无权访问 / 未授权

多为密钥填写不完整。请确认值以 Bearer 开头（注意空格），密钥本身以 sk- 开头且没有被撤销；用查询参数方式时确认参数名是 apiKey。

为什么只能查账，不能改分类或预算

AI 客户端目前只开放了本页「能做什么」中列出的能力，管理类操作仍需在 App 内完成。

换电脑后还能用吗

可以。密钥保存在服务端，在新客户端里填入同一份连接信息即可；不用的密钥建议及时撤销。

相关页面

• AI 助手
• 安全中心
• 记一笔