MCP Playground：ドキュメントから直接、エージェントのツールをライブ実行
先週、私たちは MCP ツールをファーストクラスの API Contract にしました。稼働中の MCP サーバーに Archyl を向ければ、すべてのツールと入力スキーマを発見し、REST や GraphQL のコントラクトと同じように C4 モデルに紐付けてドキュメント化します。
これは最初の問いに答えるものでした。私のエージェントは何ができるのか？
今日は二つ目の問いに答えます。それは本当に動くのか？
MCP Playground の登場です。すべてのライブ MCP コントラクトに追加された新しいタブで、実際のサーバーに対して任意のツールを呼び出し、実際の結果を確認できます。クライアントのセットアップも、手書きの JSON-RPC も不要。アーキテクチャドキュメントを離れる必要もありません。
スキーマからフォームへ、自動で
ライブ MCP コントラクトを開くと、スキーマの隣に Playground タブがあります。リストからツールを選ぶと — ドキュメント化したのと同じ検索可能なリストです — Archyl がその inputSchema をフォームに変換します：
- 文字列・数値・真偽値は型付きフィールドに。
- enum は許可された値のドロップダウンに。
- 必須パラメータはマークされ、送信前にバリデーションされます。
- ネストしたオブジェクトや配列は生 JSON フィールドになり、送信時に検証されます。
入力してツールを実行を押すと、実行時間とともに結果が返ってきます — 結果にふさわしい形で表示されます。整形済みビューはレスポンスをきれいにインデントされた JSON として表示。ツリービューは大きなペイロードをナビゲート可能にします。不要な部分は折りたたみ、見たい部分だけ展開。ツールが返すテキスト・画像・リソースはネイティブにレンダリングされます。
ツールがエラーを返した場合は、エージェントが見るものとまったく同じものが見えます — エラーフラグとペイロードが赤く表示され、握りつぶされることはありません。
トークンはブラウザから出ない
Playground はライブディスカバリーと同じセキュリティモデルに従います。これこそが要点なので、繰り返す価値があります：
すべての呼び出しはあなたのブラウザから実行されます。 ツールを実行を押すと、ブラウザが MCP サーバーと直接通信します。Archyl のバックエンドは経路上に存在しません。
- トークンは保存されません。 セッション中に入力するだけ。ページの中にだけ存在します。
- 結果は永続化されません。 返ってきたものは表示され、読まれ、タブを閉じれば消えます。
- サーバーサイドからあなたのネットワークへのアクセスはありません。 リクエストはあなたのマシンから発信されるため、Playground は
localhostやプライベートサーバーにも届きます — そして悪用されうるサーバーサイドのリクエスト経路は存在しません。
ディスカバリーと同様、唯一のトレードオフは CORS です。対象サーバーが Archyl のオリジンを許可する必要があります。自分が管理するサーバーなら、設定一行です。
なぜ重要なのか
MCP ツールは、AI エージェントが実際に使うインターフェースです。これまで、ツールを検証するにはクライアントを組み立てるか、JSON-RPC エンベロープを手作りするか、あるいは…説明文を信じるしかありませんでした。
これからは、ドキュメントがそのままテストベンチです：
- エージェントの能力範囲をレビューしている？ ツールを実行して、説明された形ではなく、本物のレスポンスの形を確認できます。
- エージェントの呼び出しが失敗した原因をデバッグしている？ まったく同じ引数で、2 クリックで再現できます。
- 新メンバーをサービスにオンボーディングしている？ コントラクトを送りましょう — すべてのツールを読めて、しかも試せます。
これが私たちの言う「生きたドキュメント」です。実行できる仕様は静かにドリフトしません。嘘をついた瞬間に見破られます。
いつものように、まず自分たちで使う
Archyl 自身が MCP サーバーです — 今週時点で 181 ツール。Playground の最初のユーザーは私たち自身のコントラクトでした。毎日、自分たちのドキュメントから、自分たちのエンドポイントに対して list_projects や get_project_c4_model などを実行しています。上のスクリーンショットがまさにそれです。
試してみる
プロジェクトを開く → API Contracts → ライブエンドポイントを持つ MCP コントラクト → Playground。トークンを入力し、ツールを選んで、実行。
あなたのアーキテクチャドキュメントは、たった今、実行することを覚えました。