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

开始之前

先确认后台和 App 版本。

本流程面向国际 iOS 共用后台。app.squirrelly.ai 继续作为服务域名和 API，无需使用 Web 软件或网页登录。其他独立后台即使邮箱相同，也可能是不同账户。

账户版本	当前状态
国际 iOS 共用后台	连接测试 · 需新版 App
原生 App 版本要求	需有“设置 → 智能体连接”。需要新版原生构建，不代表当前已安装或 App Store 版本已有此功能。
国际 Android Play 独立账户	暂未接入
中国版、鸿蒙等独立账户	暂未接入

使用原有 App 账户。

当前仅面向国际 iOS 共用后台，独立国际 Android Play、中国版、鸿蒙后台未开放。若没有“智能体连接”，请升级或等待兼容版本；不要另建 Web 账户替代。

步骤 01

在 App 复制全球账户号

打开原生 App“设置 → 智能体连接”。
使用 App 内已登录的原有账户。打开 App 指引 ↗仅说明如何打开 App，不提供 Web 登录或网页账户管理。
确认 App 版本支持此功能。
此流程需要包含“智能体连接”的新版原生 App。未看到入口请升级或等待发布，不能假设当前已安装或 App Store 版本已经支持。
在“智能体连接”复制全球账户号。
号码以 ZXM-开头。同一后台账户保持同一号码。稍后填入浏览器授权请求，用于识别对应后台账户。

账户号用于找到正确账户，不是密码。必须由登录匹配账户的原生 App 明确同意后，智能体才能访问。

查看打开 App 指引 ↗

步骤 02 · ChatGPT

在 ChatGPT 中添加账小秘

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

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

ChatGPT 填写配置（含高级 OAuth 设置）

设置	正确值
名称	`squirrellyai`
服务器地址	`https://mcp.squirrelly.ai/mcp`
认证方式	OAuth
注册方法	自定义 OAuth 客户端
OAuth 客户端 ID	`squirrelly-chatgpt`
客户端密钥	留空
Token 端点身份验证方法	`none`
注册地址	留空
开启 OIDC	不勾选

展开“高级 OAuth 设置”，按上表逐项填写。客户端 ID 必须填 squirrelly-chatgpt，不能用插件名称或账户号代替。

DCR、CIMD 不可用的提示表示服务器未提供这两种自动注册能力。当前请选择“自定义 OAuth 客户端”，按表填写；不需要填写注册地址或开启 OIDC。

默认请求的权限范围保留 account:read、books:read、transactions:read、transactions:create、summaries:read 五项；基础授权范围留空。

完成创建并安装或启用插件，再连接账户。
按 ChatGPT 提示创建个人插件，随后安装或启用并选择“连接账户”。插件创建成功不代表已获得账户权限；还需完成 App 内授权。服务提供账户、账本、新增收支、查询流水、汇总收支、写入结果六项工具，授权完成后再测试调用。
触发 OAuth，按下一节完成授权。
OAuth 打开账小秘请求页面后，输入从 App 复制的账户号。保持此浏览器打开，随后到 App 确认授权。
新建对话并启用连接。
按 ChatGPT 当前界面启用已创建的账小秘插件；支持的界面可输入 @ 选择它。然后先运行下文的只读检查。

个人插件已创建，还需要连接账户

在 ChatGPT 个人插件里看到 squirrellyai，表示创建成功。继续安装或启用这个插件并连接账小秘账户，完成 App 内授权，再测试工具调用；不需要重复创建。

高级：核对 OAuth 端点与回调地址

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

https://chatgpt.com/connector_platform_oauth_redirect

如果宿主管理页显示不同回调，例如含连接专属 ID 的地址，需要由服务管理员登记该精确地址。不要使用通配符或自行替换域名。其他智能体须单独登记客户端，不得复用此 ChatGPT 客户端。当前未开放 DCR 或通用 CIMD 注册。

核对自动发现的 OAuth 端点

设置	正确值
授权网址	`https://mcp.squirrelly.ai/oauth/authorize`
Token URL	`https://mcp.squirrelly.ai/oauth/token`
授权服务器基地址	`https://mcp.squirrelly.ai`
资源	`https://mcp.squirrelly.ai/mcp`

连接状态说明

