Apidog AIエージェントデバッガー：提供状況、カバレッジ、セットアップ

ApidogのAIエージェントデバッガーは、無料プランを含むすべてのプランで、最新のApidogクライアントから利用できます。OpenAI / AnthropicモデルでAIエージェントを実行し、MCPサーバーを接続し、トレースパネルでモデル呼び出し・ツール呼び出し・実行コストを確認できます。

今すぐApidogを試す

この記事では、AIエージェントデバッガーでできること、できないこと、セットアップ手順、既存のApidogプロジェクトへの影響を実装目線で整理します。

利用可能なもの

AIエージェントデバッガーは、標準のApidogクライアントに含まれています。追加ライセンス、アドオン、シート単位の料金は不要です。

利用条件は次のとおりです。

• Free、Basic、Professional、Enterpriseのすべてのプランで利用可能
• 機能はデフォルトで有効
• 最新のApidogクライアントが必要
• 古いクライアントには AI Agent Debugger タブが表示されない

まずはApidogクライアントを最新版に更新してから確認してください。

サポートされるモデルプロバイダー

プロバイダー	ステータス	モデル
OpenAI	サポート済み	GPT-5.5、GPT-5.5 Instant、o-series、およびOpenAIアカウント上の任意のモデル
Anthropic	サポート済み	Claude 4.7 Sonnet、Claude 4.7 Opus、Claude 4.7 Haiku
カスタムOpenAI互換エンドポイント	ベースURL上書きでサポート	OpenAI互換APIを公開している任意のプロバイダー
その他のプロバイダー（Google、Mistral、xAI）	ロードマップ上	現時点ではファーストクラスではありません

OpenAI互換APIを使う場合は、モデル選択後にベースURLを上書きして接続します。

MCPサーバーの接続方法

AIエージェントデバッガーはModel Context Protocol（MCP）をネイティブに扱えます。接続方法は次の3種類です。

• STDIO
  
  ローカルサブプロセスとして起動します。開発中のMCPサーバーを手元でデバッグする場合に向いています。

• HTTPストリーマブル
  
  HTTP経由で到達可能なホスト型MCPサーバーに接続します。

• SSE
  
  Server-Sent Eventsを使うレガシー方式です。後方互換性のためにサポートされています。

認証は主に次の2パターンに対応します。

• APIキーなどを標準ヘッダーで渡す方式
• OAuth 2.0によるフルトークン交換

デバッガーで確認できるもの

AIエージェントデバッガーは、エージェント実行の一連の流れをトレースとして記録します。

確認できる主な項目は次のとおりです。

• モデル呼び出し
  • リクエストペイロード
  • レスポンスペイロード
• モデル思考トレース
  • OpenAI o-series
  • Anthropic拡張思考
  • ※モデルが公開している場合のみ
• ツール呼び出し
  • パラメーター
  • 戻り値
• MCPサーバートラフィック
  • 他のツール呼び出しと同じようにトレースパネルに表示
• 組み込みツール
  • bash
  • web_fetch
  • read
  • edit
  • write
  • grep
  • glob
  • kill_shell
• 実行ごとのメトリック
  • 応答時間
  • 入力トークン
  • 出力トークン
  • 推定コスト
• スキル
  • シナリオを再実行するための保存済みバンドル
  • システムプロンプト
  • ツールリスト
  • パラメーター

基本的なデバッグ手順

AIエージェントの挙動を確認する場合は、次の流れで進めます。

1. モデルを選択する
   
   OpenAIまたはAnthropicを選び、使用するモデルを指定します。

2. APIキーを設定する
   
   対象プロバイダーのAPIキーを入力します。

3. 必要に応じてMCPサーバーを接続する
   
   STDIO、HTTPストリーマブル、SSEのいずれかを選択します。

4. エージェントを実行する
   
   空のスレッドまたは任意のプロンプトで実行します。

5. トレースパネルを確認する
   
   モデル呼び出し、ツール呼び出し、MCP通信、レスポンスを順に確認します。

