Gemini MCPの設定・連携方法｜CLI・API・アプリ

｜広告運用ノウハウ公開中！

より詳しく知りたい方は資料をダウンロード！

GeminiにMCPサーバーをつなぎたいのに、Gemini CLIの設定ファイルの話もあれば、Geminiアプリの話もあり、自分の使っているGeminiでできるのか分からなくなっていませんか。

GeminiでMCP（Model Context Protocol）を使えるかどうかは、製品によって違います。2026年10月時点の公式ドキュメントでは、Gemini CLI、Gemini Code Assist、Gemini API、Gemini Enterpriseで、MCPサーバーをつなぐ方法が案内されています。Geminiアプリは米国・英語のみなどの条件つきで、Gemini CLIは2026年6月18日から組織向けの提供に変わりました。

この記事では、製品ごとの対応状況を整理したうえで、Gemini CLIでMCPサーバーを設定する手順と、LP最適化プラットフォーム「Squad beyond」をつないでレポートを分析する例を解説します。MCPそのものの基礎は、MCPとは？マーケティング業務を効率化する活用方法と事例を解説で解説しています。

1. GeminiでMCPは使える？製品別の対応状況

1-1. MCPとは

MCPは、AIアプリケーションを外部のシステムにつなぐためのオープンソースの標準です。AIアプリはMCPを通じて、ファイルやデータベースなどのデータ、検索エンジンなどのツールにつながります（出典：What is the Model Context Protocol (MCP)?｜Model Context Protocol）。AIの側を「クライアント」、データやツールを提供する側を「MCPサーバー」と呼びます。

1-2. 製品別の早見表

製品	役割	設定する場所	条件・制限
Gemini CLI	クライアント	gemini mcp add か settings.json	Gemini Code Assist Standard・Enterprise など（1-3）
Gemini Code Assist（IDEのエージェントモード）	クライアント	VS Code：~/.gemini/settings.json／IntelliJ：mcp.json	プレビュー版
Geminiアプリ（gemini.google.com）	クライアント	設定の「Connected Apps」	米国の18歳以上・個人アカウント・英語のみ
Gemini API（Interactions API）	クライアント	tools に MCPサーバーのURL	ストリーミング可能なHTTPのみ（SSE不可）
Gemini Enterprise	クライアント	管理者がカスタムMCPサーバーを接続	StreamableHTTPのみ（SSE不可）
Gemini Cloud Assist	サーバー	他のAIツールから呼び出す	限定公開プレビュー

（2026年10月29日に各製品の公式ドキュメント・公式ヘルプで確認）

• Gemini CLI：手順は4章で解説します（出典：MCP servers with Gemini CLI｜Gemini CLI）
• Gemini Code Assist：VS Code では ~/.gemini/settings.json に書いてウィンドウを再読み込みします。VS Code のエージェントモードは Gemini CLI を使っています（出典：Gemini Code Assist エージェント モードを使用する｜Google Cloud Documentation）
• Geminiアプリ：Web版でMCPサーバーのURLを入れてカスタムアプリを追加し、モバイルアプリでも使えます。条件は表のとおりで、Keep Activity をオンにする必要もあります（出典：Connect & manage custom apps for Gemini Apps｜Gemini アプリ ヘルプ）
• Gemini API：tools に type "mcp_server" とサーバーのURLを指定します。サーバー名は「-」を使わず snake_case にします（出典：Gemini API を使用した関数呼び出し｜Google AI for Developers）
• Gemini Enterprise：管理者が Google Cloud コンソールで「カスタム MCP サーバー」を追加します。既定では組織のポリシーで作成がブロックされています（出典：カスタム MCP サーバーのデータストアを設定する｜Google Cloud Documentation）
• Gemini Cloud Assist：Cloud Assist の機能を、MCPで Antigravity や Gemini CLI などから使えます。利用には申し込みが必要です（出典：MCP を使用して Gemini Cloud Assist をサードパーティ製ツールと統合する｜Google Cloud Documentation）

日本でGeminiアプリにカスタムのMCPサーバーをつなげる時期は、公式ヘルプに記載がありません。

1-3. 個人の無料利用と Google AI Pro・Ultra は Antigravity CLI へ

2026年6月18日に、Gemini CLI は Google AI Pro・Ultra と、Gemini Code Assist for individuals で無料で使う人へのリクエストの処理を止めました。Gemini Code Assist Standard・Enterprise のライセンスを使う組織、Google Cloud 経由の Gemini Code Assist for GitHub、有料の Gemini API キーなどでは引き続き使えます（出典：An important update: Transitioning Gemini CLI to Antigravity CLI｜Google Developers Blog）。個人で使う場合は、AntigravityでMCPを設定・接続する方法｜手順と活用例を解説を参考にしてください。

1-4. Gemini CLIのMCPとは

Gemini CLIは、ターミナルで使えるGoogleのAIエージェントです。MCPのクライアントとして動き、設定したMCPサーバーのツールを呼び出します（出典：MCP servers with Gemini CLI｜Gemini CLI）。

