在 Claude、ChatGPT 裡直接記帳
把 Okaro 加成 Claude 或 ChatGPT 的連接器,一句話就能記帳、辨識收據、問「這個月花了多少?」。也能用本機 MCP server 與 CLI 接進 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex 等 Agent。用你自己的 Okaro 帳號登入,AI 只看得到你的資料。
在 Claude、ChatGPT 直接使用
Beta不用安裝任何東西:在 Claude 或 ChatGPT 加入 Okaro 連接器(遠端 MCP server),登入 Okaro 帳號並允許存取,就能在對話中記帳。目前為 Beta。
MCP server 網址
https://okaro.harukibox.com/mcpClaude
claude.ai 網頁版、桌面版與手機 App;自訂連接器需要 Pro、Max、Team 或 Enterprise 方案。
- 開啟 Settings(設定)→ Connectors(連接器),點「Add custom connector」。
- Name 填 Okaro,URL 填 https://okaro.harukibox.com/mcp,按 Add。
- 按 Connect,登入你的 Okaro 帳號,在 Okaro 的授權頁面按「允許」。
- 回到對話,從工具選單(Search and tools)開啟 Okaro。
ChatGPT
需要可開啟開發者模式的方案(例如 Plus、Pro、Business)。
- 開啟 Settings(設定)→ Apps & Connectors → Advanced settings,開啟 Developer mode(開發者模式)。
- 回到 Apps & Connectors,點「Create」。
- Name 填 Okaro,MCP Server URL 填 https://okaro.harukibox.com/mcp,Authentication 選 OAuth。
- 勾選「I trust this application」,按 Create,登入你的 Okaro 帳號,在 Okaro 的授權頁面按「允許」。
- 在對話中,從「+」或 Developer mode 工具選單選擇 Okaro。
連上之後,試試看這樣說
- 記一筆:今天全聯 368 元
- (在 ChatGPT 上傳收據照片)幫我記這張收據,實際刷了台幣 2,752
- 這個月花了多少?跟上個月比?
連接器的工具與本機 MCP server 相同,但不需要 sign_in / sign_out(連線本身就是登入),也不讀取本機檔案:在 ChatGPT 上傳的收據照片會自動交給 Okaro,也可以直接提供圖片網址。只能存取你自己的 Okaro 資料(Supabase RLS 隔離),方案與免費版限制和 App 相同;隨時可在 Claude 或 ChatGPT 的設定中中斷連線以取消授權。
為什麼選擇 Okaro 作為 Agent 的記帳後端?
AI 原生收據辨識
Gemini 2.5 辨識金額、商家、日期與品項,Agent 拿到結構化 JSON,不必再自己 OCR。record_receipt 可以一步完成辨識與存檔。
原幣金額與實際扣款金額分開記
每筆交易都保留原始金額與幣別,以及以你的結算幣別計的結算金額。海外消費要填實際扣款金額或你提供的確切匯率,Okaro 不會用參考匯率猜;convert_currency 只提供標示為「估算」的參考換算。
用你自己的帳號,資料由 RLS 隔離
以 okaro login 登入你的 Okaro 帳號(Google、Apple 或 Email),Agent 以你的身分存取,Supabase RLS 確保只看得到你的資料。okaro logout 只會撤銷 CLI / MCP 的登入,網頁與 iPhone 不受影響。
雙憑證對帳天然友善
每筆交易可保留原始收據與付款憑證,Agent 可以協助完成報銷、報稅與客戶請款流程。
三種介接面,任選一種或組合使用
Claude / ChatGPT 連接器適合直接在對話中記帳,不用安裝;本機 MCP server 適合 Claude Desktop、Cursor 等桌面 Agent;CLI 適合 shell、腳本與 Claude Code。網站本身也支援 WebMCP:在支援的瀏覽器中,瀏覽器內的 AI Agent 可以直接使用 Okaro 的網站工具。
Claude / ChatGPT 連接器
遠端 MCP server(Streamable HTTP),以 OAuth 2.1 登入你的 Okaro 帳號(支援動態用戶端註冊與 PKCE)。在 Claude 的自訂連接器或 ChatGPT 的開發者模式加入網址即可使用,工具與本機版相同(不含 sign_in / sign_out)。
https://okaro.harukibox.com/mcp查看連接步驟 →本機 MCP server
符合 Model Context Protocol 規範,不需設定環境變數。可掛上 Claude Desktop、Cursor、Claude Code、VS Code、Windsurf、Codex 等支援 MCP 的 client;未登入時可用 sign_in 工具以 Google / Apple 登入。
npx -y @harukibox/okaro-mcp-server查看快速開始 →Okaro CLI
提供 okaro login、okaro tx add、okaro receipt add、okaro summary、okaro fx、okaro export 等指令,每個指令都支援 --json,適合 shell pipeline 與腳本。
npm i -g @harukibox/okaro-cli查看快速開始 →Agent 可用工具一覽
以下為 MCP server 的主要工具。所有工具都以登入的使用者身分執行,遵守與網頁、iOS 相同的驗證與免費版限制,並回傳結構化 JSON。透過 Claude / ChatGPT 連接器使用時工具相同,但不需要 sign_in,收據改用上傳的圖片或圖片網址。
| Tool | Description |
|---|---|
| get_account | 查看登入狀態、方案、結算幣別與用量。 |
| sign_in | 在瀏覽器以 Google / Apple 登入你的 Okaro 帳號(僅本機 MCP server;連接器以 OAuth 連線登入)。 |
| record_receipt | 辨識收據並存成交易,一步完成。 |
| analyze_receipt | 收據圖片 → 結構化 JSON(金額、商家、日期、品項),不存檔。 |
| create_transaction | 建立交易:原幣金額與幣別、結算金額、分類與卡別。 |
| list_transactions | 依日期、商家、分類、卡別、幣別查詢交易。 |
| update_transaction | 修改既有交易的金額、分類、卡別等欄位。 |
| list_cards | 列出使用者的付款卡別,可附上本月支出。 |
| summarize_period | 期間支出總覽:總額、與上期比較、熱門分類/卡別/商家,依結算幣別分開計算。 |
| convert_currency | 依公開每日匯率做參考換算(標示為估算,不用來記帳)。 |
| export_transactions | 匯出 CSV / JSON(Premium 功能)。 |
本機 MCP server:60 秒接上你的 Agent
以 Claude Desktop / Cursor / Claude Code 為例(需要 Node.js 22 以上):
新手完整教學(圖文步驟) →1. 登入你的 Okaro 帳號
選擇 Google、Apple 或 Email + 密碼。Google / Apple 會開啟瀏覽器完成登入。登入資訊存在 ~/.okaro/credentials.json,CLI 與 MCP server 共用;無介面環境可改設 OKARO_EMAIL 與 OKARO_PASSWORD。
npx -y @harukibox/okaro-cli login2. 加入 MCP server 設定
在 Claude Desktop / Cursor 等 client 的 MCP 設定加入以下內容,不需要環境變數。Claude Code 可直接執行 claude mcp add okaro -- npx -y @harukibox/okaro-mcp-server;okaro mcp --client cursor 會印出各 client 的設定片段。
{ "mcpServers": { "okaro": { "command": "npx", "args": ["-y", "@harukibox/okaro-mcp-server"] } } }3. 在對話中喚起
對 Claude / Cursor 說「幫我把這張日本藥妝店收據記到代購卡,實際扣款 2,752 元」,它會呼叫 record_receipt,或先用 analyze_receipt 辨識、再以 create_transaction 存檔。
註冊你的 Agent,登上 Okaro Agent Directory
Okaro Agent Directory 是公開的精選目錄,會推薦給 Okaro 的全體使用者。提交你的 Agent 名稱、用途與使用情境,通過審核即可上架,並獲得分潤。
提交 Agent 申請常見問題
要怎麼在 ChatGPT 使用?+
在 ChatGPT 開啟 Settings → Apps & Connectors → Advanced settings,開啟 Developer mode;回到 Apps & Connectors 點 Create,Name 填 Okaro、MCP Server URL 填 https://okaro.harukibox.com/mcp、Authentication 選 OAuth,勾選 I trust this application 後按 Create,再登入 Okaro 帳號並按「允許」。之後在對話中從「+」或 Developer mode 工具選單選擇 Okaro。需要可開啟開發者模式的 ChatGPT 方案。
要怎麼在 Claude 使用?+
在 claude.ai(網頁版、桌面版或手機 App)開啟 Settings → Connectors,點 Add custom connector,Name 填 Okaro、URL 填 https://okaro.harukibox.com/mcp 後按 Add,再按 Connect 登入 Okaro 帳號並按「允許」。之後在對話的工具選單(Search and tools)開啟 Okaro。自訂連接器需要 Claude Pro、Max、Team 或 Enterprise 方案。
連接器可以看到我哪些資料?要怎麼取消授權?+
只有你自己的 Okaro 資料:連接器以你授權的 Okaro 帳號存取,Supabase RLS 確保看不到其他人的資料,也遵守與 App 相同的免費版限制。隨時可以在 Claude 或 ChatGPT 的連接器設定中中斷連線或移除 Okaro;存取權杖也會自動過期,之後需要重新授權。
使用者要怎麼授權我的 Agent?+
在 Claude 或 ChatGPT 加入 Okaro 連接器時,會開啟 Okaro 的授權頁面,登入後按「允許」即可(OAuth 2.1)。本機版則執行 okaro login(或 MCP 的 sign_in 工具)登入自己的 Okaro 帳號。都不需要 API 金鑰。Agent 以該使用者身分存取,Supabase RLS 確保只看得到他自己的資料;CLI / MCP 寫入的交易會標記來源。執行 okaro logout 即可撤銷 CLI / MCP 的登入,網頁與 iPhone 仍保持登入。
MCP server 與 CLI 是否開源?+
是。@harukibox/okaro-mcp-server 與 @harukibox/okaro-cli 採 MIT License 開源,目前為 Beta。
Okaro 支援 WebMCP 嗎?+
支援。當瀏覽器提供 W3C WebMCP API(document.modelContext / navigator.modelContext,目前在 Chrome 仍屬實驗功能)時,okaro.harukibox.com 會向瀏覽器內的 AI Agent 註冊工具。任何人都能使用 okaro_about、okaro_navigate(開啟網站頁面)與 okaro_agent_setup(各 client 的 MCP / CLI 安裝說明);登入網頁版後,另外可用 get_account、list_transactions、summarize_period、list_categories、list_cards 與 create_transaction。這些工具沿用瀏覽器本身的登入狀態,資料由 RLS 隔離。create_transaction 的外幣交易必須提供實際扣款的結算金額,並標記為重要操作,瀏覽器會在執行前先詢問你。瀏覽器不支援 WebMCP 時,不會有任何作用。
Agent 可以幫使用者上傳收據圖片嗎?+
可以。本機 MCP server 的 analyze_receipt 與 record_receipt 接受本機檔案路徑、圖片 URL 或 base64;透過連接器時則使用在 ChatGPT 上傳的照片(會自動交給工具)或圖片網址。收據會存進使用者自己的 Supabase Storage,並以 RLS 隔離。
有 rate limit 嗎?+
有。收據辨識每位使用者每分鐘 10 次,匯出每分鐘 10 次。免費版限制與網頁、iOS 相同:共 50 筆交易、3 個自訂分類、1 張卡別,匯出為 Premium 功能。
我的 Agent 可以分潤嗎?+
可以。透過 Agent Directory 上架的 Agent,若使用者升級 Premium,原 Agent 開發者可獲得 20% 推薦分潤。