コンテンツにスキップ

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 init
npx spendctl mock # ターミナル 1
npx spendctl start # ターミナル 2

MCP クライアントは、人間が答えるよりずっと早くツール呼び出しをタイムアウトさせます。そのため、spendctl.yaml で approvals.hold: false にしてください。こうすると pay は承認 ID をすぐに返します。

ターミナルウィンドウ
npm install @anthropic-ai/claude-agent-sdk
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 を追加してください。

同じサーバーを、コマンド 1 つで追加できます。

ターミナルウィンドウ
claude mcp add spendctl -e SPENDCTL_AGENT=researcher -- npx spendctl mcp

または、プラグインをインストールします。予算・拒否・承認の扱い方をエージェントに教えるスキルが付きます。

ターミナルウィンドウ
claude plugin marketplace add miraistudio/spendctl-sdk
claude plugin install spendctl@spendctl

手元で何も動かさずにツールを試すなら、代わりにホスト型のサンドボックスにつないでください。