2. Gemini CLIでMCPを使うとできること

MCPサーバーをつなぐと、Gemini CLIは次の3つができるようになります（出典：MCP servers with Gemini CLI｜Gemini CLI）。

• ツールを見つける：サーバーが提供するツールの一覧と説明を読み取る
• ツールを実行する：値を渡してツールを呼び出し、結果を受け取る
• リソースを読む：サーバーが公開しているファイルやレポートなどを読み取る（チャットで「@」から選べる）

つないだあとは、Gemini CLIに頼むだけで、Geminiが合うツールを選んで呼び出します。どのサービスをつなぐか迷う場合は、MCP対応ツール・サーバーおすすめ比較｜選び方とカテゴリ別一覧で用途別に整理しています。

3. Gemini CLIでMCPを使うための前提

• 使えるアカウント：Gemini Code Assist Standard・Enterprise のライセンス、有料の Gemini API キーなど（1-3）
• インストール：npm install -g @google/gemini-cli か brew install gemini-cli（出典：google-gemini/gemini-cli｜GitHub）
• つなぎ方は3種類：自分のPCで起動するStdio、SSE、ストリーミング可能なHTTP（出典：MCP servers with Gemini CLI｜Gemini CLI）

4. Gemini CLIにMCPサーバーを設定する手順

設定は、gemini mcp add コマンドで追加するか、settings.json に直接書くかのどちらかです。どちらも settings.json の mcpServers に保存されます（出典：MCP servers with Gemini CLI｜Gemini CLI）。

4-1. コマンドで追加する（gemini mcp add）

書式は gemini mcp add [オプション] <名前> <コマンドかURL> です。リモートのHTTPサーバーなら gemini mcp add --transport http <名前> <URL>、SSEなら --transport sse にします（出典：同上）。

オプション	意味	既定
-t, --transport	stdio・sse・http	stdio
-s, --scope	保存先（user か project）	project
-e, --env ／ -H, --header	環境変数／HTTPヘッダー	—
--trust	ツール実行の確認を省略	—

保存先は、指定しなければプロジェクトの .gemini/settings.json、-s user ならユーザーの ~/.gemini/settings.json です。確認は gemini mcp list、削除は gemini mcp remove <名前> です。

4-2. 設定ファイル（settings.json）で記述する

ユーザーの設定は ~/.gemini/settings.json（~ はホームディレクトリ）で、すべてのセッションに効きます。プロジェクトの設定はルートの .gemini/settings.json で、そのプロジェクトから起動したときだけ効きます（出典：Gemini CLI configuration｜Gemini CLI）。

サーバーごとに、ローカルなら command（引数は args、環境変数は env）、リモートのHTTPなら httpUrl、SSEなら url を書きます。例は {"mcpServers": {"サーバー名": {"httpUrl": "https://example.com/mcp"}}} です。timeout（既定は600,000ミリ秒）、includeTools・excludeTools（使うツールの許可・除外）も指定できます（出典：MCP servers with Gemini CLI｜Gemini CLI）。

4-3. リモートサーバーの認証（OAuth）

OAuthに対応したサーバーは、設定を書かなくてもGemini CLIが認証の情報を自動で探し、ブラウザを開いてログインを求めます。トークンは ~/.gemini/mcp-oauth-tokens.json に保存されます。/mcp auth <名前> で認証や再認証ができます。認証には手元のPCでブラウザを開ける必要があり、ブラウザの無い環境やSSH接続の先では動きません（出典：MCP servers with Gemini CLI｜Gemini CLI）。

4-4. 設定の反映と確認

Gemini CLIの中で /mcp を実行すると、サーバーの接続状態（CONNECTED・CONNECTING・DISCONNECTED）と使えるツールが表示されます（出典：MCP servers with Gemini CLI｜Gemini CLI）。/mcp reload では、すべてのMCPサーバーを読み込み直してツールを探し直せます（出典：CLI commands｜Gemini CLI）。

5. 【実例】Squad beyond MCPをGemini CLIに接続してLPを分析する

LP最適化プラットフォームのSquad beyondは、AIツールとつなぐ「Squad beyond MCP」を提供しています。AIからSquad beyondのデータを参照・調査・分析できる機能で、料金はご利用プランによって異なります（出典：Squad beyond MCPについて｜Squad beyond FAQ）。

5-1. Gemini CLIへの接続

Squad beyondのFAQでは、Gemini CLIについて「Enterpriseプランのみ利用可能です」と書かれています。接続の手順は次のとおりです（出典：同上）。

1. gemini --version でバージョンが返ってくることを確かめる
2. gemini mcp add -t http squadbeyond https://mcp.mysquadbeyond.com/mcp を実行する（「MCP server "squadbeyond" added to project settings. (http)」と表示される）
3. Gemini CLIを起動し、/mcp auth squadbeyond と入力する
4. ブラウザで「Approve」を押し、次の画面で許可する
5. 「Successfully authenticated with MCP server 'squadbeyond'!」と表示されれば完了

