接続済みアプリを登録、テスト、公開する

前提条件を満たしたら、次の手順に沿って接続済みアプリを登録、設定、テスト、公開します。

ステップ 1: 接続済みアプリを作成する

接続済みアプリを作成するには:

  1. Google Connected Console にログインします。
  2. ホームページで [アプリを作成] を選択します。
  3. [作成するものを選択] ダイアログで、次の操作を行います。
    • 接続済みアプリの利用規約に同意するよう求められたら、[利用規約を表示] を選択し、利用規約を確認して同意してから、[作成] を選択します。この契約に同意できるのはアカウント管理者のみです。
    • それ以外の場合は、[接続済みアプリ] カードで [作成] を選択します。

  4. [接続済みアプリに名前を付ける] ダイアログで、接続済みアプリの名前を入力します。この名前は、Google サービス全体で接続済みアプリを表示するために使用されます。また、ユーザーが @ を使用して接続済みアプリに言及する際にも使用されます。[次へ] を選択します。

  5. [接続済みアプリのカテゴリを選択] ダイアログで、[カテゴリを選択] メニューからアプリのドメイン、カテゴリ、業種を選択します。

  6. [接続タイプの選択] ダイアログで、次のいずれかのオプションを選択します。

    • MCP サーバー: MCP サーバーを接続して、ウェブ、Android、iOS の Gemini や Google 検索のユーザーにサービスを提供します。
    • Android MCP: Android の Gemini にオンデバイス機能を連携させることで、ユーザーに代わって Gemini がアプリ内のアクションをトリガーしたり、タスクを完了したりできるようになります。

    詳しくは、Android MCP 接続済みアプリをセットアップする方法をご覧ください。接続済みアプリごとに選択できる接続タイプは 1 つのみで、後で変更することはできません。

  7. [Create Connected app] を選択します。

これにより、接続済みアプリの管理概要ページ（接続済みアプリの設定とテスト）が開き、アプリの詳細、MCP サーバー接続、テスターを構成できます。

ステップ 2: 接続済みアプリの詳細を入力する

接続済みアプリの詳細を指定し、ユーザーに表示される方法を構成するには:

  1. 接続済みアプリの概要ページの [アプリの詳細] 行で、[開始する]（既存の詳細を更新する場合は [管理]）を選択します。
  2. [アプリの詳細] ページの上部にある [接続アプリ名] フィールドを確認します。必要に応じて名前を更新できます。この名前は Google の各サービスでユーザーに表示されるほか、ユーザーが @ を使ってあなたのアプリをメンションする際にも使用されます。
  3. [公開情報] セクションの [アイコン] で、アプリアイコン（JPG または PNG、最大 1 MB、512 px × 512 px）をアップロードします。

  4. 次のフィールドに値を入力します。

    • 説明: 接続済みアプリの主な機能と、そのアプリでできることを簡潔に 1 文（30 語未満）で入力します。このテキストはユーザーに表示されます。モデルの指示としては使用されません。
    • 機能: 接続済みアプリが実行できる価値の高いタスクを 3 つ以上入力します。[Add capability] を選択して、エントリを追加します。機能の先頭に数字を入れないでください。1 つのエントリにつき 1 つの機能のみを含めます。カテゴリに事前定義された機能が含まれている場合、それらはリストの上部に表示され、変更できません。
    • プロンプトの例: ユーザーがどのような指示や質問ができるかを把握するのに役立つプロンプトの例を 3 つ以上入力します。[サンプル プロンプトを追加] を選択して、エントリを追加します。
      • 少なくとも 2 つのプロンプトの先頭を @<YourAppName> にしてください（例: @Order Tracker where is my last order?）。
      • アプリ名（Track my recent order on Order Tracker など）で始めずに、少なくとも 1 つのプロンプトで自然に <YourAppName> に言及してください。
      • 番号付きの接頭辞（1.、2.、3.）を含めたり、プロンプトを引用符（"..."）で囲んだりしないでください。

    • 多言語ローカライズ: [説明]、[機能]、[プロンプトの例] の翻訳を提供するには、入力フィールド内の言語タグで各言語のテキストをラップします。例:

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Connected Console はタグを自動的に検証し、検出された言語 / 地域を各フィールドの下に表示します（例: Found translations for 2 languages: en-US, es-ES）。

    • 利用規約の URL: 利用規約への有効な https:// または http:// リンクを入力します。

    • ポリシーの URL: プライバシー ポリシーへの有効な https:// または http:// リンクを入力します。

    • ウェブサイトの URL（省略可）: アトリビューションを目的として、ウェブサイトへのリンクを入力します。

  5. ページの下部にある [保存] を選択して、概要ページに戻ります。

