MCP サーバーのテストを書く — AI が呼ぶ「道具」をどう検証するか、モックの作り方 3 段階

Anthropic の claude.com ブログ記事「Building agents: When to fold subagents into your main agent loop」の解説。サブエージェントをメインのループへ戻し、Skills と MCP ツールに置き換える判断基準と 4 ステップの手順を整理。評価セットの先行作成、サブエージェントを残す 3 条件、Claude Code への読み替えも収録。マルチエージェント構成を運用中の開発者向け。

Kiva の Samurai App 開発者が、AI Agent SaaS 特有の難しさを tool 追加・context 圧迫・instruction 更新・モデル EOL・durable state・外部連携の 6 観点から、実コードと ADR で解説。似た tool の取り違え事故、本物のモデルで変更前後を 3〜5 回ずつ比較し結果を PR に記載する運用、41 本の tool を中核 19 本と toolbox に畳んで毎ターンの入力トークンを削減した事例など、Agent 開発者向けの実践知。

開発歴 19 年の個人開発者が、Claude Code で C# をほぼ全面的に書かせ、Funplay MCP 経由で Unity 6 エディタを直接操作させて約 5 週間で Steam 向けゲームを完成させた事例。夜間にカード単位でタスクを自動処理するランナースクリプト (予算上限・ヘッドレスビルド・テスト通過時のみマージ) や、Blender + MCP によるモデル修正、マーケティング動画の自動生成まで解説。ゲーム開発の自動化パイプライン構築に関心がある開発者向け。

MCPツールに相対日付「今日」が渡り、例外の握りつぶしで空リストが返った結果、エージェントが同じ引数でリトライを続けた障害の事例。型ヒント (Literal / date)、Field による範囲指定、関数先頭の業務ルール検証、hint 付き構造化エラーの4段ガードで、AIの不正な引数を呼び出し前と関数内で弾く設計を解説。FastMCP サーバーと確認用クライアントのコード付き。MCP サーバー開発者向け。