# Claude Agent SDK

> spendctl の MCP サーバーを Claude Agent SDK につなぎ、エージェントが予算の範囲内で x402 と MPP の API に支払えるようにします。承認が必要な支払いは人間の判断まで保留されます。同じサーバーは Claude Code でも使えます。

出典: https://spendctl.dev/ja/docs/claude-agent-sdk/ （spendctl ドキュメント。全体の索引は https://spendctl.dev/llms.txt）

Claude Agent SDK は MCP サーバーを受け取れます。spendctl にはその MCP サーバーが付いています（`npx spendctl mcp`）。これはお客様が動かすサイドカーの薄いクライアントで、鍵を持たず、何も承認できません。エージェントに 5 つのツールを提供します。

| ツール | 内容 |
|---|---|
| `pay` | 費用がかかるかもしれない URL を、サイドカーのポリシーを通して取得します |
| `check_budget` | 上限、期間ごとの使用額、残り |
| `list_receipts` | 最近の試行（支払い済み、拒否、承認待ち） |
| `await_approval` | 保留になった呼び出しへの人間の判断を、支払いをやり直さずに待ちます |
| `withdraw_approval` | タスクに不要になった保留中の呼び出しを取り下げます |

## 始める前に

サイドカーを起動します。初めて試すときは、モックの売り手も起動してください（[クイックスタート](https://spendctl.dev/ja/docs/quickstart/)）。

```bash
npx spendctl init
npx spendctl mock      # ターミナル 1
npx spendctl start     # ターミナル 2
```

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

```bash
npm install @anthropic-ai/claude-agent-sdk
```

## エージェント

```ts
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

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

```bash
claude mcp add spendctl -e SPENDCTL_AGENT=researcher -- npx spendctl mcp
```

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

```bash
claude plugin marketplace add miraistudio/spendctl-sdk
claude plugin install spendctl@spendctl
```

手元で何も動かさずにツールを試すなら、代わりにホスト型の[サンドボックス](https://spendctl.dev/ja/docs/sandbox/)につないでください。

## 次に読む

- 署名の前に `pay` が確かめること：[AI エージェントの予算](https://spendctl.dev/ja/docs/agent-budgets/)
- 保留された支払いがどう判断されるか：[承認フロー](https://spendctl.dev/ja/docs/approvals/)
