在 ChatGPT、Claude 直接記帳：Okaro 連接器與 MCP 新手教學

這篇是給完全沒用過 MCP 的人看的。做完之後，你可以在 ChatGPT 或 Claude 裡直接說：

「幫我把這張唐吉訶德的收據記到代購卡，實際刷了台幣 2,752 元。」

AI 會自己讀收據、填好商家、日期、金額、類別，存進你的 Okaro 帳本，和你在 iPhone 或網頁上看到的是同一份資料。

不需要寫程式，也不需要申請 API key。 最簡單的方法連安裝都不用，5 分鐘就能完成。

先搞懂：連接器、MCP、CLI 是什麼？

• MCP（Model Context Protocol）：讓 AI 助理可以「動手」使用外部工具的標準。Okaro 的 MCP server 就是一組給 AI 用的記帳工具（新增交易、辨識收據、查統計……）。
• 連接器（遠端 MCP server）：Okaro 架在網路上的 MCP server，網址是 https://okaro.harukibox.com/mcp。在 ChatGPT 或 Claude 加入這個網址、登入 Okaro 帳號就能用，不用安裝任何東西。
• 本機版 MCP server：裝在你自己電腦上，給 Claude Desktop、Claude Code、Cursor 這類桌面 AI 工具用，需要 Node.js。
• CLI（命令列工具）：在「終端機」裡打指令使用 Okaro，例如 okaro tx list。

全部都是免費使用，目前是 Beta 版。

方法一：在 ChatGPT 或 Claude 直接連接（不用安裝任何東西）

你只需要一個 Okaro 帳號（免費註冊：okaro.harukibox.com，或用 iPhone App 的同一個帳號），以及下面這個網址：

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 帳號後，在授權頁面（詢問是否允許 Claude 存取你的 Okaro 帳號）按 允許。
4. 回到對話，從輸入框下方的工具選單（Search and tools）把 Okaro 打開。

在 ChatGPT 使用

需要可以開啟**開發者模式（Developer mode）**的方案，例如 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 帳號，在授權頁面按 允許。
5. 在對話中，從輸入框的 「+」 或 Developer mode 工具選單選擇 Okaro。

連上之後，試試看這樣說

• 「記一筆：今天全聯 368 元」
• 上傳一張收據照片，再說：「幫我記這張收據，實際刷了台幣 2,752」
• 「這個月花了多少？跟上個月比？」

小技巧：收據直接拍照上傳就好。 在 ChatGPT 上傳的收據照片會自動交給 Okaro 辨識並一起存檔，不用給檔案路徑。也可以貼一個圖片網址。刷卡通知的截圖一起上傳，AI 會把實際扣款金額一起填好。

連接器的工具和本機版一樣，只是不需要另外「登入 / 登出」，因為連線本身就是用你的 Okaro 帳號登入。它只看得到你自己的 Okaro 資料；想取消授權，隨時到 Claude 或 ChatGPT 的連接器設定中斷連線或移除 Okaro 即可。

方法二：Claude Desktop / Cursor 本機版

如果你用的是 Claude Desktop、Claude Code、Cursor 這類桌面 AI 工具，可以把 Okaro 的 MCP server 裝在自己的電腦上。整個設定大約 10 分鐘。

開始前需要準備什麼？

怎麼確認 Node.js 裝好了？打開終端機（Mac：「終端機」App；Windows：開始選單搜尋「PowerShell」），輸入 node -v，看到 v22 或更大的數字就對了。

步驟 1：登入 Okaro（只要做一次）

在終端機輸入：

npx -y @harukibox/okaro-cli login

畫面會讓你選登入方式：

Sign in to Okaro
  1) Google
  2) Apple
  3) Email + password
Choose [1-3]:

• 你平常用 Google 或 Apple 登入 Okaro → 選 1 或 2，瀏覽器會自動打開，登入完看到「Signed in to Okaro」就可以關掉。
• 你是用 Email + 密碼 註冊的 → 選 3，輸入 Email 和密碼（輸入密碼時畫面不會顯示，是正常的）。

看到這行就成功了：

✓ Signed in as you@example.com (google)

想確認的話，輸入 npx -y @harukibox/okaro-cli whoami，會顯示你的方案、結算幣別和已使用的額度。

登入資料只存在你自己電腦的 ~/.okaro/credentials.json，只有你的帳號看得到你的資料。不想用了，輸入 npx -y @harukibox/okaro-cli logout 就會撤銷，不會登出你的手機或網頁。

步驟 2：把 Okaro 加進你的 AI 工具

挑你用的那一個照做就好。

Claude Desktop

1. 打開 Claude Desktop → 左上角選單 Settings（設定） → Developer → Edit Config。
2. 會打開一個叫 claude_desktop_config.json 的檔案，把內容改成（如果裡面已經有其他 mcpServers，把 "okaro" 那段加進去即可）：

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

3. 存檔，完全結束 Claude Desktop 再重新打開。對話框下方出現工具圖示、裡面有 okaro，就完成了。

Claude Code

在終端機輸入一行：

claude mcp add okaro -- npx -y @harukibox/okaro-mcp-server

Cursor

打開 Cursor Settings，找到 MCP 相關的分頁（依版本叫「MCP」或「Tools & MCP」），選擇新增 MCP server，貼上和 Claude Desktop 一樣的設定。也可以直接編輯 ~/.cursor/mcp.json。

