よくある質問
短い答えと、詳しく書いたページへのリンクをまとめています。知りたいことが見つからなければ、Discord で質問するか、support@spendctl.dev までご連絡ください。
spendctl とは何ですか?
Section titled “spendctl とは何ですか?”spendctl(spendctl.dev、npm では npx spendctl)は、HTTP 402 で API に支払う AI エージェントのための、支出ポリシーのサイドカーです。エージェントはリクエストをサイドカー経由で送ります。売り手が支払いを求めると、spendctl はそのリクエストをポリシーファイル(エージェントごとの予算、許可ホスト、受取先の固定、承認しきい値)と照らします。そのうえで、支払うか、モデルが読める理由を付けて拒否するか、人間の判断を待って保留し、すべての試行を台帳に記録します。詳しくは spendctl とはをご覧ください。
spendctl はウォレットや決済代行ですか?
Section titled “spendctl はウォレットや決済代行ですか?”いいえ。署名はお客様が動かすサイドカーの中で、お客様自身のウォレット(Coinbase CDP のサーバーウォレットか、ご自身の鍵)に対して行われます。spendctl が鍵や資金を持つことはなく、資金はお客様のウォレットから売り手へ直接移動します。ホスト型のコントロールプレーンが保存するのはポリシー・台帳の行・承認だけで、鍵や資金は預からず、署名を中継することもありません。
何もインストールせずに試すには?
Section titled “何もインストールせずに試すには?”MCP クライアント(Claude、Claude Code、Cursor、VS Code)を、ホスト型のサンドボックス https://mcp.spendctl.dev/mcp につないでください。本物のサイドカーを、モックの有料 API とモックの資金で動かします。ログインは不要です。クライアントごとの 1 行の設定はサンドボックスにあります。
ローカルで動かすには?
Section titled “ローカルで動かすには?”Node.js 22.13 以上で npx spendctl init を実行し、続けて 2 つのターミナルで npx spendctl mock と npx spendctl start を実行します。モックのファシリテータが同梱されているので、鍵もチェーンも要りません。クイックスタートは 5 分ほどで終わります。Docker イメージもあります。
試すのに暗号資産、ウォレット、API キーは必要ですか?
Section titled “試すのに暗号資産、ウォレット、API キーは必要ですか?”いいえ。サンドボックスもローカルのクイックスタートも、モックの署名者とモックの売り手を使います。本物のウォレットが必要になるのは、実際の支払いのときだけです。実際の支払いで、Coinbase CDP のサーバーウォレットを使ったテストネットでの支払いを順に説明しています。
エージェントの支出を管理する
Section titled “エージェントの支出を管理する”AI エージェントの使いすぎを防ぐには?
Section titled “AI エージェントの使いすぎを防ぐには?”上限を、エージェントの手が届かない場所に置きます。spendctl ではそれが spendctl.yaml です。1 回あたりの上限、1 時間・1 日・1 週間・1 か月ごとの予算、売り手ごとの予算、エージェントが支払ってよいホストの一覧、人間の承認が必要になる金額を書きます。サイドカーが別のプロセスで強制するので、プロンプトでは変えられません。完全なファイルは AI エージェントの予算にあります。
エージェントが予算に達するとどうなりますか?
Section titled “エージェントが予算に達するとどうなりますか?”onBudgetExceeded で選べます。deny(既定)では、リクエストは HTTP 402、エラー spendctl_denied、daily_exceeded などの理由で拒否され、何も署名されません。approve では、支払いは人間の判断を待って保留され、待っている間は何も署名されません。答えのない承認は、approvals.timeout(既定 10 分)を過ぎると拒否になります。
エージェントが自分の支払いを承認できますか?
Section titled “エージェントが自分の支払いを承認できますか?”いいえ。どの判断にも管理トークンが必要で、そのトークンはエージェントに渡されることのないファイルにあります。確認リンクはそのトークンに束縛されていて、ボタンを押したときにだけ動くので、チャットアプリがリンクを先読みしても何も承認されません。承認は、人間が見た受取先・ネットワーク・資産・金額にも結び付きます。再送のときに売り手の条件が変わっていれば、approval_mismatch で拒否されます。詳しくは承認フローをご覧ください。
プロンプトインジェクションでエージェントに支払わせることはできますか?
Section titled “プロンプトインジェクションでエージェントに支払わせることはできますか?”「払いたい」と言わせることはできても、答えは変えられません。予算・許可ホスト・受取先の固定・承認しきい値は、モデルが編集できないポリシーファイルにあり、別プロセスで判定されます。拒否の理由は平文で返るので、モデルは同じ要求を繰り返さずに理由を説明できます。
同じリクエストに二重に支払うことはありますか?
Section titled “同じリクエストに二重に支払うことはありますか?”spendctl は 1 つの判定につき最大 1 回しか署名せず、失敗後に署名済みの支払いを再送することはありません。同じ Idempotency-Key を付けた再試行は、冪等性ウィンドウ(既定 10 分)の間は duplicate_request で拒否されます。結果を確認できなかった支払いは unknown として記録され、人間が照合するまで予算に計上され続けます。詳しくは台帳と照合をご覧ください。
売り手が受取先をすり替えたり、値上げしたりしたら?
Section titled “売り手が受取先をすり替えたり、値上げしたりしたら?”ポリシーは、402 が名乗る URL ではなく、エージェントが実際に呼んだホストに対して判定します。payTo はホストごとに受取先を固定し、必要ならネットワークと資産も固定します。firstPaymentMax は新しい受取先への高額な初回支払いを人間の判断まで保留し、priceJumpFactor はそのエンドポイントに前回支払った価格の N 倍を超える価格を保留します。詳しくはポリシーリファレンスをご覧ください。
人間はどうやって支払いを承認しますか?
Section titled “人間はどうやって支払いを承認しますか?”CLI(spendctl pending、spendctl approve、spendctl deny)、ローカルのダッシュボード、または Webhook で Slack、Discord、任意の JSON エンドポイントに届く確認リンクから承認します。承認依頼には、エージェント、エンドポイント、金額、受取先、保留された理由が表示されます。
プロトコルと組み込み
Section titled “プロトコルと組み込み”spendctl はどの支払いプロトコルに対応していますか?
Section titled “spendctl はどの支払いプロトコルに対応していますか?”x402 v1 と v2 に対応しています。EVM ネットワークの exact スキームで、署名から決済まで通して動きます。MPP は charge のチャレンジを解析し、同じポリシーと照らして記録します。支払うには credential provider をコードで組み込む必要があり、spendctl を通した実際の MPP 支払いはまだ行われていません。2 つのプロトコルの説明は HTTP 402・x402・MPPにあります。
どのネットワークと資産で支払えますか?
Section titled “どのネットワークと資産で支払えますか?”CAIP-2 の ID で指定する EVM ネットワークと、x402 SDK がネットワークごとに持つ USD 連動のステーブルコインです。既定のポリシーは Base Sepolia(eip155:84532)と USDC を許可します。Base メインネットには eip155:8453 を追加してください。予算は USD なので、USD の値が決まらない資産は、assets: に宣言しないかぎり拒否されます。
LangGraph、OpenAI Agents SDK、Claude Agent SDK で使えますか?
Section titled “LangGraph、OpenAI Agents SDK、Claude Agent SDK で使えますか?”はい。HTTP リクエストを送れるエージェントなら、どれでもゲートウェイ URL を使えます。TypeScript 向けには依存ゼロの fetch ラッパー、Python にはクライアント、MCP を話すクライアントには MCP サーバーがあります。具体例は LangGraph、OpenAI Agents SDK、Claude Agent SDK に、そのほかは組み込み方にあります。
Python のクライアントはありますか?
Section titled “Python のクライアントはありますか?”はい。pip install "spendctl-sdk[httpx]" で入れ、spendctl_sdk として import します。PyPI にある spendctl という名前のパッケージは、関係のない別のプロジェクトです。
x402 SDK やウォレットの支出管理機能とは何が違いますか?
Section titled “x402 SDK やウォレットの支出管理機能とは何が違いますか?”それらも併用してください。x402 クライアントはエージェントのプロセス内で 1 回あたりの支払いに上限をかけ、ウォレットのポリシーエンジンは自社が持つ鍵を受け持ちます。spendctl が加えるのは、それらをまたぐ部分です。期間ごとの予算、ホストと受取先のルール、人間の承認、1 つの台帳を、サイドカーの背後にあるすべてのエージェントとウォレットに効かせます。比較は支出管理の置き場所にあります。
プランとデータ
Section titled “プランとデータ”Free プランには何が含まれますか?
Section titled “Free プランには何が含まれますか?”ポリシーを強制する機能がすべて入ったサイドカーを、カード登録なしで使えます。エージェント 2、ポリシー 1、月 1,000 件の governed payment(管理対象支払い)までで、ローカル台帳と CSV / JSON の書き出しが付きます。上限に達すると、月が変わるまで新しい支払いは拒否されます。署名者がモックの間は何も数えません。
governed payment(管理対象支払い)とは何ですか?
Section titled “governed payment(管理対象支払い)とは何ですか?”サイドカーが支払いの仕事をしたリクエストです。署名した、または人間に承認を求めたものを指します。拒否と dry run は数えないので、拒否され続けるエージェントが月の枠を使い切ることはありません。詳しくはプランとライセンスキーをご覧ください。
Pro と Team で、いま何が加わりますか?
Section titled “Pro と Team で、いま何が加わりますか?”加わるのは、サイドカーの Free の上限を外すライセンスキー(Pro はエージェント 10 と月 25,000 件の governed payment、Team はエージェント無制限と月 500,000 件)、キーのあるすべてのサイドカーにポータルから 1 つの spendctl.yaml を配るポリシー同期(Pro はサイドカー 3 台、Team は台数の制限なし)、台帳のホスト側の写し(Pro は 90 日、Team は 1 年)です。Slack / Discord アプリでの承認、定期的な書き出し、SSO、共有予算は開発中です。通常価格は Pro が月額 $29、Team が月額 $249 です。現在の提供条件は料金にあります。
サイドカーは spendctl に何を送りますか?
Section titled “サイドカーは spendctl に何を送りますか?”ライセンスキーがなければ、何も送りません。キーがあると、起動時と 1 日 1 回チェックインし、6 つの値を送ります。ランダムなサイドカー ID、バージョン、対象の月、その月の governed payment の件数、エージェント数、動かしているポリシーのバージョン番号です。あわせて 5 分ごとに、組織がポリシーを同期しているかを問い合わせます。台帳の行が出ていくのは、オーナーがポータルでホスト台帳を有効にしたあとだけです。これとは別に、0.10.0 以降は、実際の支払いに署名するサイドカーが、自分のバージョンが非推奨になっていないかを npm の公開レジストリに問い合わせます(送り先は当社ではありません。バージョンの確認)。すべての項目はプランとライセンスキーとプライバシーポリシーに記載しています。
spendctl のサーバーが止まっても、エージェントは支払えますか?
Section titled “spendctl のサーバーが止まっても、エージェントは支払えますか?”はい。ライセンスキーはオフラインで検証し、コントロールプレーンが支払い経路に乗ることはありません。コントロールプレーンに届かないとき、サイドカーは現在の上限とポリシーを保ったまま、あとで再試行します。
spendctl のライセンスは何ですか?
Section titled “spendctl のライセンスは何ですか?”サイドカーと CLI は、プロプライエタリライセンスで npm から配布しています。薄いクライアント(@spendctl/client、Python クライアントの spendctl-sdk、Claude Code / Cursor のプラグイン)は Apache-2.0 で、github.com/miraistudio/spendctl-sdk にあります。
PyPI の spendctl パッケージは同じプロジェクトですか?
Section titled “PyPI の spendctl パッケージは同じプロジェクトですか?”いいえ。PyPI と GitHub にある spendctl という名前のプロジェクトは、関係のない個人向けの家計管理ツールです。この製品は spendctl.dev の spendctl で、npx spendctl でインストールします。Python クライアントは spendctl-sdk です。
セキュリティの問題はどこに報告すればよいですか?
Section titled “セキュリティの問題はどこに報告すればよいですか?”security@spendctl.dev 宛てに非公開でお願いします。spendctl が守るものと守らないものはセキュリティモデルに、データがどこにあり誰が処理するかは信頼性にあります。