ステップ 3: MCP エンドポイントを入力し、ドメインの所有権を確認する

Google が MCP サーバーに接続したり、ツールを同期したりするには、MCP サーバーのエンドポイント URL を指定し、ホストされているドメインの所有権を証明する必要があります。

MCP エンドポイントを入力してドメインの所有権を確認するには:

  1. 接続済みアプリの概要ページで、[MCP とツールの設定] カードの [開始]（既存の詳細を更新する場合は [管理]）を選択します。MCP 設定フローのステップ 1（MCP サーバー エンドポイント）が開きます。
  2. [MCP サーバー エンドポイントを接続しました] に、MCP サーバー エンドポイントの完全な HTTPS URL（例: https://api.yourdomain.com/v1/mcp）を入力します。

  3. [ドメインの所有権を証明する] で、ドメインのチャレンジ トークンによる確認を完了します（デベロッパー アカウントでドメインまたはその親ドメインの所有権をすでに証明している場合は、自動的に確認済みとして表示されます）。

    1. [ドメインの所有権を証明する] カードで、[トークンをダウンロード] を選択します。ブラウザによって、次の構造の google-connected-apps.json という名前のファイルがダウンロードされます。

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. この JSON コンテンツをアップロードして、https://<your-domain>/.well-known/google-connected-apps のサーバーでホストします。

      • エンドポイントが HTTPS 経由で一般公開されていること、HTTP リダイレクトなしで HTTP 200 OK を直接返すこと、verification_tokens 配列内にトークンが含まれていることを確認します。

    3. Google Connected Console に戻り、[ドメインの所有権を証明] を選択します。

    4. 確認が成功すると、[Domain verified with challenge token] 行に緑色のチェックマークが表示され、その下の [Access credentials] セクションのロックが解除されます。

ステップ 4: アクセス認証情報を構成する

ドメインの所有権を証明したら、Google が MCP サーバーで認証する方法を構成し、サーバーのツール定義を取得します。

アクセス認証情報を構成するには:

  1. [アクセス認証情報を提供する] セクション（[MCP とツールの設定] ページのステップ 1）で、[開始] を選択します（既存の構成を変更する場合は [認証情報を更新] を選択します）。

  2. [サーバーで認可が必要ですか？] で、次のいずれかのオプションを選択します。

    • いいえ: MCP サーバーが認証なしで一般公開されている場合は、このオプションを選択し、[確認] を選択します。

    • はい: MCP サーバーによって公開されるツールのいずれかで認可が必要な場合は、このオプションを選択します。次に、[MCP サーバーで使用する認可モデルを選択する] で、認証フローを選択します。

      • マシン間（OAuth クライアント認証情報）: サービス間認証（RFC 6749）の場合は、これを選択します。この認証では、Google が共有のクライアント ID とクライアント シークレットを使用して MCP サーバーと直接通信し、エンドユーザーのログイン リダイレクトは行われません。
        1. クライアント ID（必須）とクライアント シークレット（省略可）を入力します。
        2. サーバーが /.well-known/oauth-authorization-server を使用してアドバタイズしていない場合は、必要に応じて認可エンドポイント（省略可）とトークン エンドポイント（省略可）を入力します。
        3. [Register client]（または [Update client]）を選択します。

      • ユーザー委任（認証コード）: MCP サーバーが、個々のユーザーに Google アカウントのリンクを通じて個人アカウントでログインし、操作を認可するよう求める場合は、このオプションを選択します。

        1. Google の OAuth リダイレクト URI を許可リストに登録する: [Ensure you have allow listed the provided redirect URIs] バナーで、[View] を選択（またはコピーアイコンを選択）して、接続済みアプリ用に生成されたアプリ固有のリダイレクト URI を確認します。これらを OAuth サーバーの許可リストに追加し、Google Connected Console に戻ります。
        2. [Google が OAuth サーバーで認証する方法を選択する] で、OAuth クライアントの登録方法を選択します。
          • 事前登録済み: OAuth プロバイダで静的なクライアント ID とクライアント シークレット（省略可）を生成する場合は、こちらを選択してください。必要に応じて、カスタム認可エンドポイント（省略可）とカスタム トークン エンドポイント（省略可）を指定することもできます。
          • クライアント ID メタデータまたは動的クライアント登録（推奨）: サーバーが OAuth クライアント ID メタデータ ドキュメント（CIMD）または動的クライアント登録（RFC 7591）をサポートしている場合は、こちらを選択します。Google はまず CIMD を確認し、.well-known ディスカバリ エンドポイントを使用して DCR にフォールバックします。必要に応じて、カスタムの認可エンドポイントとトークン エンドポイントを指定することもできます。

        3. [デベロッパーの認証情報で認証する] で、承認モデルとしてユーザー委任を選択したため、Google がツールを取得する前にサーバーにログインする必要があります。次のいずれかを選択します。

          • ポップアップで認証する（推奨）: オーバーレイ ダイアログで認証フローを開きます。これがデフォルトのエクスペリエンスです。
          • リダイレクトで認証する（フォールバック）: 同じタブまたはウィンドウで全画面リダイレクトを使用して認証フローを開きます。表示の制約やセキュリティ ヘッダー（X-Frame-Options や Content-Security-Policy など）が原因でダイアログがレンダリングされない場合は、こちらを使用してください。

          まず、ダイアログを使用して認証を試みることをおすすめします。ダイアログを使用して認証できない場合は、リダイレクト メソッドを使用します。選択した内容は、ユーザーが接続済みアプリを初めて使用する際のログイン エクスペリエンスにも影響します。

        4. [Register client]（または [Update client]）を選択します。

