Okaro for Agents
Private Beta

讓你的 AI Agent 直接幫使用者記帳

透過 MCP server、CLI 與 REST API，將 Okaro 的 AI 收據辨識、多幣別記帳與雙重憑證能力嵌入任何 Agent。一次串接，三種介面，覆蓋 ChatGPT、Claude、Cursor、n8n、LangChain、自家 Agent。

加入 Beta 等候名單 閱讀 OpenAPI安裝 MCP server
MCP
Claude · Cursor · Continue
CLI
npm · Homebrew · standalone
OpenAPI 3.1
ChatGPT Actions · Zapier · n8n
Webhooks
tx.created · receipt.parsed
Private Beta

Okaro for Agents 現處於 Private Beta

收據 OCR（/api/analyze-receipt）與 CSV 匯出（/api/export）已 GA、可立即接用；MCP server (@okaro/mcp-server) 與 CLI (@okaro/cli) 將於正式上架 npm 後開放，目前以 waitlist 方式邀請早期 Agent 開發者。OpenAPI 文件已釋出，可先依此設計你的 Agent。

加入 Beta 等候名單 →

為什麼選擇 Okaro 作為 Agent 的記帳後端？

AI 原生收據辨識

Gemini 2.5 辨識金額、商家、日期與品項，Agent 拿到結構化 JSON，不必再自己 OCR。

多幣別與真實匯率

內建即時匯率與「真實刷卡匯率」鎖定，Agent 處理跨境交易時利潤計算不再失真。

使用者授權範圍精準

OAuth 風格的 API key + scopes：使用者可選擇允許 Agent 只讀、寫入特定卡別、或限制金額上限。

雙憑證對帳天然友善

每筆交易自動保留原始收據與付款憑證，Agent 可以代客戶完成報銷、報稅、客戶請款流程。

三種介接面，任選一種或組合使用

MCP server 適合對話式 Agent；CLI 適合 shell / Cursor / Claude Code；REST 適合自家 backend 與 webhook。

MCP Server

Beta · waitlist

符合 Model Context Protocol 規範。直接掛上 Claude Desktop、Cursor、Claude Code、Continue、Cody 等支援 MCP 的 client。

npx -y @okaro/mcp-server
加入 Beta 等候名單 →

Okaro CLI

Beta · waitlist

單一 binary，提供 okaro tx add / okaro receipt analyze / okaro export 指令，適合 shell pipeline 與 CI/CD。

npm i -g @okaro/cli
加入 Beta 等候名單 →

REST / OpenAPI

Stable · 可立即使用

完整 OpenAPI 3.1 描述，支援 ChatGPT Actions、Custom GPT、Zapier、n8n、Make.com、LangChain Tools。

GET /.well-known/openapi.json

Agent 可用工具一覽

所有工具皆遵守使用者授權 scope，並回傳結構化 JSON。

ToolDescription
okaro.create_transaction建立一筆交易，可附帶收據圖片、雙幣別、卡別資訊。
okaro.list_transactions依日期、商家、類別、卡別、幣別查詢交易。
okaro.analyze_receipt收據圖片 → 結構化 JSON（金額、商家、日期、品項）。
okaro.convert_currency即時匯率換算，可指定「實際刷卡匯率」鎖定。
okaro.list_cards列出使用者付款卡與當月支出統計。
okaro.export_csv匯出指定區間 / 客戶的對帳 CSV。
okaro.summarize_period回傳一段期間的支出、利潤、匯差總覽。

60 秒接上你的 Agent

以 Claude Desktop / Cursor 為例：

  1. 1. 取得 API key

    到 Okaro Web 後台 → 設定 → Agent Keys 申請。可選擇 scope 與卡別綁定。

  2. 2. 安裝 MCP server

    在 Claude Desktop 的 mcp.json / Cursor 的 settings.json 加入以下設定：

    {
  "mcpServers": {
    "okaro": {
      "command": "npx",
      "args": ["-y", "@okaro/mcp-server"],
      "env": { "OKARO_API_KEY": "sk_okaro_xxx" }
    }
  }
}

  3. 3. 在對話中喚起

    對 Claude / Cursor 說「幫我把這張日本超商收據記到代購卡」，它會自動呼叫 okaro.analyze_receipt 與 okaro.create_transaction。

註冊你的 Agent，登上 Okaro Agent Directory

Okaro Agent Directory 是公開的精選目錄，會推薦給 Okaro 的全體使用者。提交你的 Agent 名稱、目的、所需 scope，通過審核即可上架，並獲得分潤。

提交 Agent 申請

常見問題

使用者要怎麼授權我的 Agent？+

使用者進入 Okaro Web 後台 → Agent Keys，產生一把限定 scope 的金鑰交給 Agent。所有 Agent 寫入的交易都會標記來源 Agent ID，使用者可隨時撤銷。

MCP server 與 CLI 是否開源？+

是。@okaro/mcp-server 與 @okaro/cli 採 MIT License，原始碼於 GitHub 公開，歡迎送 PR 與 issue。

Agent 可以幫使用者上傳收據圖片嗎？+

可以。okaro.create_transaction 支援以 base64 / signed URL 上傳圖片，會自動存進使用者的 Supabase Storage，並走 RLS 隔離。

有 rate limit 嗎？+

免費 tier 每分鐘 60 次、每日 5,000 次。需要更高額度請聯絡 support@harukibox.com。

我的 Agent 可以分潤嗎？+

可以。透過 Agent Directory 上架的 Agent，若使用者升級 Premium，原 Agent 開發者可獲得 20% 推薦分潤。