账小秘 · 智能体连接与使用指南

开始之前

先确认，你连接的是哪个账户。

账户归属由后台服务决定，不由手机品牌决定。不同版本中相同的邮箱，不一定对应同一个账户。

账户版本	当前状态
国际版 Web 账户	已开放连接测试
与国际 Web 共用后台的国际 iOS 账户	需能登录同一个 Web 账户，使用网页授权
国际 Android Play 独立账户	暂未接入
中国版、鸿蒙等独立账户	暂未接入

不要为了连接而新建一个空账户。

请登录原有账户。若你只通过原生 App 的第三方登录使用账小秘、暂时无法在 Web 登录，请等待对应登录入口适配；不要用另一个账号代替。

步骤 01

领取你的全球账户号

打开账户管理页。
点击我的账户与授权 ↗。这个页面与国际版账小秘使用同一套登录。
登录已有账户。
未登录时，点击“打开账小秘登录页”。完成登录后回到原页面，点击“我已登录，继续”。当前不必等待原生 App 的设置入口更新。
复制页面显示的全球账户号。
号码以 ZXM- 开头，同一个后台账户重复查看会显示同一号码。之后在智能体的授权页面填入它。

账户号用于找到正确账户，不是密码。只有原账户本人登录并确认授权后，智能体才有权限操作。

打开账户管理页 ↗

步骤 02 · ChatGPT

在 ChatGPT 中添加账小秘

下面是自定义 MCP 的测试接入流程，不是插件商店的一键安装。入口能否使用取决于你的 ChatGPT 账户及工作区政策。

打开 ChatGPT 的 Plugins 页面。
前往 ChatGPT Plugins ↗，选择加号，再选择 Add custom MCP server（添加自定义 MCP 服务器）。看不到入口时，先查看下方常见问题。
填写连接信息。
名称可填写“账小秘”。连接类型选择公共 HTTPS 端点；粘贴完整地址，保留末尾的 /mcp。

ChatGPT 预注册测试配置

服务器地址https://mcp.squirrelly.ai/mcp

认证方式OAuth

客户端 IDsquirrelly-chatgpt

客户端密钥不需要 · 公开客户端使用 PKCE

客户端 ID 仅在宿主提供手动填写字段时使用。若宿主要求必填客户端密钥，不要填入账小秘密码或自行编造密钥；请确认其是否支持公开客户端 OAuth。

完成创建并检查发现的工具。
按 ChatGPT 页面提示配置认证、阅读连接提示并创建插件。服务提供查看账户、查看账本、新增收支、查询流水、汇总收支、查询写入结果六项工具。
触发 OAuth，按下一节完成授权。
宿主可能在创建时，或第一次调用需要账户的工具时要求登录。出现账小秘授权页面后再输入你的账户号。
新建对话并启用连接。
按 ChatGPT 当前界面启用已创建的账小秘插件；支持的界面可输入 @ 选择它。然后先运行下文的只读检查。

高级：回调地址与注册方式

此客户端目前只登记了下面这一条精确回调：

https://chatgpt.com/connector_platform_oauth_redirect

如果宿主管理页展示了不同回调，例如含连接专属 ID 的地址，需要由服务管理员登记实际地址。不要改用通配符，也不要自行替换域名。当前没有开放匿名动态客户端注册或通用 CIMD 注册。

连接状态说明

已使用官方 MCP SDK 客户端验证真实服务，但尚未在真实 ChatGPT 账户中完成最终宿主验证。这份教程提供当前配置，不代表已经上架或通过 OpenAI 审核。

流程依据：OpenAI 官方连接指南 · OAuth 认证说明。核对日期：2026-10-30。

快捷记账技能

用 /squirrelly 开始一句话记账

安装 squirrelly 技能并连接已授权的 MCP 服务后，在支持技能快捷命令的客户端中输入：

技能调用示例

/squirrelly 我今天购买了一件衣服，花了2000元人民币。

下载技能包。
下载 squirrelly 技能 ZIP，解压后查看 INSTALL.md。技能包只包含使用指引，不包含任何人的账户密码或令牌。
按客户端要求安装。
Codex 可将 squirrelly 文件夹放入个人技能目录后，在新会话使用 $squirrelly；支持相应技能目录的客户端可按其说明注册 /squirrelly。命令名称由客户端控制，不是 MCP 自动添加。
先连接 MCP 并完成 OAuth 授权。
技能只指导智能体调用工具，本身不提供账户权限。未连接时不会记账；日期、币种或账本不清楚时，不会擅自写入。

ChatGPT 当前可通过 @ 选择插件。不要假设在所有客户端输入斜杠命令都能生效；请按技能包的安装说明选择对应入口。

步骤 02 · 其他智能体

使用同一服务，连接不同智能体

宿主需要支持远程 MCP Streamable HTTP 与 OAuth 授权码 / PKCE。不同产品的配置位置和支持范围不同，不要直接套用 ChatGPT 的界面步骤。

在宿主中找到远程 MCP 或工具服务器设置。
填写 https://mcp.squirrelly.ai/mcp，认证选择 OAuth。
登记该智能体自己的 OAuth 客户端。
管理员需要登记应用名称、独立客户端 ID 与宿主提供的精确回调地址。squirrelly-chatgpt 专供已登记的 ChatGPT 回调，其他产品不能直接复用。
在浏览器中登录并确认授权。
有了正确的应用注册后，后续账户号、账本选择、记账与撤销流程相同。仅支持本地 stdio、静态 API Key 或不支持 OAuth 的宿主，目前不能直接连接。

开发者也可以使用 HTTP API 接入自己的智能体。支持协议意味着有接入路径，不意味着所有产品已经完成兼容实测。

步骤 03

确认账户、应用和账本

