把云端账本接到你的 AI 工具

接入后能做什么

查账和统计

查找支出、分类、成员和审批记录，按日期或分类统计，并查看分摊与结算。

新增和整理记录

新增、修改支出，管理分类和参与人。修改先生成预览，再执行写入。

管理共享账本

在权限允许时管理邀请、审批和分享链接。删除、恢复等敏感操作需要额外授权。

读取账单图片

支持图片的客户端可以读取已授权账本中的收据附件。识别效果由该客户端决定。

接入前需要准备什么

酷喵账号与云端账本

登录与 App 相同的账号。MCP 只访问云端账本，本地账本不会自动上传。没有云端账本时，可先在 App 中创建或接受邀请。

Basic 会员

创建云端共享账本和保持账本可编辑，需要账本所有者有有效 Basic 会员。受邀成员可免费参与，操作仍受成员权限限制。开通或续费会员需要下载酷喵 App，在 App 内完成购买；官网和 MCP 不提供购买入口。

支持远程 MCP 的客户端

客户端需要支持 Streamable HTTP 和 OAuth 登录。其账号、套餐、组织设置可能限制接入；外部 AI 的订阅或模型费用由对应服务收取，Basic 不包含这些费用。

下载酷喵 App

选择一种接入方式

以下方式使用同一个服务地址。Codex 原生 OAuth 接入已在测试环境验证；其他客户端按官方配置方式说明，尚未逐一验证实际连接。请使用支持远程 MCP 的当前版本。

codex mcp add coolmeow --url https://coolmeow.aside0.com/mcp
codex mcp login coolmeow
codex mcp list

[mcp_servers.coolmeow]
url = "https://coolmeow.aside0.com/mcp"

https://coolmeow.aside0.com/mcp

{
  "mcpServers": {
    "coolmeow": {
      "url": "https://coolmeow.aside0.com/mcp"
    }
  }
}

{
  "servers": {
    "coolmeow": {
      "type": "http",
      "url": "https://coolmeow.aside0.com/mcp"
    }
  }
}

登录后，选择账本与权限

1. 核对账号

   在酷喵授权页登录，并核对账号身份。需要邮箱验证时先完成验证。登录方式以页面提供的选项为准。

2. 选择账本

   授权页默认不选择账本。可以只选指定账本；若希望创建新账本或接受新邀请，需要明确选择当前及未来的全部可访问账本。

3. 选择操作范围

   只查账时选择读取即可。需要修改时再开放写入，管理删除、邀请或公开分享时再开放敏感操作。授权不会改变你在账本中的成员角色。

读取ledger:read

查询已授权账本，不可写入。

写入ledger:write

允许预览和执行普通修改，仍遵守审批规则。

敏感操作ledger:sensitive

额外允许删除、恢复、邀请、公开分享等；需要同时开放写入。

连接后，可以这样提问

修改怎样保存

1. 说明账本、金额、币种、日期、付款人和分摊方式。信息不完整时，让客户端先补齐。
2. 客户端调用预览，返回将要改变的记录和金额。核对后再让它执行。预览有效期为 5 分钟，过期或相关记录有变化时需要重新预览。
3. 执行后查看结果，并在 App 中核对记录。请求超时或结果不确定时，应先查询原操作结果，避免重复新增。

使用边界

只能访问云端数据

MCP 无法读取离线本地账本，也不能调用手机摄像头、麦克风、通知设置或应用商店购买。

权限与会员规则照常生效

只读成员不能写入，编辑者不能越过所有者权限。账本只读、会员到期或审批限制不会因接入 AI 而绕过。

确认界面由客户端提供

服务端要求先预览再写入，但预览不等于你已确认。是否弹出确认框、是否自动执行，取决于客户端设置；需要逐笔确认时，请检查其工具审批设置。

AI 仍可能理解错

账本、币种、日期和分摊方式都可能被误解。统计工具按币种分别汇总，不会把不同货币直接相加；AI 自行做出的解释或换算需要另外核对。

不会转账，也不代替 App 的收据识别

结算记录用于记下已经发生的付款，不会发送资金。MCP 不调用酷喵 App 的收据识别服务，也不共享其识别额度；图片识别取决于外部客户端的能力和费用。

数据会交给所用客户端处理

工具返回的账目和收据附件可能进入外部 AI 的上下文或会话记录，其保存、训练和删除政策以该服务为准。可仅授权需要的账本，并从读取权限开始。

连接或操作遇到问题

看不到账本

核对登录账号、账本是否已上云、是否为有效成员，以及是否在授权页选中了该账本。改变范围后需重新授权。

登录失败或没有连接入口

更新客户端，检查远程 MCP、OAuth 和组织权限。需要选择 OAuth 注册方式时使用自动注册（DCR）；酷喵不支持旧式 HTTP+SSE，也不需要手填 API key。

如何停用或撤销

先在客户端停用连接。如客户端提供撤销授权功能，请执行撤销；仅删除本地配置不保证服务端授权已撤销。没有撤销入口或仍有疑问时，请联系支持。