跳到主要內容
Okaro for Agents
Beta

在 Claude、ChatGPT 裡直接記帳

把 Okaro 加成 Claude 或 ChatGPT 的連接器,一句話就能記帳、辨識收據、問「這個月花了多少?」。也能用本機 MCP server 與 CLI 接進 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex 等 Agent。用你自己的 Okaro 帳號登入,AI 只看得到你的資料。

Remote MCP
Claude · ChatGPT · Connectors
Local MCP
Claude Desktop · Cursor · Claude Code
CLI
npm · Node.js 22+ · --json
Sign-in
Google · Apple · Email

在 Claude、ChatGPT 直接使用

Beta

不用安裝任何東西:在 Claude 或 ChatGPT 加入 Okaro 連接器(遠端 MCP server),登入 Okaro 帳號並允許存取,就能在對話中記帳。目前為 Beta。

MCP server 網址

https://okaro.harukibox.com/mcp

Claude

claude.ai 網頁版、桌面版與手機 App;自訂連接器需要 Pro、Max、Team 或 Enterprise 方案。

  1. 開啟 Settings(設定)→ Connectors(連接器),點「Add custom connector」。
  2. Name 填 Okaro,URL 填 https://okaro.harukibox.com/mcp,按 Add。
  3. 按 Connect,登入你的 Okaro 帳號,在 Okaro 的授權頁面按「允許」。
  4. 回到對話,從工具選單(Search and tools)開啟 Okaro。

ChatGPT

需要可開啟開發者模式的方案(例如 Plus、Pro、Business)。

  1. 開啟 Settings(設定)→ Apps & Connectors → Advanced settings,開啟 Developer mode(開發者模式)。
  2. 回到 Apps & Connectors,點「Create」。
  3. Name 填 Okaro,MCP Server URL 填 https://okaro.harukibox.com/mcp,Authentication 選 OAuth。
  4. 勾選「I trust this application」,按 Create,登入你的 Okaro 帳號,在 Okaro 的授權頁面按「允許」。
  5. 在對話中,從「+」或 Developer mode 工具選單選擇 Okaro。

連上之後,試試看這樣說

  • 記一筆:今天全聯 368 元
  • (在 ChatGPT 上傳收據照片)幫我記這張收據,實際刷了台幣 2,752
  • 這個月花了多少?跟上個月比?

連接器的工具與本機 MCP server 相同,但不需要 sign_in / sign_out(連線本身就是登入),也不讀取本機檔案:在 ChatGPT 上傳的收據照片會自動交給 Okaro,也可以直接提供圖片網址。只能存取你自己的 Okaro 資料(Supabase RLS 隔離),方案與免費版限制和 App 相同;隨時可在 Claude 或 ChatGPT 的設定中中斷連線以取消授權。

Beta

Claude / ChatGPT 連接器、MCP server 與 CLI 現為 Beta,用你的 Okaro 帳號即可使用

連接器(遠端 MCP server)只要在 Claude 或 ChatGPT 加入網址、登入 Okaro 帳號,不用安裝任何東西。本機 MCP server(@harukibox/okaro-mcp-server)與 CLI(@harukibox/okaro-cli)以 MIT 授權開源,需要 Node.js 22 以上。全部都用你自己的 Okaro 帳號登入,不需要另外申請金鑰。目前仍是 Beta,工具名稱與設定步驟可能還會調整。

為什麼選擇 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 連接器

Beta · 用 Okaro 帳號登入

遠端 MCP server(Streamable HTTP),以 OAuth 2.1 登入你的 Okaro 帳號(支援動態用戶端註冊與 PKCE)。在 Claude 的自訂連接器或 ChatGPT 的開發者模式加入網址即可使用,工具與本機版相同(不含 sign_in / sign_out)。

https://okaro.harukibox.com/mcp
查看連接步驟 →

本機 MCP server

Beta · 用 Okaro 帳號登入

符合 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

Beta · 用 Okaro 帳號登入

提供 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,收據改用上傳的圖片或圖片網址。

ToolDescription
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. 1. 登入你的 Okaro 帳號

    選擇 Google、Apple 或 Email + 密碼。Google / Apple 會開啟瀏覽器完成登入。登入資訊存在 ~/.okaro/credentials.json,CLI 與 MCP server 共用;無介面環境可改設 OKARO_EMAIL 與 OKARO_PASSWORD。

    npx -y @harukibox/okaro-cli login
  2. 2. 加入 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. 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% 推薦分潤。

    Okaro for Agents:在 Claude、ChatGPT 直接記帳 | Okaro