Cloud/コネクタ/Playground

Playground

VinkiusについてAIに質問

コネクタが設定の集まりから、触れるものへと変わるタブ。それがMCP Playgroundです。コネクタに組み込まれ、ブラウザからAI Capabilitiesを実際のレスポンス付きでライブ実行できます。

Playgroundは、コネクタが設定のリストから、実際に使えるものへと変わるタブです。MCP Playgroundがコネクタの中に直接組み込まれています。Connector URLを貼り付けるか(またはコネクタ自体から開くか)、コネクタが公開しているすべてのAI Capabilityがブラウザから実行できるツールになり、ライブのレスポンスがそのまま返ってきます。Dashboardで監視し、Credentialsで識別し、Connection Tokensでキーを配布し、AI Capabilitiesで有効にするものを決めたあと、Playgroundは、エージェントが呼び出す前にケイパビリティが実際に動くことを証明する場所です。

R

Playground

Test this connector live in the MCP Playground.

Connected
GitHub

list_issues

read-only

List issues in a GitHub repository, filtered by state.

Parameters

Configure tool inputs

owner*string
repo*string
stateenum

On the free plan the Playground shows an Upgrade plan card; with a credentialed connector it connects on its own. Configure credentials first or it stays on Setup required.

Playground, live. The connector wired straight into the MCP Playground: search the tools, open list_issues, run it and watch the JSON response land with the call counted in Session metrics and Execution history on the right.

モックアップはライブで接続済みのワークスペースです。ツールを検索し、list_issuesを開き、ownerとrepoを入力してRun toolを押すと、JSONレスポンスが結果ペインに表示され、呼び出しは右側のSessionとExecution historyに記録されます。

開き方

Playgroundは誰にでも無料というわけではなく、セットアップ前には開きません。2つの関門が立ちふさがりますが、コンソールはそれぞれをはっきりと表示します:

  • 有料プランが必要です。無料プランでは、タブはカードであってワークスペースではありません。フラスコのアイコン、コネクタ名、"Test this Connector's AI capabilities live, right from your browser."という行、錠前付きのUpgrade planボタン、そしてPlaygroundは有効なconnection tokenでコネクタをライブ実行するものであり、有料プランで利用可能であるという注記が表示されます。
  • Credentialsが必要です。コネクタにまだ設定されていないcredential schemaがある場合、タブは錠前付きでブロックされ、"Setup required"というタイトルと、Credentialsタブへ直接移動するボタンが表示されます。

Credentialsが設定済みの有料プランでは、Playgroundの所有者はコネクタであり、タブを開いた瞬間に自動的に接続します。貼り付けるURLも、コピーするトークンもありません。無料プランで見たカードが、そのまま下のライブワークスペースになります。

接続後のワークスペース

ステータスバーが、行うすべての操作の上にあります。緑のConnectedドット、コネクタ名、そのバージョンと実行中のホスト、ライブのツール数、そしてDisconnectボタンです。Disconnectを押すとライブセッションが解体されます。playgroundの所有者はコネクタなので、ビューの外に何も残りません。その下に3つのペインがあります。

ツールを選ぶ

左ペインはツールリストで、コネクタが公開するすべてのケイパビリティが並びます。検索ボックスに入力すると、コンソールとまったく同じように、入力に応じて名前と説明で絞り込まれます。各行にはインデックス番号、等幅フォントのツール名、1行の説明が付いており、そのツールを実行したことがあれば小さなドットも表示されます。緑は成功、赤はエラーです。ツールを開くと、中央ペインにその内容が表示されます。

ケイパビリティを確認する

中央ペインはツールヘッダーから始まります。名前、コネクタが公開したアノテーションチップ、そして説明です。read-only(エメラルド)は読み取り専用であること、destructive(赤)は書き込みや変更を行うこと、idempotent(青)は繰り返しても安全であることを意味します。その下のParametersフォームは、ツール自身のスキーマから構築されます。文字列用のテキストボックス、整数や小数用の数値フィールド、enum用のピルボタン、boolean用のスイッチ、そしてツールが要求するフィールドには必須のアスタリスクが付きます。任意のフィールドの横にあるヘルプアイコンにカーソルを合わせると、その説明が表示されます。

ライブレスポンスを見る

Run toolを押すと、コンソールが実際のコネクタに対してケイパビリティを呼び出します。実行中はスピナーが表示され、返ってくると結果ペインにsuccessバッジと、クリップボードにコピーできるJSONビューアーでの生レスポンスが表示されます。必須フィールドが空の場合、フォームは"This field is required."と伝え、入力するまで実行されません。

セッションの概要

右側のレールには、セッション全体を通じて2つの情報が保持されます:SessionメトリクスとExecution historyです。

  • Sessionは4つの数字です:Calls(ツールを実行した回数)、Success rateErrorsAvg latency。成功率は良い状態で始まり、エラーが入り込むとアンバーに変わります。エラーは表示すべきものがあるまで控えめに保たれます。
  • Execution historyには、このセッションで行ったすべての実行が記録されます。成功かエラーかのアイコン、ツール名、渡した引数の短い要約、ミリ秒単位の所要時間、そしてどれほど前か。任意の行をクリックすれば再実行でき、ゴミ箱ボタンでリスト全体を消せます。

この画面が存在する理由

エージェントは誰も見ていない午前2時にこれらのツールを呼び出します。Playgroundは、真昼にcreate_pr_commentが間違ったリポジトリに書き込むことや、list_issuesが忘れたstateを必要とすることを発見する場所です。ブラウザでケイパビリティをテストし、実際のレスポンスを読み、それから初めてAIを近づけます。そしてAI Capabilitiesで無効化したスキルはここに決して現れないため、playgroundとペリメーターは一緒に動きます。残りのタブは構築の残りをカバーします。変更のリリース、実行の記録、そしてコネクタのビジネス側面です。

次に来るもの

コネクタにはまだカバーすべきタブがあります。変更のリリースにはDeployments、記録にはAudit LogsとLog Streaming、ビジネスにはSettingsとMonetizeです。それぞれに専用のドキュメントページが、1つずつ、コンソール自体の順序で割り当てられます。