输入你的账户号。
在账小秘连接页面粘贴账户号，继续前往该账户所属版本。
核对原账户登录状态。
如果提示账户不匹配，请在正确版本登录正确账户，再重新连接。仅知道别人的号码无法取得授权。
选择要操作的账本，查看权限。
首版一个连接绑定一个账户和一个指定账本。确认应用名称、账户号和账本后，再点击“同意并连接”。

查看类权限

查看当前授权账户、授权账本、流水与收支汇总。

新增收支权限

允许创建普通收入和支出，不包含修改、删除、转账或借贷。

完成后回到智能体。授权是按应用分别管理的，不会自动合并不同版本的账户，也不会给其他智能体同时开通权限。

步骤 04

先确认连接，再记第一笔账

建议按下面顺序验证。复制按钮只会复制文字，不会自动提交或写入账目。

先做只读检查

请用账小秘查看当前授权的账户和账本，先不要新增任何账目。

检查返回的账户号和账本是否与你选择的一致。正确后，再提交一笔你确实需要记录的收支。

明确要求记账

用账小秘记账：今天午饭花了35元人民币，记到当前授权的账本。

只有服务明确确认入账成功，才算已记账。随后打开原账小秘账户中的对应账本，核对金额、日期和币种。

连接以后

这些事，可以直接在聊天里完成

收入

用账小秘记录：今天收到工资8000元人民币。

查流水

用账小秘查询本周的支出流水，先显示最近20条。

看汇总

用账小秘汇总本月收入、支出和结余，不同币种分开显示。

金额、币种、日期或目标账本不明确时，先把信息说清楚；当前首发不支持通过智能体修改或删除旧账、记录转账、借贷和批量导入。

超时不等于失败，也不等于成功。

如果智能体提示结果未知，请让它查询原操作结果或使用原请求编号重试。不要连续用新请求重复记同一笔。后台会用去重记录防止网络重试产生重复账目。

随时可控

撤销授权，或换一个账户

打开“我的账户与授权”。
在“已授权应用”中找到需要断开的应用，可以看到对应账本与权限。
点击“撤销此应用的授权”。
该应用之后不能继续访问；已经记录的账目保留，原 App 登录和其他授权仍有效。退出 App 登录，不等于撤销智能体授权。
需要换账户或账本时，重新连接并授权。
请在新授权页明确选择目标。重新授权不会把过去的账目搬到新账户，也不会合并版本。

管理我的授权 ↗

遇到问题时

常见问题与连接排查

ChatGPT 里没有“添加自定义 MCP”入口？

入口受 ChatGPT 账户、组织和工作区政策影响。先核对当前官方说明；企业或团队工作区可向管理员确认是否允许自定义连接。服务地址可访问，不代表宿主一定开放该入口。

输入地址后显示 401，是不是服务坏了？

直接在浏览器打开 /mcp 未带授权时，返回 401 是正常行为。它是智能体调用端点，不是登录页面。普通用户从本页进入账户管理，再在智能体里按 OAuth 流程连接。

提示 invalid_client 或回调地址不匹配？

确认填写的是对应应用的客户端 ID，并使用已登记的精确回调。ChatGPT 预注册 ID 为 squirrelly-chatgpt；其他产品需要单独注册。宿主的专属回调若与已登记地址不同，需要管理员更新配置，不要反复更换账户或关闭认证。

找不到账户号，或提示账户不匹配？

回到国际版账户管理页，检查是否登录了正确的原账户。不同版本即使邮箱一样，也可能是独立账户。只有原生 App 登录、尚不能在 Web 登录的账户，需要等待对应入口适配，不要重新注册空账户替代。

能连接，但不能新增收支？

检查所授予的权限是否包含“新增收入和支出”，账本是否仍可访问，并确认请求是普通收入或支出且金额、币种、日期完整。必要时重新连接以明确授予所需权限。

智能体说成功了，但 App 里没找到？

先核对同一个版本、同一个账户、同一个账本，以及日期和币种筛选。让智能体查询原操作结果；只有服务返回已提交（committed）才表示成功。结果未知时，不要再用新编号写一次。

解绑会删账吗？“清理去重记录”又是什么？

解绑仅撤销应用访问，不删除账目。去重记录保存“某个请求已写成哪一笔账”，用于防止重复入账；正常使用、退出登录、撤销授权不会清理它。只有注销整个账户时，相关操作记录才随账户个人数据清理。

换手机、换服务器会怎样？

同一后台账户的号码保持一致。不同后台的独立账户拥有各自号码；目前不会自动跨版本合并。服务器迁移须由平台维护账户映射，不能仅凭相同邮箱自动关联。

连接过期，或提示服务暂时不可用？

过期或撤销后，按宿主提示重新授权。暂时不可用时稍后重试，原 App 仍可使用。不要把密码、验证码或访问令牌发进聊天，也不要为了连接而关闭 HTTPS 证书校验。

给开发者

把记账能力接入自己的智能体

注册自己的 OAuth 客户端与精确回调，通过授权码 + PKCE S256 获取用户授权后，可以调用 MCP 或同一服务的 HTTP API。暂不支持匿名动态注册、共享账户 token 或用账户号直接换取权限。

MCP 工具	能力
`get_account` / `list_books`	查看授权对象
`create_transaction`	创建一笔收入或支出
`list_transactions`	分页查询流水
`summarize_transactions`	按币种汇总
`get_operation`	查询写入结果

金额使用最小货币单位；创建操作必须使用稳定的 requestId（HTTP 为 Idempotency-Key）。只在 committed 时报告成功；unknown 时保留原编号并查询结果。

下载 HTTP API 契约 ↗OAuth 元数据 ↗资源元数据 ↗

从你自己的账户开始。

先领号，再连接。每一次授权，都由你决定。

打开我的账户 ↗