Claude・ChatGPT の中でそのまま家計簿
Okaro を Claude や ChatGPT のコネクタとして追加すれば、ひと言で記帳、レシート解析、「今月いくら使った?」の確認ができます。ローカル MCP サーバーと CLI で Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex などに組み込むことも可能。自分の Okaro アカウントでサインインし、AI が見られるのはあなたのデータだけです。
Claude・ChatGPT の中でそのまま使う
Betaインストール不要。Claude または ChatGPT に Okaro コネクタ(リモート MCP サーバー)を追加し、Okaro アカウントにサインインしてアクセスを許可すれば、チャットの中で記帳できます。現在 Beta です。
MCP サーバー URL
https://okaro.harukibox.com/mcpClaude
claude.ai の Web 版・デスクトップ版・モバイルアプリ。カスタムコネクタには 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 サーバーと同じですが、sign_in / sign_out は不要(接続そのものがサインイン)で、ローカルファイルは読み込みません。ChatGPT でアップロードしたレシート写真は自動で Okaro に渡され、画像 URL を指定することもできます。アクセスできるのはご自身の Okaro データだけ(Supabase RLS で分離)で、プランと無料プランの制限はアプリと同じです。Claude または ChatGPT の設定でいつでも接続を解除してアクセスを取り消せます。
Claude / ChatGPT コネクタ、MCP サーバー、CLI は Beta 版。Okaro アカウントですぐ使えます
コネクタ(リモート MCP サーバー)は Claude または ChatGPT に URL を追加して Okaro にサインインするだけで、インストールは不要です。ローカル MCP サーバー(@harukibox/okaro-mcp-server)と CLI(@harukibox/okaro-cli)は MIT ライセンスのオープンソースで、Node.js 22 以上が必要です。いずれもご自身の Okaro アカウントで使え、別途キーの申請は不要です。現在 Beta のため、ツール名や設定手順は変わる可能性があります。
エージェントが Okaro を選ぶ理由
ネイティブのレシート OCR
Gemini 2.5 が金額・店舗・日付・明細を構造化 JSON で返却。エージェント側で OCR を実装する必要はありません。record_receipt なら解析と保存を一度に行えます。
現地通貨の金額と実際の請求額を別々に記録
取引ごとに元の金額・通貨と、決済通貨での決済額を保存します。海外での支払いは実際に請求された金額か、ユーザーが指定した正確なレートが必要で、Okaro が参考レートから推測することはありません。convert_currency は「概算」と明示した参考換算のみを返します。
自分のアカウントで、RLS により分離
okaro login で Okaro アカウント(Google、Apple、メール)にサインイン。エージェントはあなたとして動作し、Supabase RLS によりあなたのデータしか見られません。okaro logout は CLI / MCP のセッションだけを取り消し、Web と iPhone はサインインしたままです。
二重レシート照合に最適
取引ごとに仕入レシートと支払証憑を保管でき、経費精算・確定申告・顧客請求をエージェントが手伝えます。
3 つの接続面、用途に合わせて選択
インストール不要でチャットの中から記帳するなら Claude / ChatGPT コネクタ。Claude Desktop や Cursor などのデスクトップエージェントにはローカル MCP サーバー。シェル / スクリプト / Claude Code には CLI。Web サイト自体も WebMCP に対応しており、対応ブラウザではブラウザ内の AI エージェントが Okaro のサイトツールを直接使えます。
Claude / ChatGPT コネクタ
リモート MCP サーバー(Streamable HTTP)。Okaro アカウントへの OAuth 2.1 サインイン(動的クライアント登録と PKCE に対応)。Claude のカスタムコネクタまたは ChatGPT の開発者モードのアプリとして URL を追加するだけで使えます。ツールはローカル版と同じです(sign_in / sign_out を除く)。
https://okaro.harukibox.com/mcp接続手順を見る →ローカル MCP サーバー
Model Context Protocol 準拠で、環境変数の設定は不要。Claude Desktop、Cursor、Claude Code、VS Code、Windsurf、Codex などの MCP クライアントで使えます。未サインインの場合は 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 に対応し、シェルパイプやスクリプトに最適。
npm i -g @harukibox/okaro-cliクイックスタートを見る →エージェントが使えるツール一覧
MCP サーバーの主なツールです。すべてサインイン中のユーザーとして実行され、Web・iOS と同じ検証と無料プランの制限に従い、構造化 JSON を返します。Claude / ChatGPT コネクタ経由でもツールは同じですが、sign_in は不要で、レシートはアップロードした画像または画像 URL から読み取ります。
| Tool | Description |
|---|---|
| get_account | サインイン状態、プラン、決済通貨、利用状況を確認。 |
| sign_in | ブラウザで Google / Apple から Okaro アカウントにサインイン(ローカル MCP サーバーのみ。コネクタは OAuth で接続時にサインイン)。 |
| record_receipt | レシートを解析して取引として保存(ワンステップ)。 |
| analyze_receipt | レシート画像 → 構造化 JSON(金額・店舗・日付・明細)。保存はしません。 |
| create_transaction | 取引を作成:元の金額と通貨、決済額、カテゴリ、カード。 |
| list_transactions | 日付、店舗、カテゴリ、カード、通貨で取引を検索。 |
| update_transaction | 既存取引の金額・カテゴリ・カードなどを編集。 |
| list_cards | ユーザーの支払カード一覧(当月の支出も取得可)。 |
| summarize_period | 期間の合計、前期比、上位カテゴリ/カード/店舗を決済通貨ごとに集計。 |
| convert_currency | 公開日次レートによる参考換算(概算として表示、記帳には使いません)。 |
| export_transactions | CSV / JSON をエクスポート(Premium)。 |
ローカル MCP サーバー:60 秒で接続
Claude Desktop / Cursor / Claude Code の例(Node.js 22 以上が必要):
初心者向けステップバイステップガイド(中国語) →1. Okaro アカウントでサインイン
Google、Apple、メール + パスワードから選択。Google / Apple はブラウザでサインインします。認証情報は ~/.okaro/credentials.json に保存され、CLI と MCP サーバーで共有されます。ヘッドレス環境では OKARO_EMAIL と OKARO_PASSWORD を設定してください。
npx -y @harukibox/okaro-cli login2. MCP サーバーを追加
Claude Desktop / Cursor などの MCP 設定に以下を追加します。環境変数は不要です。Claude Code では claude mcp add okaro -- npx -y @harukibox/okaro-mcp-server を実行。okaro mcp --client cursor で各クライアント用の設定を出力できます。
{ "mcpServers": { "okaro": { "command": "npx", "args": ["-y", "@harukibox/okaro-mcp-server"] } } }3. チャットから呼び出す
「このドン・キホーテのレシートを代理購入カードに記帳して。請求額は 2,752 だった」と話しかけると、record_receipt、または analyze_receipt → create_transaction が呼び出されます。
Okaro Agent Directory にあなたのエージェントを登録
Okaro Agent Directory は Okaro ユーザー全員に表示される厳選ディレクトリ。エージェント名・用途・利用シーンを提出して審査通過すれば掲載され、紹介収益も得られます。
エージェントを申請よくある質問
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(Web 版・デスクトップ版・モバイルアプリ)で 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 により他の人のデータにはアクセスできません。無料プランの制限もアプリと同じです。Claude または ChatGPT のコネクタ設定でいつでも接続を解除または Okaro を削除できます。アクセストークンも自動で期限切れになり、その後は再度許可が必要です。
ユーザーはどうやって私のエージェントを承認しますか?+
Claude や ChatGPT で Okaro コネクタを追加すると Okaro の許可画面が開くので、サインインして「許可」をクリックするだけです(OAuth 2.1)。ローカル版では okaro login(または MCP の sign_in ツール)で自分の Okaro アカウントにサインインします。どちらも API キーは不要です。エージェントはそのユーザーとして動作し、Supabase RLS によりそのユーザーのデータだけにアクセスします。CLI / MCP から書き込んだ取引には送信元が記録されます。okaro logout で CLI / MCP のセッションを取り消せ、Web と iPhone はサインインしたままです。
MCP サーバーと CLI はオープンソースですか?+
はい。@harukibox/okaro-mcp-server と @harukibox/okaro-cli は MIT ライセンスのオープンソースで、現在 Beta です。
Okaro は WebMCP に対応していますか?+
はい。ブラウザが W3C WebMCP API(document.modelContext / navigator.modelContext、現在 Chrome では実験的機能)を提供している場合、okaro.harukibox.com はブラウザ内の AI エージェント向けにツールを登録します。okaro_about、okaro_navigate(サイトのページを開く)、okaro_agent_setup(クライアントごとの MCP / CLI セットアップ手順)は誰でも使えます。Web アプリにサインインすると、get_account、list_transactions、summarize_period、list_categories、list_cards、create_transaction も使えるようになります。ツールはブラウザ自身のログインセッションで動作し、データは RLS で分離されます。外貨での支払いでは、create_transaction に実際に請求された決済額が必要です。また重要な操作として扱われるため、実行前にブラウザが確認を求めます。WebMCP 非対応のブラウザでは何も起こりません。
エージェントはレシート画像をアップロードできますか?+
はい。ローカル MCP サーバーの analyze_receipt と record_receipt はローカルのファイルパス、画像 URL、base64 を受け付けます。コネクタ経由では ChatGPT でアップロードした写真(自動でツールに渡されます)または画像 URL を使います。レシートはユーザー自身の Supabase ストレージに RLS 隔離で保管されます。
レート制限はありますか?+
はい。レシート解析はユーザーごとに毎分 10 リクエスト、エクスポートは毎分 10 リクエストまでです。無料プランの制限は Web・iOS と同じで、取引は合計 50 件、カスタムカテゴリ 3 個、カード 1 枚、エクスポートは Premium 限定です。
エージェントは収益化できますか?+
はい。ディレクトリ掲載エージェントは、紹介ユーザーが Premium にアップグレードすると 20% の継続レベニューシェアを獲得します。