English ← 回 KakePhooa

使用手冊

連接 AI 助理（MCP）

KakePhooa 內建 MCP，讓 Claude 這類 AI 助理可以代表你查詢預算、分析花錢的習慣，也能幫你記帳、訂正記錯的金額。

這一章說明如何把 AI 助理連上你的帳號、它能做什麼，以及如何收回權限。

連接的方式

AI 助理是靠一張存取憑證代表你存取資料，憑證有兩種方式可以取得。

方式一：從 AI 助理授權

適合 Claude 或 ChatGPT 這類提供「連接器 (Connector)」的 AI 助理，不需要自己複製任何憑證。

  1. 在 AI 助理的連接器設定中，新增一個自訂連接器，網址填 https://kakephooa.com/mcp。
  2. AI 助理會把你帶到 KakePhooa 的授權頁。還沒登入的話，先登入，登入後會回到授權頁。
  3. 授權頁會列出這個 AI 助理想取得的權限：
    • 存取你的全部家計，不是單一一個
    • 讀取預算、記帳、債務等全部資料
    • 依你的指示新增、修改、刪除一筆支出
  4. 確認之後按「同意」。不想授權就按「拒絕」。

同意之後，系統會發出一張存取憑證，並自動交給 AI 助理使用，你不需要保管它。

方式二：手動建立存取憑證

適合 Claude Code、Cursor、VS Code 這類可以自己填入請求標頭的工具。

  1. 點畫面右上角圓形的帳號按鈕，選「設定」。這是帳號的設定，不是底部分頁的「設定」。
  2. 在「存取憑證」區塊點「管理存取憑證」。
  3. 在「名稱」輸入方便辨認的名字，例如「我的 Claude Code」，按「建立」。
  4. 畫面會顯示「新的存取憑證」。這串憑證只會顯示這一次，離開頁面後無法再度顯示，請立刻複製並存好。
  5. 在工具裡，把連線網址設為 https://kakephooa.com/mcp，並在每個請求帶上標頭 Authorization: Bearer <你的憑證>。

管理與撤銷憑證

到「設定」→「管理存取憑證」，「既有憑證」列出你所有的憑證，每一張都會顯示：

不想再讓某個 AI 助理存取，或懷疑憑證外流時，按那張憑證的「撤銷」，憑證將立刻失效。撤銷之後，AI 助理要重新授權才能繼續使用。

憑證的權限

AI 助理能做什麼

查詢

能做的事說明
列出你的家計其他查詢都需要先指定是哪一個家計。
查看支出指定某個月，可只看特別支出，也可只看某個分類。結果包含筆數與合計。
查看分類列出家計的所有分類，「未分類」排在最前面。
查看債務每筆貸款或分期這一期應繳的金額、剩餘餘額，以及預計還清的月份。
查看預算週期指定某個月，取得生活費額度、固定開銷、各分類的預算與實際支出，以及這期的額外收入。
查看目前的花錢速度今天與本週已花多少、依目前速度推估的期末支出，以及系統的觀察。

每一筆金額都附帶家計的幣別，AI 助理轉述時會用同一種幣別。

記帳

能做的事說明
新增一筆支出可指定分類、日期、備註與明細，也可標成特別支出。
一次新增多筆支出每次最多 20 筆，其中一筆有誤就整批不記。
修改一筆支出沒有指定的欄位維持原值。
刪除一筆支出就是作廢，紀錄仍然保留。

這幾個寫入的動作，AI 助理在動手之前應該先跟你確認，例如「要歸在『餐飲』分類嗎？」。新增與修改完成後，它會把結果覆述給你，方便你及早發現寫錯。

一次記好幾筆時，AI 助理會把整批列給你看、確認一次就好，不會一筆一筆問。也可以跟它說「直接記，不用問我」，它就會自己判斷分類後直接新增，記完再覆述結果。這只適用於新增，修改與刪除還是會先問過你。

拍收據給 AI 助理記帳時，它可以把收據上的品項一併記成明細，折扣記成負數的品項。需要確認時，品項會和分類列在同一張確認表裡，確認一次就好。收據上的東西分屬不同分類時，它會依分類記成好幾筆支出，各自帶著自己的明細。修改支出時沒有提到明細，原本的明細維持不變。明細的規則與畫面上相同，見〈記帳〉章。

寫入的支出跟你自己在畫面上記的完全一樣：

遇到問題