ステップ 5: テスト アカウントの詳細を提供する（ユーザー委任認証の場合のみ）

接続済みアプリで認証が必要な場合は、現実的なサンプルデータが事前入力され、2 要素認証（2FA）が無効になっているシードされたテスト認証情報と、テスト手順を Google 担当者に提供する必要があります。これにより、Google の審査チームと QA チームは、空のサンドボックス、ペイウォール、2FA チャレンジにブロックされることなく、ツールの実行を検証できます。Google が接続済みアプリを完全にテストできない場合、審査中に否承認となる可能性があります。

ステップ 6: ツールを同期する

接続済みアプリの各バージョンを作成するために、Google は提供されたエンドポイントと同期して、利用可能なツールを取得し、スナップショットを作成します。これらは、そのバージョンのユーザーが利用できるツールです。接続済みアプリのバージョンがプレビュー中で、テスターが利用できる状態でも、サーバーで変更を加え、ツールを再同期して更新できます。これにより、ツールの新しいスナップショットが作成されます。

公開すると、そのバージョンの接続済みアプリにはツールの最新のスナップショットが使用されます。ツール、説明、サーバーの詳細を変更することはできなくなります。ツールを更新する場合や、サーバーから変更を同期する場合は、新しい接続済みアプリのバージョンを作成します。接続済みアプリのバージョンごとに新しいエンドポイントを作成することをおすすめします。

ツールを同期するには:

  1. [ツールを同期する] セクションで、次の操作を行います。

    1. [同期ツール] を選択します。
    2. ログインを求められた場合は、ユーザーに公開する予定のすべてのツールを一覧表示する権限を持つデベロッパー アカウントで認証します。アカウントからアクセスできないツールは同期されません。
    3. 接続されると、Connected Console に同期されたツールの数と [ツールを再同期] ボタンが表示されます。

  2. ページの下部にある [次へ] を選択して、MCP とツールの設定のステップ 2 に進みます。

ステップ 7: ユーザーがアプリをどのように、どこで使用するかを判断する

[MCP とツールの設定] ページの [ツール] セクションで、接続されたアプリが地理的に利用可能な場所、言語、利用可能にする Google サービスなどの基本パラメータを構成します。

  1. [提供状況] の [バージョンを利用可能にする] の横で、次のターゲティング オプションを構成します。
    • 国 / 地域: 接続済みアプリを利用可能にする地理的位置を選択します。
    • 言語: 接続されたアプリがサポートする言語を選択します。
    • プロダクト: 接続済みアプリを利用できる Google サービスを選択します。

  2. [可用性] の後の [ツール] セクションで、MCP サーバーから同期されたツールを確認します。[ツール] リストでツールを選択し、右側の [ツールを管理] パネルで設定を構成します。

    • ツールを有効にする: [ツールを有効にする] スイッチを切り替えて、接続済みアプリにツールを含めるか除外します。無効にしたツールは、接続済みアプリでユーザーが操作できなくなります。

    • 追加のコンテキスト: ツールを動作させるために Google からのコンテキスト シグナルが必要かどうかを選択します。

      • 言語 / 地域: ユーザーの Google アカウントによって決定される言語 / 地域。
      • おおよその位置情報: 3 平方キロメートル以上の範囲内にあるユーザーまたはデバイスの物理的な位置情報（例: ユーザーがいる都市）。
      • 正確な位置情報: ユーザーまたはデバイスの正確な位置情報（誤差 50 メートル以内）。

    • ユーザー確認: ツールを実行する前にユーザーの明示的な確認を必要とする場合は、[ユーザー確認が必要] を選択します（ツールの MCP アノテーションで destructiveHint: true が指定されている場合は、自動的に事前に選択されます）。

  3. MCP サーバーが UI リソースを提供している場合は、[ツール] の横にある [UI リソース] タブに切り替えて、サーバーの UI リソース（text/html、text/html;profile=mcp-app、text/javascript、text/css）を検査し、各リソースにリンクされているツールを確認して、コンテンツ セキュリティ ポリシー（CSP）connectDomains と resourceDomains を確認します。

  4. ページの下部にある [保存] を選択します。

