GuGuFin for macOS · Model Context Protocol

讓你習慣的 AI Agent,接上自己的帳本。

用自然語言查帳、整理財務報表、比對信用卡帳單。GuGuFin 提供帳務工具與資料,你選擇支援 MCP 的 AI Agent。

macOS 選單列 App。客戶端需支援本機 Streamable HTTP MCP 與 Bearer Token;各工具的設定方式不同。

從一個帳務問題開始

01 · 財務查詢

「整理上個月的收支,和前一個月比較。」

查詢分類支出、現金流與財務報表,依帳本已有的資料整理結果。

02 · 信用卡對帳

「幫我比對這期信用卡帳單。」

把外部帳單明細交給 Agent 整理,透過工具預覽配對建議,檢查未配對與可能延後入帳的交易。

03 · 記帳與投資紀錄

「把這筆支出記到指定帳本,先讓我確認。」

準備收入、支出、投資與固定支出等支援的帳務提議;缺少金額、帳戶或日期時先補齊資料。

AI 理解意圖,GuGuFin 處理帳務規則

  1. 你提出問題或操作需求
  2. Agent 呼叫 GuGuFin MCP 工具
  3. 查看結果或完整寫入提議
  4. 明確確認後,才執行支援的寫入

如何連接 Codex、Claude Desktop 或其他 MCP 客戶端?

  1. 開啟 Mac 版 GuGuFin,匯入備份並解鎖要使用的帳本工作區。
  2. 從選單列啟動 MCP Server,複製 App 產生的 MCP 設定。
  3. 依客戶端要求設定 HTTP 端點與 Authorization 標頭。先查詢帳本清單,確認連線與資料來源。

Codex、Claude Desktop、Cursor 等客戶端的傳輸與驗證支援可能不同;若需要橋接器,請依該客戶端文件設定。通用 JSON 不是每個客戶端都能直接貼上使用。

閱讀 MCP 設定教學 →

本地帳本與 AI 資料傳輸,是兩件事

MCP 端點綁定 Mac 本機 loopback,並使用 Bearer Token 驗證。工具回傳的帳務資料會交給你選擇的 Agent;使用雲端 AI 時,可能送至該服務商處理。開啟 iCloud 同步的帳本也會透過 Apple 同步。請依自己的需求選擇客戶端與同步設定。

開始前常見問題

手機也有 MCP Server 嗎?

這裡介紹的是 macOS 版 MCP Server。手機可以記帳與匯出備份,MCP 連線由 Mac 提供。

AI 可以直接執行 SQL 或任意改帳嗎?

對外提供的是帳務工具,不是任意 SQL 介面。寫入採提議與確認流程;Agent 應先展示完整提議,取得你的明確同意後才呼叫確認工具。

可以當作即時銀行同步或即時股價來源嗎?

MCP 查詢的是目前載入帳本的資料。請確認資料更新時間、匯率與行情來源;它不等同直接連上銀行,也不保證即時行情。

從查詢開始,再決定要交給 AI 哪些工作。

閱讀 MCP 設定教學 →