VS Code、Windsurf、Codex

在終端機輸入下面這行，它會直接印出該工具要貼的設定和檔案位置：

npx -y @harukibox/okaro-cli mcp --client vscode

把 vscode 換成 windsurf 或 codex 即可。

步驟 3：直接跟 AI 說要記什麼

設定好之後，用平常說話的方式就可以了。幾個實用的例子：

• 記一張收據：「幫我記這張收據 /Users/me/Downloads/lawson.jpg」
• 收據加刷卡通知一起辨識：「這兩張是同一筆：訂單截圖和刷卡通知，幫我記到代購卡」
• 手動記帳：「記一筆：今天全聯 368 元，類別生活用品」
• 查帳：「這個月我在日本花了多少？跟上個月比呢？」
• 找交易：「列出 10 月所有唐吉訶德的消費」
• 整理：「把上週沒有分類的交易都改成交通」

AI 在新增、修改、刪除之前會先跟你確認內容，你說「好」它才會存。

本機版的收據要給 AI 檔案路徑（或圖片網址），Okaro 才讀得到原圖並一起存檔。取得路徑最簡單的方法：Mac 在 Finder 對檔案按右鍵、按住 Option，選「拷貝為路徑名稱」；Windows 在檔案總管按住 Shift 再按右鍵，選「複製路徑」。

外幣消費一定要知道的一件事

Okaro 每筆交易都會記兩個金額：

1. 原幣金額：收據上寫的，例如 JPY 12,800
2. 實際扣款金額：你的卡實際被扣多少台幣，例如 TWD 2,752

第二個金額一定要是刷卡通知或帳單上的真實數字。Okaro 不會用參考匯率自己猜，因為銀行匯率加上海外手續費，常常和查到的匯率差 1–3%，猜錯整本帳就不準了。

所以如果 AI 問你「實際扣了多少台幣？」，是正常的。最省事的做法：把刷卡通知的截圖和收據一起丟給 AI，它會兩張一起讀，自動填好。

方法三：不想用 AI，可以直接用指令記帳嗎？（CLI）

可以。先安裝 CLI：

npm i -g @harukibox/okaro-cli

之後就能直接用 okaro 指令：

okaro tx add -m "7-Eleven" -a 85 --category 餐飲
okaro tx add -m "Don Quijote" -a 12800 -c JPY -S 2752 --card "代購卡"
okaro receipt add 收據.jpg 刷卡通知.png
okaro tx list
okaro summary -p this_month

每個指令加 --help 都會列出所有選項。

用 Chrome 的瀏覽器 AI 也可以嗎？（WebMCP）

可以。Okaro 網站支援還在實驗階段的 WebMCP 標準：當你的瀏覽器有內建 AI 助理並支援 WebMCP 時，它可以直接使用 Okaro 網站提供的工具，例如查詢產品資訊、開啟頁面；登入網頁版之後，還能查交易、看統計、幫你新增交易。不支援的瀏覽器則一切照舊，不會有任何影響。

常見問題

需要 API key 嗎？

不需要。用你自己的 Okaro 帳號登入一次就好，AI 只能看到和修改你自己的資料。

需要付費的 ChatGPT / Claude 方案嗎？

用連接器（方法一）的話需要：Claude 的自訂連接器需要 Pro、Max、Team 或 Enterprise 方案；ChatGPT 需要可以開啟開發者模式的方案（例如 Plus、Pro、Business）。本機版（方法二）則看你用的 AI 工具本身的方案，Okaro 這邊不另外收費。

連接器看得到我哪些資料？怎麼取消授權？

只看得到你自己的 Okaro 帳本，看不到其他人的資料。隨時可以在 Claude 或 ChatGPT 的連接器設定中斷連線或移除 Okaro；授權也會定期過期，之後需要重新登入允許。

免費版可以用嗎？

可以，限制和 App 一樣：最多 50 筆交易、3 個類別、1 張卡，匯出 CSV 需要 Premium（在 iPhone App 內升級）。

會不會被 AI 亂改資料？

AI 在新增、修改、刪除前會先跟你確認；大部分 AI 工具也會在執行每個動作前跳出「允許嗎？」的視窗。另外，外幣交易沒有實際扣款金額時，Okaro 會直接拒絕存檔。

出現「Not signed in to Okaro」怎麼辦？

本機版：代表還沒登入或登入已過期，回到終端機重新執行 npx -y @harukibox/okaro-cli login，然後重開 AI 工具。連接器：到 Claude 或 ChatGPT 的連接器設定重新連線（Connect）並登入 Okaro。

出現「requires Node.js 22」怎麼辦？

你的 Node.js 版本太舊，到 nodejs.org 下載最新 LTS 版安裝後再試一次。

Claude Desktop 看不到 okaro 工具？

1. 確認設定檔是正確的 JSON（逗號、括號都要成對）
2. 完全結束 Claude Desktop（Mac 要用 ⌘Q，不是只關視窗）再打開
3. 在終端機執行 npx -y @harukibox/okaro-mcp-server --version，有顯示版本號代表可以正常下載

一次可以辨識幾張收據？

每筆交易最多 2 張（例如訂單截圖 + 刷卡通知）。AI 辨識每分鐘最多 10 次。

---

更多技術細節（全部工具清單、環境變數、自動化用法）請看 Okaro for Agents 開發者頁面。遇到問題歡迎寄信到 support@harukibox.com。