帳小秘松鼠頭像帳小秘智慧代理使用指南
國際 iOS 共用後端 · App 內授權

把記帳，
交給你的智慧代理。

連接原有帳小秘帳戶，在聊天中記錄收支、查找帳目和查看彙總。在原生 App 核對帳戶、用戶端和權限並確認授權，自動使用帳戶現有的唯一帳本。

第 1 步：查看帳戶號碼 ↓查看連線步驟 ↓

需要含「設定 → 智慧代理連線」的新版原生 App；沒有入口請升級或等待該版本發布，註冊 Web 帳戶無法解決。

01取得帳戶號碼→02新增連線→03App 內確認授權→04開始記帳

開始之前

先確認後端和 App 版本。

本流程適用於國際 iOS 共用後端。app.squirrelly.ai 繼續作為服務網域和 API，不需要使用 Web 軟體或網頁登入。其他獨立後端即使電子郵件相同，也可能是不同帳戶。

帳戶版本目前狀態
國際 iOS 共用後端連線測試 · 需新版 App
原生 App 版本要求需有「設定 → 智慧代理連線」。需要新版原生組建，不代表目前安裝或 App Store 版本已有此功能。
國際版 Android Play 獨立帳戶尚未開放連線
中國版、HarmonyOS 等獨立帳戶尚未開放連線
使用原有 App 帳戶。

目前僅適用於國際 iOS 共用後端，獨立國際 Android Play、中國版、HarmonyOS 後端未開放。若沒有「智慧代理連線」，請升級或等待相容版本；不要另建 Web 帳戶替代。

步驟 01

在 App 複製全球帳戶號碼

  1. 開啟原生 App「設定 → 智慧代理連線」。

    使用 App 內已登入的原有帳戶。開啟 App 指引 ↗僅說明如何開啟 App，不提供 Web 登入或網頁帳戶管理。

  2. 確認 App 版本支援此功能。

    此流程需要包含「智慧代理連線」的新版原生 App。未看到入口請升級或等待發布，不能假設目前安裝或 App Store 版本已經支援。

  3. 在「智慧代理連線」複製全球帳戶號碼。

    號碼以 ZXM-開頭。同一後端帳戶維持相同號碼。稍後填入瀏覽器授權請求，用於識別對應後端帳戶。

帳戶號碼用來找到正確帳戶，不是密碼。必須由登入相符帳戶的原生 App 明確同意後，智慧代理才能存取。

查看開啟 App 指引 ↗

步驟 02 · ChatGPT

在 ChatGPT 中加入帳小秘

以下是自訂 MCP 的測試連線流程，並非外掛商店的一鍵安裝。能否使用此入口取決於你的 ChatGPT 帳戶及工作區政策。

  1. 開啟 ChatGPT 的 Plugins 頁面。

    前往 ChatGPT Plugins ↗，點選加號，再選擇 Add custom MCP server（新增自訂 MCP 伺服器）。若看不到此選項，請先查看下方常見問題。

  2. 填寫連線資訊。

    名稱填寫「squirrellyai」，連線類型選擇公開 HTTPS 端點。貼上完整網址，保留結尾的 /mcp。

ChatGPT 設定填寫（含進階 OAuth 設定）

設定正確值
名稱squirrellyai
伺服器位址https://mcp.squirrelly.ai/mcp
驗證方式OAuth
註冊方式自訂 OAuth 用戶端
OAuth 用戶端 IDsquirrelly-chatgpt
用戶端密鑰留空
Token 端點驗證方式none
註冊網址留空
啟用 OIDC不勾選

展開「進階 OAuth 設定」，依上表逐項填寫。用戶端 ID 必須填 squirrelly-chatgpt，不能以外掛名稱或帳戶號碼代替。

DCR、CIMD 無法使用的提示表示伺服器未提供這兩種自動註冊能力。請選擇「自訂 OAuth 用戶端」，依表填寫；不需要填寫註冊網址或啟用 OIDC。

預設請求的權限範圍保留 account:read、books:read、transactions:read、transactions:create、summaries:read 五項；基本授權範圍留空。

  1. 完成建立並安裝或啟用外掛，再連接帳戶。

    依 ChatGPT 指示建立個人外掛，接著安裝或啟用並選擇「連接帳戶」。外掛建立成功不代表已取得帳戶權限；仍須完成 App 內授權。服務提供帳戶、帳本、新增收支、查詢明細、彙總收支及寫入結果六項工具，授權後再測試呼叫。

  2. 啟動 OAuth，依下一節完成授權。

    OAuth 開啟帳小秘請求頁面後，輸入從 App 複製的帳戶號碼。保持此瀏覽器開啟，隨後到 App 確認授權。

  3. 開啟新對話並啟用連線。

    依照 ChatGPT 目前的介面啟用已建立的帳小秘外掛；支援的介面可輸入 @ 來選取它。接著先執行下文的唯讀檢查。

個人外掛已建立，仍需連接帳戶

在 ChatGPT 個人外掛看到 squirrellyai，代表建立成功。繼續安裝或啟用此外掛並連接帳小秘帳戶，完成 App 內授權，再測試工具呼叫；不需要重複建立。

進階：核對 OAuth 端點與回呼位址

此用戶端目前僅登記以下這個必須完全相符的回呼位址：