[アプリの詳細] と [MCP とツールの設定] の両方を保存すると、追加したテスターがプレビューで設定を自動的に利用できるようになります。また、概要ページのバージョン ステータスが [テスターが利用可能] に更新されます。

ステップ 8: 接続済みアプリをテストする

接続済みアプリをテスターが利用できるようにするには、[テスターの管理] 画面でテスターを追加する必要があります。未公開の接続済みアプリを表示して操作できるのは、テスターリストに追加したユーザーのみです。テスターとして追加できるのは、@gmail.com アカウントを持つユーザーのみです。

  1. 接続済みアプリの概要ページの [アプリをテストする] カードで、[テスターを追加]（すでに追加している場合は [テスターを管理]）を選択します。

  2. [テスターの管理] 画面で、既存のメーリング リストを選択するか、[メーリング リストの作成] を選択して、統合のテストを許可する Google アカウントを追加します。ご自身でアプリをテストする場合は、ご自身のメールアドレスも忘れずに追加してください。

  3. [保存] を選択します。

  4. Gemini アプリのテスターは、@ に続けて接続済みアプリの名前を入力し、メニューから選択することで、接続済みアプリを呼び出すことができます。Gemini でアプリを表示して接続するには、左側のナビゲーション バーで [設定とヘルプ] → [アプリ連携] に移動します。

  5. 統合を徹底的にテストすることをおすすめします。

    • すべてのプロンプトの例を試します。
    • 明示的な @<AppName> 呼び出しと自然言語クエリの両方をテストします。
    • エンドツーエンドの認証フロー、ツールの実行、ユーザー確認プロンプト、UI リソースを確認します。

テストに問題がなければ、接続済みアプリを Google に送信して審査を受けることができます。

ステップ 9: 接続済みアプリの審査を開始し、承認後に公開する

接続済みアプリをすべてのユーザーが利用できるようにする前に、Google が統合を審査してテストします。

接続済みアプリを送信して審査を受ける手順は次のとおりです。

  1. 接続済みアプリの概要ページの右側にある [リリース] カードで、[審査に送信] を選択します（アプリの設定が完了し、プレビューで問題がなければ有効になります）。

  2. バージョンの審査中は、次のようになります。

    • Connected Console では、編集可能な新しいドラフト バージョンが自動的に作成されるため、テスターはアプリのプレビューを続行でき、デベロッパーは審査を中断することなく今後の編集を準備できます。
    • 審査中のバージョンに対する変更をロックします。
    • 審査中のバージョンの詳細を読み取り専用で表示する場合や、審査をキャンセルする場合は、[審査中] カードのその他オプション（⋮）ボタンを選択し、[アプリの詳細を表示] または [審査をキャンセル] を選択します。

  3. Google による審査が完了すると、通知が届き、[リリース] カードが更新されます。

    • 問題が見つかった場合: [リリース] カードに [問題が見つかりました] と表示されます。[問題を表示] を選択して、特定の審査結果を調べます。編集可能なプレビュー版で構成または MCP サーバーを更新し、テスターで修正を確認して、[審査に送信] を再度選択します。
    • 承認された場合: [リリース] カードに [公開の準備完了] と表示されます。接続済みアプリをユーザーにリリースする準備ができたら、[公開] を選択します。

これで、接続済みアプリが公開され、選択した Google サービス全体でユーザーにロールアウトされています。

公開後の継続的なバージョン管理

公開されると、[リリース] の下にあるカードに、[公開済み] と、接続済みアプリの公開バージョン番号、公開日、対象の国 / 地域、言語、サービスの数が表示されます。[公開済み] カードのその他オプション（⋮）メニューを選択し、[アプリの詳細を表示] を選択すると、いつでもライブ リリースの読み取り専用構成を検査できます。

公開済みのバージョンが製品版で公開されている間、左側の [接続済みアプリの編集とテスト] パネルを使用（または、ドラフトが存在しない場合は [新しいバージョンを作成] を選択）して、新しいバージョン（Version <N+1>）の更新を個別に構成、プレビュー、テストしてから、審査と公開に送信できます。