Documentation menu

Geminiを接続する

どの手順が当てはまるかは、Geminiをどう使っているかによって異なります: 一般消費者向けアプリ(Spark)、組織を通じたGemini Enterprise、あるいはAntigravity CLIです。自分に当てはまるものを以下から選んでください。

Geminiアプリ(Spark)

  1. gemini.google.com → Settings & help → Connected apps → Custom apps for Spark → Add a custom appに移動します。
  2. サーバーURLとしてhttps://mailinapp.com/api/mcpを貼り付けます。
  3. Geminiが開くMailInAppの同意画面を承認します——必要ならサインインし、複数のアカウントに所属している場合はどのアカウントとして接続するかを選び、スコープを選択して(スコープと権限を参照)、承認します。

これだけです——提出やレビューは必要なく、ClaudeやChatGPTを接続するのと同じです。Custom apps for Sparkが選択肢として表示されない場合、それはMailInApp側の問題ではなくGoogle側の利用資格のゲートです: Googleは現在、カスタムSparkアプリを米国内在住、18歳以上の個人のGoogleアカウントで、「アクティビティを保存」がオン、かつGeminiアプリの言語設定が英語に限定しています。この条件に当てはまらない場合、この選択肢自体が表示されません。

Gemini Enterprise(組織経由)

会社がGemini Enterpriseを使用している場合、一般消費者向けアプリのように自分でMailInAppを追加することはできません——これはデフォルトで組織のポリシーによりオフになっており、有効化はあなたのWorkspace管理者が一度だけ行うセットアップです。以下の詳細を管理者に伝えてください:

  • Authorization URL: https://mailinapp.com/oauth/authorize
  • Token URL: https://mailinapp.com/oauth/token
  • Scopes: スコープと権限の任意の組み合わせをスペース区切りで。
  • PKCE: オン(S256)。
  • Client id / secret: Gemini Enterpriseのテナントが使用するリダイレクトURIを添えて[email protected]宛にメールしてください。管理者が入力するためのクライアントIDを発行します。

管理者がこのセットアップを済ませれば、Gemini Enterprise経由でMailInAppに接続して使うことは、他のどのアシスタントとも同じです——サインインし、アカウントを選び、スコープを選び、承認します。

Antigravity CLI

Geminiアプリではなく(Gemini CLIの後継である)Antigravity CLIを使っている場合は、設定画面ではなく設定ファイルにMailInAppを追加します。mcp_config.json(または.agents/mcp_config.json)にエントリを追加してください:

{
  "mcpServers": {
    "mailinapp": {
      "url": "https://mailinapp.com/api/mcp"
    }
  }
}

Antigravity CLIは、最初に接続する際に他のどのクライアントとも同じOAuth同意画面を開きます。

接続がうまくいかない場合

  • "Add a custom app"がConnected Appsに見当たらない——これはMailInApp側ではなく、Google自身の利用資格のゲートです: Sparkのカスタムアプリ機能には、米国内在住、18歳以上の個人のGoogleアカウント、「アクティビティを保存」がオン、Geminiアプリの言語設定が英語であることが必要です。MailInApp側に何の問題がなくても、この条件に当てはまらない限りこの選択肢はまったく表示されません。
  • Enterprise接続が管理者の設定で拒否される——MailInAppが発行したclient id/secretは、セットアップ時にあなたのテナントが提供した正確なリダイレクトURIに紐づいています。このURIが変わった場合は、古いクライアントを使い続けるのではなく、管理者から[email protected]へ新しいURIを添えてメールしてもらってください。
  • Antigravity CLIが接続エラーを報告する——mcp_config.jsonが正しいJSONであること、urlフィールドが正確にhttps://mailinapp.com/api/mcpと記載されていることを確認してください。mcpServersオブジェクトの記述ミスが最も多い原因です。
  • チームを移った、またはチームメイトにアクセスを取り消された——他のすべてのプラットフォームと同様、Geminiコネクタのトークンは呼び出しごとにあなたの現在のアカウントメンバーシップに対して再検証されるため、ある会社へのアクセスを失うと、Gemini側で何もしなくても、その接続の呼び出しは即座に無効になります。

取り消し

どのGeminiの窓口から接続したかにかかわらず、MailInAppダッシュボードのConnections(/dashboard/connections)には、他のすべてのアシスタントと並んでワンクリックのRevokeとともに一覧表示されます——トークンは次の呼び出しから使えなくなります。