https://chatgpt.com/connector_platform_oauth_redirect

若宿主管理頁顯示不同回呼，例如含連線專屬 ID 的位址，須由服務管理員登記該精確位址。不要使用萬用字元或自行替換網域。其他智慧代理須單獨登記用戶端，不得重用此 ChatGPT 用戶端。目前未開放 DCR 或通用 CIMD 註冊。

核對自動探索的 OAuth 端點

設定正確值
授權網址https://mcp.squirrelly.ai/oauth/authorize
Token URLhttps://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 授權須另外完成；完成後可用技能快捷指令記帳。

自動下載並安裝

將對應指令複製到電腦終端機，或交由可在本機執行指令的智慧代理執行。指令會自動下載、驗證並安裝，不需手動解壓縮。

macOSWindows

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 匯入方式；以用戶端實際能力為準。

  1. 手動下載技能 ZIP（備用）。

    下載 squirrelly 技能 ZIP，手動解壓縮後閱讀 INSTALL.md。技能套件包含技能檔案，不含帳戶密碼或權杖。

  2. 依用戶端要求安裝。

    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 的介面步驟。

  1. 在宿主中找到遠端 MCP 或工具伺服器設定。

    填入 https://mcp.squirrelly.ai/mcp，驗證方式選擇 OAuth。

  2. 為該智慧代理註冊獨立的 OAuth 用戶端。

    管理員必須登記應用程式名稱、獨立用戶端 ID 與宿主提供的精確回呼位址。squirrelly-chatgpt 專供已登記的 ChatGPT 回呼使用，其他產品不能直接共用。

  3. 在原生 App 確認授權。

    用戶端登記完成後，使用下方相同的 App 授權流程。保持發起請求的原瀏覽器開啟以完成 OAuth。僅支援本機 stdio、靜態 API key 或不支援 OAuth 的宿主目前不能直接接入。

開發者也可使用 HTTP API 整合自己的智慧代理。支援協定表示存在整合途徑，不代表所有產品均已完成相容性實測。

步驟 03

核對帳戶、用戶端和權限

  1. 在瀏覽器請求頁填寫帳戶號碼。

    貼上 ZXM 帳戶號碼以識別後端。手機瀏覽器點選「開啟 App」；桌面瀏覽器用手機掃描頁面 QR Code，進入原生 App。全程保持原瀏覽器開啟。

  2. 在原生 App 核對帳戶和用戶端。

    App 登入帳戶必須與請求顯示的帳戶一致。不一致時請拒絕，改用正確 App 帳戶重新連線。知道帳戶號碼不代表有存取權，不需要輸入 Web 密碼。

  3. 檢查權限，明確同意或拒絕。

    App 自動使用目前帳戶現有的唯一帳本，無須選擇。每個連線仍只綁定一個帳戶和一本帳本。核對帳戶、用戶端名稱和請求權限後，在 App 內明確同意或拒絕；不會自動授權。

檢視權限

查看授權帳戶、其唯一帳本、收支明細及收支彙總。

新增收支權限

允許建立一般收入與支出，不包含修改、刪除、轉帳或借貸。

手機同意僅表示 App 已確認請求，不代表智慧體的 OAuth 已完成。請保持原瀏覽器開啟，由原瀏覽器繼續並完成 OAuth，再返回智慧體。拒絕或過期不會授予存取權。不同用戶端的授權獨立管理。

步驟 04

先確認連線，再記第一筆帳

建議依以下順序驗證。複製按鈕只會複製文字，不會自動提交或寫入帳目。

先執行唯讀檢查

請用帳小秘查看目前授權的帳戶與帳本，先不要新增任何帳目。

檢查回傳的帳戶號碼與帳本是否符合 App 目前帳戶及其唯一帳本。確認正確後，再提交一筆確實需要記錄的收支。

明確要求記帳

用帳小秘記帳：今天午餐花了35元人民幣，記到目前授權的帳本。

只有服務明確確認入帳成功，才算完成記帳。接著開啟原帳小秘帳戶中對應的帳本，核對金額、日期與幣別。

連線之後

這些事，都能直接在對話中完成

收入

用帳小秘記錄：今天收到薪資8000元人民幣。

查明細

用帳小秘查詢本週的支出明細，先顯示最近20筆。

看彙總

用帳小秘彙總本月收入、支出與結餘，不同幣別分開顯示。

明確金額、幣別和日期，使用目前授權帳本。首發不支援智慧體修改或刪除舊帳目、轉帳、借貸和批次匯入。

逾時不代表失敗，也不代表成功。

若智慧代理提示結果未知，請讓它查詢原操作結果，或使用原請求編號重試。不要連續以新請求重複記錄同一筆帳。後端會透過去重記錄，防止網路重試產生重複帳目。

隨時掌握控制權

撤銷授權，或更換帳戶

  1. 開啟原生 App「設定 → 智慧代理連線」。

    在 App 找到已授權用戶端，查看它的帳本和權限。

  2. 在 App 撤銷該用戶端授權。

    此應用程式之後便無法繼續存取；已記錄的帳目會保留，原 App 登入與其他授權仍有效。登出 App 不等於撤銷智慧代理授權。

  3. 若要更換帳戶，請重新連線並授權。

    重新連線前，在原生 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 指引 ↗