已使用官方 MCP SDK 客户端验证真实服务，但尚未在真实 ChatGPT 账户中验证最终工具调用。创建个人插件成功不等于账户授权或工具调用已完成，也不代表上架或通过 OpenAI 审核。

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

快捷记账技能

一条命令安装 squirrelly 记账技能

按电脑系统和客户端选择安装命令，自动下载并安装 squirrelly 技能。MCP 连接和 App 内 OAuth 授权需要另外完成；完成后可用技能快捷命令记账。

自动下载并安装

复制对应命令到电脑终端，或交给能在本机执行命令的智能体运行。命令会自动下载、校验并安装，不需要手动解压。

macOS Windows

macOS

macOS：在“终端”运行，使用系统自带工具，不要求另装 Python 或 Homebrew。按正在使用的客户端选择命令。

Codex

/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client codex

Claude Code

/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client claude-code

查看安装脚本 · macOS ↗

Windows

Windows：在 PowerShell 中运行，支持 Windows PowerShell 5.1 和 PowerShell 7。按正在使用的客户端选择命令。

Codex

& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client codex

Claude Code

& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client claude-code

查看安装脚本 · Windows ↗

安装器校验 SHA-256，仅安装技能文件；已存在的不同内容不会默认覆盖。需要更新时，macOS 命令追加 --update，Windows 命令追加 -Update，安装器会先备份。

安装后重新加载客户端或开始新会话。Codex 使用 $squirrelly，Claude Code 使用 /squirrelly。安装技能不会自动配置 MCP 或完成 OAuth，仍需连接服务并在 App 确认授权。

网页不能静默安装本地技能。ChatGPT 网页端使用插件连接；上述命令适用于有本地执行权限的客户端。

手动下载 ZIP（备用）

客户端不支持本地命令时，可使用下面的 ZIP 导入方式；具体以客户端能力为准。

手动下载技能 ZIP（备用）。
下载 squirrelly 技能 ZIP，手动解压后查看 INSTALL.md。技能包包含技能文件，不包含账户密码或令牌。
按客户端要求安装。
Codex 可将 squirrelly 文件夹放入个人技能目录后，在新会话使用 $squirrelly；支持相应技能目录的客户端可按其说明注册 /squirrelly。命令名称由客户端控制，不是 MCP 自动添加。

先连接 MCP 并完成 OAuth 授权。 技能只指导智能体调用工具，本身不提供账户权限。未连接时不会记账；日期、币种或账本不清楚时，不会擅自写入。

技能调用示例

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

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

步骤 02 · 其他智能体

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

按使用入口选择操作方式

使用入口	操作步骤
ChatGPT 网页端	按上方 ChatGPT 配置表创建或启用插件，再连接账户并在 App 确认授权。无需在电脑上安装本地技能。
Codex	先用下方 macOS 或 Windows 命令安装技能，再单独配置 MCP、完成 App 授权；重新加载客户端后使用 $squirrelly。
Claude Code	先用下方 macOS 或 Windows 命令安装技能，再单独配置 MCP、完成 App 授权；重新加载客户端后使用 /squirrelly。

查看 macOS 安装命令查看 Windows 安装命令

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

在宿主中找到远程 MCP 或工具服务器设置。
填写 https://mcp.squirrelly.ai/mcp，认证选择 OAuth。
登记该智能体自己的 OAuth 客户端。
管理员需要登记应用名称、独立客户端 ID 与宿主提供的精确回调地址。squirrelly-chatgpt 专供已登记的 ChatGPT 回调，其他产品不能直接复用。
在原生 App 确认授权。
客户端登记完成后，使用下方相同的 App 授权流程。保持发起请求的原浏览器打开以完成 OAuth。仅支持本地 stdio、静态 API key 或不支持 OAuth 的宿主目前不能直接接入。

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

步骤 03

核对账户、客户端和权限

在浏览器请求页填写账户号。
粘贴 ZXM 账户号以识别后台。手机浏览器点击“打开 App”；桌面浏览器用手机扫描页面二维码，进入原生 App。全程保持原浏览器打开。
在原生 App 核对账户和客户端。
App 登录账户必须与请求显示的账户一致。不一致时请拒绝，改用正确 App 账户重新连接。知道账户号不代表有访问权，无需输入 Web 密码。
检查权限，明确同意或拒绝。
App 自动使用当前账户现有的唯一账本，无需选择。每个连接仍只绑定一个账户和一本账本。核对账户、客户端名称和请求权限后，在 App 内明确同意或拒绝；不会自动授权。

