接続済みアプリを使用するための前提条件

始める前に、次の準備をしてください。

  • 安全な HTTPS エンドポイントを持つデプロイ済みの MCP サーバー

    MCP サーバーは、Streamable HTTP トランスポート（https://api.yourdomain.com/v1/mcp など）を使用して HTTPS 経由で一般公開されている必要があります。

    実装の詳細については、Connected Apps Platform MCP サーバー デベロッパー ガイドをご覧ください。

  • サーバーが Google からのリクエストを受信できることを確認する

    サーバーが送信元 IP による外部アクセスを制限している場合は、次の IP アドレスを許可リストに登録します。

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Google のアウトバウンド IP 範囲は時間の経過とともに変化する可能性があるため、Google の公開リストから読み取り、許可リストを定期的に更新することをおすすめします。

  • Google Connected Console に登録されているデベロッパー アカウントへのアクセス権

    ログインしたら、Google Connected Console で次のいずれかの Connected Apps 権限があることを確認します。

    • 接続済みアプリを表示する
    • 接続済みアプリの作成と管理

    また、アカウント所有者または管理者が接続済みアプリの利用規約に同意する必要があります。組織が Google Connected Console で接続済みアプリに初めてアクセスするときは、アカウント所有者または管理者がログインしてプログラム契約に同意する必要があります。その後、招待されたチームメンバーが続行できるようになります。

    アクセス権があると思われるのに接続済みアプリを作成できない場合は、アカウント所有者または管理者に、[ユーザーと権限] ページで、ユーザー アカウントに「接続済みアプリの表示」または「接続済みアプリの作成と管理」の権限を付与するよう依頼してください。

  • MCP サーバー ドメインで .well-known 確認ファイルをホストできること

    ドメインの所有権を確認するには、JSON チャレンジトークンファイルを https://<your-domain>/.well-known/google-connected-apps で直接 (HTTP 200 OK を使用し、リダイレクトなし) 提供できる必要があります。

  • 利用可能な接続済みアプリのカテゴリを確認する

    接続済みアプリのカテゴリは、高品質のユーザー エクスペリエンスを保証するためにサポートする必要がある特定の機能に関連付けられています。接続済みアプリのカテゴリを選択すると、変更できなくなります。詳細

  • 有効なエンドポイント URL を持つデプロイ済みの MCP サーバー

    詳しくは、接続済みアプリの MCP サーバー デベロッパー ガイドをご覧ください。

  • 接続済みアプリの一般公開メタデータとブランド アセット

    • 接続済みアプリの名前: Google サービス全体でユーザーに表示される接続済みアプリの表示名。ユーザーが @ でアプリに言及する際にも使用されます。
    • 説明: 接続済みアプリがユーザーに提供できる機能の簡潔な 1 文の要約（30 語未満）。例: 「最近の購入のトラッキング、配送状況の確認、注文履歴の表示」。
    • アイコン: 512 px × 512 px のアプリアイコン。JPEG または PNG 形式で、最大ファイルサイズは 1 MB（1,024 KB）です。
    • 機能: 接続済みアプリが実行できる、アプリのカテゴリで定義されているデフォルト機能以外の価値の高いタスクを 3 つ以上（「注文履歴を検索する」、「配送状況をリアルタイムで確認する」など）。これらの機能はユーザーに表示され、接続するかどうかをユーザーが判断する際の参考となります。機能の先頭に数字を入れないでください。
    • プロンプトの例: ユーザーが質問できる内容を理解できるように、少なくとも 3 つのサンプルクエリ。少なくとも 2 つのサンプル プロンプトを、接続済みアプリの名前で開始します。少なくとも 1 つのプロンプトで、アプリ名を自然に言及します（つまり、アプリ名で開始しない）。プロンプトの例の先頭に数字を付けないでください。
    • 利用規約の URL: 接続済みアプリの利用規約の一般公開 URL。
    • プライバシー ポリシーの URL: 接続済みアプリのプライバシー ポリシーの一般公開 URL。
    • ウェブサイトの URL（省略可）: 接続済みアプリのウェブサイト。