このコマンドでは今いるフォルダの設定に保存されるため、別のフォルダからも使うなら -s user を付けます（4-1）。取得できるデータは、Squad beyond上の権限に紐づいています。ほかのAIツールでの設定方法も同じFAQに載っています。

5-2. Geminiからできること

Squad beyond MCPでは、AIから次のような作業ができます（出典：Squad beyond MCPについて｜Squad beyond FAQ）。

• 日次・週次・月次のレポートデータ（PV・CV・CVRなど）の取得
• ページごとのCVRや流入元、離脱状況などのパフォーマンス分析
• ステータスやフォルダ単位での、beyondページの一覧の取得
• Branch Operation（バージョン×クリエイティブの掛け合わせ）の分析

FAQの活用例には、記事（バージョン）の作成、HTMLのアップロード、下書きの本番への反映、配信割合の変更といった操作も載っています（出典：MCPの活用方法について｜Squad beyond FAQ）。

5-3. 活用例

FAQでは、CVRをもとにした成果の高いLPのランキング、媒体ごとのCVRの比較、週次レポートの作成、配信ステータスの一覧化といった使い方が紹介されています（出典：Squad beyond MCPについて｜Squad beyond FAQ）。プロンプトの例には「folder_uidが『xxxx』のフォルダ内の全beyondページの先月レポートを取得し、CVRが高い順にランキングを作成して」があります（出典：MCPの活用方法について｜Squad beyond FAQ）。

LPのどの指標を見て改善するかは、LP分析の5つの指標｜陥りがちな失敗と分析方法で解説しています。

6. Gemini CLIのMCPがつながらない失敗例3つ

6-1. 別のフォルダで起動すると、追加したサーバーが出てこない

• 症状：gemini mcp add のあと別のフォルダで起動すると、/mcp にサーバーが出てこない
• 原因：保存先は既定でプロジェクトの設定で、そのプロジェクトの外では効かない（出典：Gemini CLI configuration｜Gemini CLI）
• 対策：-s user を付けて追加し直す
• 回避策：どこでも使うサーバーは最初から -s user で追加する

6-2. 信頼していないフォルダで確かめると、ローカルのサーバーが Disconnected になる

• 症状：gemini mcp list で確かめると、動くはずのローカルのサーバーが Disconnected と出る
• 原因：command で起動するサーバーは、フォルダが信頼済みのときだけ接続を確かめる（出典：MCP servers with Gemini CLI｜Gemini CLI）
• 対策：中身を確かめたうえで gemini trust で信頼する
• 回避策：ローカルのサーバーは信頼済みの作業フォルダで使う

6-3. SSHやコンテナの中で認証すると、OAuthが進まない

• 症状：SSHやコンテナの中で /mcp auth を実行すると、ブラウザが開かず認証が終わらない
• 原因：OAuthは手元のPCでブラウザを開き、リダイレクトを受け取る必要がある（出典：同上）
• 対策：ブラウザを開けるPCのターミナルで認証する
• 回避策：OAuthのサーバーを使う作業は、最初からブラウザのあるPCで行う

7. Gemini CLIでMCPを使うときの注意点

• APIキーは環境変数で渡す：Gemini CLIは、TOKEN・SECRET・KEY などを名前に含む環境変数をMCPサーバーに自動では渡しません。渡す値は env に "MY_KEY": "$MY_KEY" のように書き、直接書き込まないようにします（出典：MCP servers with Gemini CLI｜Gemini CLI）
• trust は自分で管理するサーバーだけ：trust: true はツール実行の確認をすべて省略するため、公式ドキュメントでは完全に自分で管理しているサーバーだけに使うよう注意されています（出典：同上）
• Squad beyond MCPの制限：リクエストは1分間に10回まで（上限に達しても自動で解除）。データは権限に紐づきます（出典：Squad beyond MCPについて｜Squad beyond FAQ）

Squad beyond MCPは配信割合の変更や本番への反映もできるため、こうした操作は「常に許可」にせず、確認の画面で中身を確かめてから実行します。詳しくはMCP導入のセキュリティリスクと注意点｜安全に使うためのチェックリストで解説しています。

8. GeminiのMCPについてよくある質問

9. まとめ｜使っているGeminiの製品と条件から確かめる

• GeminiでMCPを使えるかは製品で違う。Gemini CLI・Gemini Code Assist・Gemini API・Gemini Enterpriseはつなげる。Geminiアプリは米国・英語のみなどの条件つき
• Gemini CLIは2026年6月18日から組織向け。無料の個人利用と Google AI Pro・Ultra は Antigravity CLI を使う
• 設定は gemini mcp add（既定の保存先はプロジェクト）か settings.json の mcpServers。OAuthは /mcp auth <名前>、確認は /mcp

GeminiのMCPまわりの提供範囲は変わることがあります。設定するときは、この記事で出典にしている公式ドキュメントの最新の内容もあわせて確認してください。

　

Squad beyondサービス紹介資料はこちらからダウンロード