Gemini アプリのデベロッパー モードを使用すると、Model Context Protocol（MCP）サーバーをインタラクティブにテストし、スキーマエラーやランタイム エラーを診断して、ツールの品質をベンチマークできます。これは、接続済みアプリを Google Connected Console で審査に提出する前に行います。
このガイドでは、次のタスクについて説明します。
- Gemini で Gemini アプリのデベロッパー モードを有効にし、カスタム MCP アプリを作成して、初期ツールの検出を確認します。
- 失敗したツール呼び出しのデバッグ、更新されたスキーマの同期、認証のテストを行います。
- ユーザー環境のコンテキストをシミュレートし、クライアント認証を構成する。
ワークスペースのレイアウトとインスペクタ タブの概要については、Gemini アプリ デベロッパー モードの概要をご覧ください。
Gemini アプリのデベロッパー モードを有効にする
Google Connected Console で MCP サーバーをオンボーディングしている場合、Gemini アプリのデベロッパー モードを有効にすると、登録済みのアプリがすでに利用可能になっているため、ステップ 2 をスキップできます。デプロイされた HTTPS MCP サーバー エンドポイントをコンソールに登録する前に Gemini で直接テストする場合は、両方の手順に沿って Gemini アプリのデベロッパー モードを有効にし、サーバーをカスタム MCP アプリとして接続します。
ステップ 1: Gemini アプリのデベロッパー モードを有効にする
- ウェブブラウザで Gemini を開きます。
- [設定] > [Gemini アプリ デベロッパー モード] をクリックします（または、gemini.google.com/devmode に直接アクセスします）。
（省略可）ステップ 2: カスタム MCP アプリを作成してテストする
Gemini アプリのデベロッパー モードで MCP サーバーをカスタムアプリとして接続する手順は次のとおりです。
- [Choose an app] ダイアログで、[+ Create new] をクリックします。
- [Connect to an MCP server] ダイアログで、[MCP Server URL] にサーバーの公開 HTTPS エンドポイントを入力します（URL が
https://で始まっていることを確認してください。例:https://your-app-link.com/mcp）。 - サーバーで事前登録済みの OAuth 認証情報が必要な場合は、[Additional settings] > [Show more] をクリックして OAuth のクライアント ID とクライアント シークレットを入力し、[Next] をクリックします。
- セキュリティとプライバシーの確認ダイアログで、Gemini がカスタム MCP サーバーとどのようにやり取りするかを確認します。
- ツールの実行: Gemini は、MCP サーバーのツールを実行して、リクエストの処理に利用できる関数をトリガーして実行します。
- データの取得と共有: Gemini は、MCP サーバーのエンドポイントによって公開されるリソース、スキーマ、コンテキストを取得して管理します。また、Google アカウントの設定に基づいて、または他の接続済みアプリとのやり取り時に、アクセス可能な情報を共有することがあります。
- 信頼と接続解除: 続行する前に、MCP サーバーを信頼できることを確認し、プライバシー ポリシーを確認してください。サーバーの接続は、[アプリ連携] ページからいつでも解除できます。また、Google アカウントの接続からリンクを削除することもできます。
- [このカスタムアプリを接続することによるセキュリティとプライバシーのリスクを理解したうえで同意します。] を選択し、[接続] をクリックします。
- [カスタムアプリを保存] ダイアログで、カスタムアプリの表示名を入力し、サーバーのツールが [利用可能なアクション] リストに表示されていることを確認して、[接続] をクリックします。
- Gemini アプリのデベロッパー モードのサイドパネルで、[ツールスキーマ] タブを選択して、接続されたアプリの各ツールに関する情報（パラメータ定義、安全バッジ（読み取り専用、破壊的、認証が必要）、未加工スキーマ、レスポンス構造）を確認します。
- 左側のチャットペインで、自然言語または
@mentionプロンプト（@MyApp show my profileなど）を入力し、[イベントログ] タブをモニタリングして、ツールの動作を確認します。
ツール呼び出しをデバッグする
ツール呼び出しが失敗したり、予期しない引数が生成されたりした場合は、診断テレメトリーを検査し、バックエンド MCP サーバーを更新して、会話履歴を消去せずにスキーマをホットリロードできます。
失敗したツール呼び出しをデバッグする手順は次のとおりです。
- 右側のペインで、[イベントログ] タブを選択します。
- [テレメトリー] リストで失敗したイベントをクリックして詳細を開き、
Tool callリクエスト ペイロードとTool resultレスポンスを調べます。- 接続エラーとネットワーク エラー: エラー メッセージとレイテンシを確認して、エンドポイントに到達できることを確認します。
- 認証エラー: イベントが
401または403を返す場合は、[認証] タブで OAuth トークンの状態またはクライアント認証情報を確認します。 - スキーマ検証の不一致: サーバーが MCP の無効なパラメータ エラー（
-32602）を返した場合は、Tool callのモデル生成 JSON 引数を、[ツールスキーマ] タブのパラメータ タイプ、必須プロパティ、形式の指示と比較します。 - サーバー ランタイム例外:
Tool resultの JSON-RPC エラーコードとメッセージを調べて、バックエンド例外を診断します。
- この問題を解決するには、MCP サーバーの実装を更新するか、ツールとパラメータの説明を調整します。明確なツールスキーマとエラー レスポンスの作成に関するガイダンスについては、MCP 接続アプリの統合標準をご覧ください。
- [ツールスキーマ] タブで、[スキーマを同期] をクリックします。Gemini は、MCP サーバーから
tools/listを再取得し、現在のチャット スレッドを保持したまま、アクティブなツール定義を更新します。 - クエリを再試行してください。[イベントログ] タブで、リプレイされたツール呼び出しが
200 OKを返し、チャット プレビューに想定されるレスポンスが表示されることを確認します。
環境コンテキストと認証をシミュレートする
MCP ツールがさまざまなユーザーの場所、タイムゾーン、言語 / 地域、認証方法にどのように応答するかを、インスペクタ ペイン内で直接テストできます。
環境コンテキストをオーバーライドする
日付、時刻、ロケールに依存するツールのユーザー コンテキストをシミュレートするには、次の操作を行います。
- 右側のペインで、[環境] タブを選択します。
- [日付と時刻] で、[シミュレートされた日付] と [シミュレートされた時刻] を選択して、相対的な時間表現（「明日の朝」や「今週の土曜日の午後」など）をテストします。
- [Preferences] で、ユーザーの言語 / 地域をシミュレートする言語を選択します（例:
en-US）。 - チャットペインでテスト プロンプトを実行して、シミュレートされたコンテキストでツールを評価します。
- デフォルトの環境設定に戻すには、[リセット] をクリックします。
クライアント認証を構成する
Gemini アプリのデベロッパー モード セッションで使用される認証方法を構成または切り替えるには、次の操作を行います。
- 右側のペインで、[認証] タブを選択します。
- [クライアント認証の構成] で、次のいずれかの認証モードを選択します。
- 動的クライアント登録: OAuth フローを使用して、認証サーバーと認証情報を自動的にネゴシエートします。詳細については、OAuth 2.1 実装ガイドをご覧ください。該当する場合は、[カスタム アプリリンクを追加] にエンドポイントを入力します。
- 手動クライアント登録: 事前登録されたクライアント ID とクライアント シークレットを手動で指定できます。[詳細設定] を開いて、追加のフロー オーバーライドを構成します。
- [保存] をクリックし、[保存しました] というメッセージが表示されるまで待ちます。次に、テストプロンプトを実行して、認証されたツールが成功することを確認します。