メインコンテンツへスキップ
Okaro for Agents
Beta

Claude・ChatGPT の中でそのまま家計簿

Okaro を Claude や ChatGPT のコネクタとして追加すれば、ひと言で記帳、レシート解析、「今月いくら使った?」の確認ができます。ローカル MCP サーバーと CLI で Claude Desktop、Claude Code、Cursor、VS Code、Windsurf、Codex などに組み込むことも可能。自分の 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 サーバー)を追加し、Okaro アカウントにサインインしてアクセスを許可すれば、チャットの中で記帳できます。現在 Beta です。

MCP サーバー URL

https://okaro.harukibox.com/mcp

Claude

claude.ai の Web 版・デスクトップ版・モバイルアプリ。カスタムコネクタには 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 サーバーと同じですが、sign_in / sign_out は不要(接続そのものがサインイン)で、ローカルファイルは読み込みません。ChatGPT でアップロードしたレシート写真は自動で Okaro に渡され、画像 URL を指定することもできます。アクセスできるのはご自身の Okaro データだけ(Supabase RLS で分離)で、プランと無料プランの制限はアプリと同じです。Claude または ChatGPT の設定でいつでも接続を解除してアクセスを取り消せます。

Beta

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 コネクタ

Beta · Okaro アカウントでサインイン

リモート MCP サーバー(Streamable HTTP)。Okaro アカウントへの OAuth 2.1 サインイン(動的クライアント登録と PKCE に対応)。Claude のカスタムコネクタまたは ChatGPT の開発者モードのアプリとして URL を追加するだけで使えます。ツールはローカル版と同じです(sign_in / sign_out を除く)。

https://okaro.harukibox.com/mcp
接続手順を見る →

ローカル MCP サーバー

Beta · Okaro アカウントでサインイン

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

Beta · Okaro アカウントでサインイン

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 から読み取ります。

ToolDescription
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_transactionsCSV / JSON をエクスポート(Premium)。

ローカル MCP サーバー:60 秒で接続

Claude Desktop / Cursor / Claude Code の例(Node.js 22 以上が必要):

初心者向けステップバイステップガイド(中国語) →
  1. 1. Okaro アカウントでサインイン

    Google、Apple、メール + パスワードから選択。Google / Apple はブラウザでサインインします。認証情報は ~/.okaro/credentials.json に保存され、CLI と MCP サーバーで共有されます。ヘッドレス環境では OKARO_EMAIL と OKARO_PASSWORD を設定してください。

    npx -y @harukibox/okaro-cli login
  2. 2. 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. 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% の継続レベニューシェアを獲得します。

    Okaro for Agents — Claude・ChatGPT の中でそのまま家計簿 | Okaro