Claude Agent SDK
Claude Agent SDK は MCP サーバーを受け取れます。spendctl にはその MCP サーバーが付いています(npx spendctl mcp)。これはお客様が動かすサイドカーの薄いクライアントで、鍵を持たず、何も承認できません。エージェントに 5 つのツールを提供します。
| ツール | 内容 |
|---|---|
pay |
費用がかかるかもしれない URL を、サイドカーのポリシーを通して取得します |
check_budget |
上限、期間ごとの使用額、残り |
list_receipts |
最近の試行(支払い済み、拒否、承認待ち) |
await_approval |
保留になった呼び出しへの人間の判断を、支払いをやり直さずに待ちます |
withdraw_approval |
タスクに不要になった保留中の呼び出しを取り下げます |
サイドカーを起動します。初めて試すときは、モックの売り手も起動してください(クイックスタート)。
npx spendctl initnpx spendctl mock # ターミナル 1npx spendctl start # ターミナル 2MCP クライアントは、人間が答えるよりずっと早くツール呼び出しをタイムアウトさせます。そのため、spendctl.yaml で approvals.hold: false にしてください。こうすると pay は承認 ID をすぐに返します。
npm install @anthropic-ai/claude-agent-sdkエージェント
Section titled “エージェント”import { query } from "@anthropic-ai/claude-agent-sdk";
const prompt = "Check my remaining budget, then get the weather for Tokyo and Osaka from http://localhost:4021/weather?city=<city>. " + "If spendctl refuses or asks for approval, tell me why instead of retrying.";
for await (const message of query({ prompt, options: { mcpServers: { spendctl: { type: "stdio", command: "npx", args: ["spendctl", "mcp"], env: { SPENDCTL_AGENT: "researcher", SPENDCTL_URL: "http://127.0.0.1:8402" }, }, }, allowedTools: ["mcp__spendctl__pay", "mcp__spendctl__check_budget", "mcp__spendctl__list_receipts"], },})) { if (message.type === "result" && message.subtype === "success") console.log(message.result);}この例では 5 つのツールのうち 3 つを許可しているので、エージェントは承認を待たずに、承認が必要になったことを報告します。判断を待ってから pay と approvalId で支払いを完了させたい場合は、allowedTools に mcp__spendctl__await_approval と mcp__spendctl__withdraw_approval を追加してください。
Claude Code
Section titled “Claude Code”同じサーバーを、コマンド 1 つで追加できます。
claude mcp add spendctl -e SPENDCTL_AGENT=researcher -- npx spendctl mcpまたは、プラグインをインストールします。予算・拒否・承認の扱い方をエージェントに教えるスキルが付きます。
claude plugin marketplace add miraistudio/spendctl-sdkclaude plugin install spendctl@spendctl手元で何も動かさずにツールを試すなら、代わりにホスト型のサンドボックスにつないでください。
- 署名の前に
payが確かめること:AI エージェントの予算 - 保留された支払いがどう判断されるか:承認フロー