將雲端帳本連接到你的 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。

如何停用或撤銷

先在客戶端停用連線。如客戶端提供撤銷授權功能，請執行撤銷；僅刪除本機設定不保證伺服器端授權已撤銷。沒有撤銷入口或仍有疑問時，請聯絡支援。