6. コストとトークン数を確認する
   
   実行単位で応答時間、トークン数、推定コストを見ます。

7. 再利用したい設定をスキルとして保存する
   
   同じシナリオを繰り返し検証する場合に便利です。

デバッガーがカバーしないもの

AIエージェントデバッガーは開発・検証用のデバッガーです。次の用途は対象外です。

• 本番環境の可観測性
  
  長期的なトラフィックログや本番監視には、専用の可観測性ツールを使用してください。

• 自動回帰テスト
  
  フィクスチャに対してプロンプトをグリッド実行する場合は、Promptfooのようなテストハーネスを使用してください。

• エージェント間（A2A）プロトコルトラフィック
  
  A2Aの検証には、Apidogの別個のA2Aデバッガーを使用してください。

• MCPサーバー単体の検証
  
  エージェントループなしで単一のMCPサーバーのツールやリソースを確認する場合は、ApidogのMCPサーバーテストフローを使用してください。

有効にする方法

AIエージェントデバッガーを使い始める手順は次のとおりです。

1. Apidogを最新バージョンにアップデートします。
2. Apidogを開きます。
3. 上部のタブバーから AI Agent Debugger をクリックします。
4. モデルプロバイダーを選択します。
5. 使用するモデルを選択します。
6. ベースURLを確認します。
   • 通常はプロバイダーに応じて自動入力されます。
   • カスタムOpenAI互換エンドポイントを使う場合は上書きします。
7. APIキーを貼り付けます。
8. 空のスレッドで 実行 をクリックし、接続を確認します。

プロジェクトレベルの設定は不要です。AIエージェントデバッガーは独自のワークスペースで動作します。

既存プロジェクトへの影響

AIエージェントデバッガーを有効にしても、既存のApidogプロジェクトには影響しません。

変更されないものは次のとおりです。

• 既存のApidogプロジェクト
• API定義
• テストスイート
• MCPサーバーテストフロー
• A2Aデバッガー
• APIエンドポイントのデバッグ
• モックサーバー
• OpenAPI編集
• 課金プランとプランのティア

AIエージェントデバッガー自体は新しいApidogクレジットを消費しません。

ただし、基盤となるモデルAPI呼び出しは、OpenAIまたはAnthropicアカウント側の課金対象になります。Apidogは使用量に対する追加料金を請求しません。

チームおよびEnterprise管理者向け

チームで利用する場合は、APIキーとMCPサーバー管理の扱いを確認しておくと安全です。

• AIエージェントデバッガーはユーザーごとに有効
• 各メンバーは自分のプロバイダーAPIキーを使用
• デバッガーに入力されたAPIキーは各ユーザーのクライアントにローカル保存
• APIキーはApidogサーバーには送信されない
• ワークスペースのオーナーは、標準のApidog環境変数で共有MCPサーバーエンドポイントを管理可能
• MCPサーバーの監査とアクセス制御は、MCPサーバー側の認証モデルに従う
  • ヘッダー認証
  • OAuth 2.0

既知の制限事項

現時点での制限事項は次のとおりです。

• OpenAIとAnthropic以外のプロバイダー対応はロードマップ上
• OpenAI互換プロバイダーを使う場合は、ベースURLの上書きが必要
• トレース共有はローカルのみ
• トレースを共有する場合は、RawビューのJSONをコピーするか、パネルをスクリーンショットする
• コスト見積もりは、公開されているモデル価格に基づくローカル近似値
• 正確な請求額は、各プロバイダーの使用状況ダッシュボードで確認する

まとめ

ApidogのAIエージェントデバッガーを使うと、モデル呼び出し、ツール呼び出し、MCPサーバー通信、トークン数、推定コストを1つの画面で確認できます。

まずは最新のApidogクライアントに更新し、AI Agent Debugger タブからモデルとAPIキーを設定してください。MCPサーバーを接続すれば、エージェント実行全体をトレースしながら、プロンプト、ツール、外部コンテキストの挙動を実装レベルで検証できます。