始める前に
最初にバックエンドとアプリのバージョンを確認。
対象は国際版 iOS の共通バックエンドです。app.squirrelly.ai はサービスのドメインと API として存続します。Web ソフトや Web ログインは不要です。他のバックエンドでは同じメールでも別アカウントの場合があります。
| アカウントのバージョン | 現在の状態 |
|---|---|
| 国際版 iOS 共通バックエンド | 接続テスト · 新版アプリが必要 |
| 必要なネイティブアプリ機能 | 「設定 → エージェント接続」。新しいビルドが必要で、現在インストール済みや App Store の版に搭載済みとは限りません。 |
| 国際版 Android Play の独立アカウント | 未対応 |
| 中国版、HarmonyOS などの独立アカウント | 未対応 |
対象は国際版 iOS 共通バックエンドのみです。独立した国際版 Android Play、中国版、HarmonyOS のバックエンドは未対応です。「エージェント接続」がなければ更新するか対応版をお待ちください。代わりの Web アカウントを作らないでください。
ステップ 01
アプリでグローバルアカウント番号をコピー
- ネイティブアプリの「設定 → エージェント接続」を開く。
アプリにログイン済みの既存アカウントを使用します。アプリを開くための案内 ↗はアプリの開き方の案内のみです。Web ログインや Web 上のアカウント管理は行いません。
- 対応するアプリのバージョンを確認。
「エージェント接続」を搭載した新しいネイティブアプリが必要です。項目がなければ更新するか公開をお待ちください。現在インストール済みや App Store の版が対応済みとは限りません。
- 「エージェント接続」でグローバルアカウント番号をコピー。
番号は
ZXM-で始まります。同じバックエンドアカウントの番号は変わりません。ブラウザーの承認リクエストに入力して対象バックエンドを識別します。
アカウント番号は正しいアカウントを特定するためのもので、パスワードではありません。一致するアカウントでログインしたネイティブアプリで明示的に承認して初めてアクセスできます。
アプリを開くための案内を見る ↗ステップ 02 · ChatGPT
ChatGPT に Squirrelly を追加する
以下はカスタム MCP のテスト接続手順です。プラグインストアからのワンクリックインストールではありません。利用できるかどうかは、ChatGPT アカウントとワークスペースのポリシーに依存します。
- ChatGPT の Plugins ページを開きます。
「ChatGPT Plugins ↗」へ移動し、プラスボタンから Add custom MCP server（カスタム MCP サーバーを追加）を選択します。項目がない場合は、下のよくある質問をご覧ください。
- 接続情報を入力します。
名前は「squirrellyai」とし、公開 HTTPS エンドポイントを選びます。末尾の次の部分を含め、URL 全体を貼り付けます：
/mcp。
ChatGPT の入力設定（OAuth 詳細設定を含む）
| 設定 | 正しい値 |
|---|---|
| 名前 | squirrellyai |
| サーバー URL | https://mcp.squirrelly.ai/mcp |
| 認証方式 | OAuth |
| 登録方法 | カスタム OAuth クライアント |
| OAuth クライアント ID | squirrelly-chatgpt |
| クライアントシークレット | 空欄 |
| Token エンドポイントの認証方法 | none |
| 登録 URL | 空欄 |
| OIDC を有効にする | チェックしない |
「OAuth 詳細設定」を展開し、上の表に従って各項目を入力します。クライアント ID は squirrelly-chatgpt です。プラグイン名やアカウント番号で代用しないでください。
DCR、CIMD が利用不可という表示は、サーバーがこの 2 種類の自動登録を提供していないことを示します。「カスタム OAuth クライアント」を選び、表どおり入力してください。登録 URL の入力や OIDC の有効化は不要です。
デフォルトの要求スコープは account:read、books:read、transactions:read、transactions:create、summaries:read の 5 つを維持し、基本認可スコープは空欄にします。
- 作成を完了してプラグインをインストールまたは有効化し、アカウントを接続します。
ChatGPT の案内で個人用プラグインを作成し、インストールまたは有効化して「アカウントを接続」を選びます。作成しただけではアクセス権は付与されません。アプリ内で承認してください。アカウント、帳簿、収支作成、明細検索、集計、書き込み結果の 6 ツールは承認後に呼び出しをテストします。
- OAuth を開始し、次のセクションに従って認可します。
OAuth で Squirrelly のリクエスト画面が開いたら、アプリでコピーした番号を入力します。そのブラウザーを開いたまま、アプリで承認してください。
- 新しいチャットを開き、接続を有効にします。
ChatGPT の現在の画面に従って、作成した Squirrelly プラグインを有効にします。対応する画面では
@を入力して選択できます。その後、下記の読み取り専用チェックを行ってください。
ChatGPT の個人用プラグインに squirrellyai があれば作成は成功しています。そのプラグインをインストールまたは有効化し、Squirrelly アカウントを接続してアプリ内承認を完了してからツールをテストしてください。再作成は不要です。
詳細：OAuth エンドポイントとリダイレクト URI の確認
このクライアントに現在登録されているリダイレクト URI は、以下の1つだけです。完全一致する必要があります。
https://chatgpt.com/connector_platform_oauth_redirectホストに接続固有の URL など別のリダイレクト URI が表示されたら、管理者がその正確な URI を登録する必要があります。ワイルドカードやドメインの置き換えは使わないでください。他のエージェントは個別登録が必要で、この ChatGPT クライアントは流用できません。DCR と汎用 CIMD 登録は提供していません。
自動検出された OAuth エンドポイントの確認
| 設定 | 正しい値 |
|---|---|
| 認可 URL | https://mcp.squirrelly.ai/oauth/authorize |
| Token URL | https://mcp.squirrelly.ai/oauth/token |
| 認可サーバーのベース URL | https://mcp.squirrelly.ai |
| リソース | https://mcp.squirrelly.ai/mcp |
公式 MCP SDK クライアントで実サービスを検証済みですが、実際の ChatGPT アカウントでの最終ツール呼び出しは未検証です。個人用プラグインの作成成功は、アカウント承認やツール呼び出しの完了、ストア掲載、OpenAI の審査通過を意味しません。
手順の参考資料：OpenAI 公式接続ガイド · OAuth 認証の説明。確認日：2026-10-30。
記帳ショートカットスキル
1 コマンドで squirrelly 記帳スキルをインストール
お使いの OS とクライアントに合うコマンドで squirrelly を自動ダウンロード・インストールします。MCP 接続とアプリ内の OAuth 承認は別途必要です。完了後はスキルのショートカットで記帳できます。
自動ダウンロード・インストール
対応するコマンドをパソコンのターミナルに貼り付けるか、ローカルコマンドを実行できるエージェントに渡してください。自動でダウンロード・検証・インストールされるため、手動での展開は不要です。
macOS
macOS：「ターミナル」で実行します。システム標準のツールを使用し、Python や Homebrew の追加インストールは不要です。使用中のクライアントに合うコマンドを選んでください。
/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client codex/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client claude-codeWindows
Windows：PowerShell で実行します。Windows PowerShell 5.1 と PowerShell 7 に対応しています。使用中のクライアントに合うコマンドを選んでください。
& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client codex& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client claude-codeインストーラーは SHA-256 を検証し、スキルファイルのみを配置します。異なる既存内容は標準では上書きしません。更新する場合は macOS で --update、Windows で -Update を追加してください。先に既存ファイルがバックアップされます。
インストール後はクライアントを再読み込みするか、新しいセッションを開始してください。Codex は $squirrelly、Claude Code は /squirrelly を使います。スキルのインストールでは MCP 設定や OAuth は完了しません。別途サービスに接続し、アプリで承認してください。
Web ページからローカルスキルを無操作でインストールすることはできません。ChatGPT の Web 版はプラグイン接続を使います。上記コマンドはローカル実行権限のあるクライアント向けです。
ZIP を手動ダウンロード（代替手段）
ローカルコマンドに非対応のクライアントでは、対応していれば下記 ZIP インポートを利用してください。利用可否はクライアントによって異なります。
- 手動でスキル ZIP をダウンロード（代替手段）。
squirrelly スキルの ZIP をダウンロードし、手動で展開して INSTALL.md を確認してください。パッケージにはスキルファイルが含まれ、アカウントのパスワードやトークンは含まれません。
- クライアントの手順に従ってインストールします。
Codex では squirrelly フォルダーを個人用スキルディレクトリに配置し、新しいセッションで
$squirrellyを使用できます。該当するスキルディレクトリに対応するクライアントでは、それぞれの説明に従って/squirrellyを登録できます。コマンド名はクライアントが管理し、MCP が自動で追加するものではありません。
先に MCP を接続し、OAuth 認可を完了します。 スキルはエージェントのツール利用を案内するだけで、アカウントのアクセス権は付与しません。未接続の状態では記帳しません。日付、通貨、帳簿が不明な場合も、勝手に書き込みません。
/squirrelly 今日、服を1点買い、2000人民元（CNY）支払いました。
現在の ChatGPT では @ でプラグインを選択できます。すべてのクライアントでスラッシュコマンドが使えるわけではありません。パッケージのインストール説明に従って、対応する呼び出し方法を選んでください。
ステップ 02 · ほかのエージェント
同じサービスに別のエージェントを接続する
利用するクライアントに合わせて手順を選ぶ
| 利用環境 | 手順 |
|---|---|
| ChatGPT ウェブ版 | 上の ChatGPT 設定表に従ってプラグインを作成または有効化し、アカウントを接続して App で承認してください。ローカルスキルのインストールは不要です。 |
| Codex | 下の macOS または Windows コマンドでスキルをインストールし、MCP を別途設定して App で承認します。クライアントを再読み込みして $squirrelly を使ってください。 |
| Claude Code | 下の macOS または Windows コマンドでスキルをインストールし、MCP を別途設定して App で承認します。クライアントを再読み込みして /squirrelly を使ってください。 |
ホストには、リモート MCP Streamable HTTP と OAuth 認可コード / PKCEへの対応が必要です。設定場所や対応範囲は製品ごとに異なるため、ChatGPT の画面操作をそのまま当てはめないでください。
- ホストのリモート MCP またはツールサーバー設定を探します。
エンドポイントに
https://mcp.squirrelly.ai/mcpを入力し、認証は OAuth を選択します。 - そのエージェント専用の OAuth クライアントを登録します。
管理者がアプリ名、専用のクライアント ID、ホストが提示する正確なリダイレクト URI を登録する必要があります。
squirrelly-chatgptは登録済みの ChatGPT リダイレクト専用です。ほかの製品では流用できません。 - ネイティブアプリでアクセスを承認。
クライアント登録後は、下記と同じアプリ内承認を行います。元のブラウザーを開いたまま OAuth を完了してください。ローカル stdio、固定 API キーのみ、または OAuth 非対応のホストは直接接続できません。
開発者は HTTP API を使って独自のエージェントを連携することもできます。プロトコル対応は接続手段があることを示すもので、すべての製品で互換性を実証済みという意味ではありません。
ステップ 04
接続を確認してから最初の記帳をする
以下の順に確認することをおすすめします。コピーボタンはテキストをコピーするだけで、リクエストの送信や記帳は自動実行しません。
Squirrelly で、現在認可されているアカウントと帳簿を確認してください。まだ記帳はしないでください。
返されたアカウント番号と帳簿が、アプリの現在のアカウントとその唯一の帳簿に一致するか確認します。正しければ、実際に記録したい収入や支出を送信してください。
Squirrelly で記帳してください。今日の昼食に35人民元（CNY）使いました。現在認可されている帳簿に記録してください。
サービスが記帳成功を明示的に確認した場合にのみ、記帳完了となります。その後、元の Squirrelly アカウントで該当する帳簿を開き、金額、日付、通貨を確認してください。
接続したら
毎日の記帳や確認をチャットで
Squirrelly で記録してください。今日、給与8000人民元（CNY）を受け取りました。
Squirrelly で今週の支出明細を検索し、最新の20件を先に表示してください。
Squirrelly で今月の収入、支出、差引残高を集計してください。通貨ごとに分けて表示してください。
金額、通貨、日付を明確にし、現在認可されている帳簿を使用してください。初回リリースではエージェントによる既存明細の編集・削除、振替、貸借、一括インポートはサポートしていません。
エージェントが結果不明と伝えた場合は、元の操作結果を確認するか、元のリクエスト ID で再試行するよう依頼してください。同じ記録を新しい ID で繰り返し作成しないでください。バックエンドは重複排除記録を使い、通信の再試行による二重記帳を防ぎます。
いつでも自分で管理
アクセスを解除する、アカウントを変える
- ネイティブアプリの「設定 → エージェント接続」を開く。
アプリで承認済みクライアントを選び、帳簿と権限を確認します。
- アプリでそのクライアントのアクセスを取り消す。
そのアプリは以後アクセスできなくなります。記帳済みのデータは残り、元のアプリのログインやほかの認可も引き続き有効です。アプリからログアウトするだけでは、エージェントの認可は取り消されません。
- アカウントを変える場合は、接続と認可をやり直します。
再接続前にネイティブアプリで対象アカウントにログインし、申請と権限を確認してください。そのアカウントの唯一の帳簿が自動的に使用されます。再承認しても既存の記録の移動やバックエンド間のアカウント統合は行いません。
困ったときは
よくある質問と接続トラブルの対処
インストール後も記帳できないのはなぜですか？
インストール成功はスキルファイルの配置のみを意味します。このクライアント専用の OAuth クライアントと正確なコールバックを登録し、MCP に接続したうえで、アプリでアカウント、クライアント、権限を確認して明示的に承認してください。唯一の帳簿は自動的に使用されます。スマートフォンで承認後も元のブラウザーを開いたまま OAuth を完了してください。再読み込み後、まず認可されたアカウントと帳簿を照会し、一致を確認してから実際の収支を記録してください。
アカウント番号入力後にエラーページが出たら？
既存の squirrellyai プラグインに戻り、「アカウントを接続」をやり直します。新しく開いた承認ページに番号を入力し、古いエラーページの更新だけで済ませないでください。今回の Web 修正のためにスマートフォンのアプリを再インストールする必要はありません。再び失敗したら表示されたエラーコードを保存してください。
ChatGPT に「Add custom MCP server」がありません
利用可否は ChatGPT のアカウント、組織、ワークスペースのポリシーによって異なります。まず最新の公式説明を確認してください。企業やチームのワークスペースでは、カスタム接続が許可されているか管理者に確認できます。サービスの URL にアクセスできても、ホスト側でこの機能が使えるとは限りません。
URL を開くと 401 になります。故障ですか？
ブラウザーで /mcp に未承認で直接アクセスすると通常 401 が返ります。これはエージェント用で、ログイン画面ではありません。アプリの「設定 → エージェント接続」で番号をコピーし、エージェントから OAuth を開始してアプリで承認してください。
invalid_client やリダイレクト URI 不一致が表示されます
対象アプリのクライアント ID を入力し、登録済みの URI と完全一致しているか確認してください。ChatGPT の事前登録済み ID は squirrelly-chatgpt です。ほかの製品には個別の登録が必要です。ホスト固有のリダイレクト URI が登録済み URI と異なる場合は、管理者が設定を更新する必要があります。アカウントを何度も切り替えたり、認証を無効にしたりしないでください。
「エージェント接続」がない、アカウントが違う、ブラウザーが待機中？
「設定 → エージェント接続」がある新しいアプリが必要です。なければ更新するか公開をお待ちください。アプリで既存アカウントとバックエンドを確認します。スマートフォンで承認する間も元のブラウザーを開いておき、そこで OAuth を完了します。拒否・期限切れなら新しいリクエストを開始してください。Web アカウントの作成や Web パスワード入力は不要です。
接続できますが、収支を新規作成できません
付与した権限に収入・支出の新規作成が含まれるか、帳簿に引き続きアクセスできるか確認してください。また、通常の収入・支出であり、金額、通貨、日付が揃っているか確認します。必要であれば再接続し、必要な権限を明示的に付与してください。
エージェントは成功と言いましたが、アプリに記録がありません
まずバージョン、アカウント、帳簿が同じか、日付と通貨の絞り込み条件が正しいか確認してください。エージェントに元の操作結果を照会させます。サービスが committed（確定済み）を返した場合のみ成功です。結果不明の場合、新しい ID で再度書き込まないでください。
接続解除で記録は消えますか？重複排除記録とは何ですか？
接続解除はアプリのアクセス権を取り消すだけで、記帳データは削除しません。重複排除記録は、どのリクエストがどの記録として保存されたかを保持し、二重記帳を防ぎます。通常の利用、ログアウト、認可の取り消しでは消去されません。アカウント全体を削除するときに限り、関連する操作記録も個人データとともに削除されます。
スマートフォンやサーバーを変更するとどうなりますか？
同じバックエンドアカウントの番号は変わりません。別のバックエンドの独立アカウントにはそれぞれ別の番号があり、現在はバージョン間で自動統合されません。サーバー移行時はプラットフォームがアカウントの対応関係を維持する必要があり、メールアドレスが同じというだけで自動連携はできません。
リクエスト期限切れ、権限取り消し、一時的な停止？
期限切れや拒否では権限は付与されません。OAuth を再開し、新しいリクエストをアプリで承認してください。取り消し後は再接続が必要です。一時的な障害なら後で再試行します。元のブラウザーを開いたままにし、パスワード・認証コード・トークンをチャットに送信したり HTTPS 検証を無効にしたりしないでください。
開発者の方へ
独自のエージェントに記帳機能を追加する
専用の OAuth クライアントと正確なリダイレクト URI を登録します。ブラウザーの account_code でバックエンドを識別し、ネイティブアプリで同意した後、元のブラウザーで認可コード / PKCE S256 を完了して MCP や HTTP API を呼び出します。匿名動的登録、共有トークン、番号だけでのアクセス取得は非対応です。
| MCP ツール | 機能 |
|---|---|
get_account / list_books | 認可されたアカウントと帳簿を表示 |
create_transaction | 収入または支出を1件作成 |
list_transactions | 取引明細をページ単位で取得 |
summarize_transactions | 通貨ごとに集計 |
get_operation | 書き込み結果を確認 |
金額には通貨の最小単位を使います。作成操作には、同じ操作で変わらない requestId（HTTP では Idempotency-Key）が必要です。成功と報告できるのは committed の場合のみです。unknown の場合は元の ID を保持し、結果を確認してください。