查看类权限

查看授权账户、其唯一账本、收支流水及收支汇总。

新增收支权限

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

手机同意仅表示 App 已确认请求，不代表智能体的 OAuth 已完成。请保持原浏览器打开，由原浏览器继续并完成 OAuth，再返回智能体。拒绝或过期不会授予访问权。不同客户端的授权独立管理。

步骤 04

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

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

先做只读检查

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

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

明确要求记账

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

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

连接以后

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

收入

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

查流水

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

看汇总

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

明确金额、币种和日期，使用当前授权账本。首发不支持智能体修改或删除旧账目、转账、借贷和批量导入。

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

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

随时可控

撤销授权，或换一个账户

打开原生 App“设置 → 智能体连接”。
在 App 找到已授权客户端，查看它的账本和权限。
在 App 撤销该客户端授权。
该应用之后不能继续访问；已经记录的账目保留，原 App 登录和其他授权仍有效。退出 App 登录，不等于撤销智能体授权。
需要换账户时，重新连接并授权。
重新连接前，在原生 App 登录目标账户并核对请求和权限。连接自动使用该账户的唯一账本。重新授权不会迁移旧账目，也不会合并不同后台的账户。

查看打开 App 指引 ↗

遇到问题时

常见问题与连接排查

安装成功后，为什么还不能记账？

安装成功仅表示技能文件已就位。请确认该客户端已登记独立 OAuth 客户端和精确回调，已连接 MCP，并在 App 核对账户、客户端和权限后明确同意。App 自动使用账户唯一账本；手机同意后仍需保持原浏览器打开并完成 OAuth。重新加载客户端后，先查询当前授权账户和账本；确认一致后再记录真实收支。

填写账户号后出现错误页面怎么办？

返回现有 squirrellyai 插件重新发起“连接账户”，使用新打开的授权页填写账户号。不要只刷新旧错误页。手机 App 无需因本次网页修复而重装；若仍失败，保留页面显示的错误代码。

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

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

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

直接在浏览器打开 /mcp 在未授权时直接访问通常返回 401。这是智能体接口，不是登录页。先在原生 App“设置 → 智能体连接”复制账户号，再由智能体发起 OAuth，在 App 内确认。

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

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

没有“智能体连接”、账户不匹配，或浏览器一直等待？

需要包含“设置 → 智能体连接”的新版 App；入口缺失请升级或等待。到 App 核对原账户和后台。手机同意期间保持原浏览器打开，再回原浏览器完成 OAuth。请求拒绝或过期后重新发起。不要另建 Web 账户或输入 Web 密码。

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

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

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

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

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

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

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

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

请求过期、授权撤销或服务暂时不可用？

过期或拒绝的请求不会授权，请重新发起 OAuth 并在 App 同意新请求。授权已撤销时需重新连接。服务暂不可用请稍后重试。保持原浏览器打开；不要在聊天中发送密码、验证码或令牌，也不要关闭 HTTPS 证书校验。

给开发者

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

登记自己的 OAuth 客户端和精确回调地址。浏览器用 account_code 识别后台，原生 App 确认请求，由原浏览器完成授权码 / PKCE S256 流程后调用 MCP 或 HTTP API。不支持匿名动态注册、共享账户令牌或仅凭账户号获取访问权。

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

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

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

从你自己的账户开始。

在 App 查看账户号并同意授权，再回原浏览器完成 OAuth。

查看打开 App 指引 ↗

把记账，交给你的智能体。

先确认后台和 App 版本。

在 App 复制全球账户号

在 ChatGPT 中添加账小秘

ChatGPT 填写配置（含高级 OAuth 设置）

核对自动发现的 OAuth 端点

一条命令安装 squirrelly 记账技能

自动下载并安装

macOS

Windows

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

按使用入口选择操作方式

核对账户、客户端和权限

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

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

撤销授权，或换一个账户

常见问题与连接排查

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

从你自己的账户开始。

把记账，
交给你的智能体。