Gemini CLIでMCPを設定・接続する方法｜手順と活用例を解説

#活用方法

2026-06-12

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

GoogleのGemini CLIは、ターミナルから使えるAIエージェントです。MCP（Model Context Protocol）でツールやサービスを接続すると、Gemini CLIが外部のデータを参照したり、ツールを操作したりできるようになります。

この記事では、Gemini CLIにMCPサーバーを設定する手順（settings.json）と、LP最適化プラットフォーム「Squad beyond」を接続してレポートを分析する活用例までを解説します。

MCPそのものの基礎（定義・API連携との違い・マーケティング活用の全体像）は、MCPとは？マーケティングでの活用方法と事例で解説しています。本記事は「Gemini CLIでの接続・活用」に絞って説明します。

1. Gemini CLIのMCPとは
2. Gemini CLIでMCPを使うとできること
3. Gemini CLIでMCPを使うための前提
4. Gemini CLIにMCPサーバーを設定する手順
5. 【実例】Squad beyond MCPをGemini CLIに接続してLPを分析する
6. Gemini CLIでMCPを使うときの注意点
7. Gemini CLIのMCPについてよくある質問（FAQ）
8. まとめ

1. Gemini CLIのMCPとは

MCP（Model Context Protocol）は、AIツールと外部のデータ・ツールを接続するための共通の仕組みです。Gemini CLIでMCPを使うと、Geminiが自分の外側にあるデータ（レポートの数値、ファイル、外部サービスなど）を参照・操作できるようになります。

Gemini CLIはMCPの「クライアント（接続する側）」として動作し、設定したMCPサーバー（接続される側）のツールを呼び出せます。

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

GeminiにMCPサーバーを接続すると、主に次のことができるようになります。

データの取得（参照）：外部サービスのレポートやファイルをGeminiが読み取る
ツールの操作：Geminiから外部ツールに対して、検索・データ更新などを実行する

たとえばWeb検索MCPでリアルタイムの情報を取得したり、レポート系MCPで成果データを参照しながら分析を依頼したりできます。

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

Gemini CLIが利用できる環境：Gemini CLIをインストール済みであること（ターミナルでの操作が前提です）。
設定方法は2通り：gemini mcp add コマンドで追加する方法と、設定ファイル（settings.json）に直接記述する方法があります（次章で解説）。
接続先サービスの対応：接続したいサービスがMCPに対応している必要があります。リモートサーバーの場合は認証（OAuthなど）が必要なことがあります。

どのツールを接続するか迷う場合は、MCP対応ツール・サーバーの選び方と比較で用途別に整理しています。

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

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

最も手軽なのは gemini mcp add コマンドです。トランスポート（接続方式）を --transport で指定します。

# リモートのHTTPサーバーgemini mcp add --transport http <サーバー名> <サーバーURL># ローカルサーバー（コマンドを実行）gemini mcp add <サーバー名> <実行コマンド> <引数...>

既定ではプロジェクト設定に追加されます。ユーザー全体に追加するときは -s user を付けます。
一覧は gemini mcp list、削除は gemini mcp remove <サーバー名> で管理できます。

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

settings.json の mcpServers セクションに直接書く方法もあります。設定ファイルの場所は次のとおりです。

Mac / Linux：~/.gemini/settings.json
Windows：C:\Users\<ユーザー名>\.gemini\settings.json
プロジェクト単位なら、プロジェクト内の .gemini/settings.json

トランスポートごとに使うキーが異なります。

ローカル（STDIO）：command / args / env
リモート（ストリーミングHTTP）：httpUrl
リモート（SSE）：url

{  "mcpServers": {    "サーバー名": {      "httpUrl": "https://example.com/mcp",      "timeout": 5000    }  }}

※環境変数を渡すときは env に明記し、"KEY": "$KEY" のように展開して値をベタ書きしないようにします。

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

OAuthが必要なリモートサーバーは、既定の dynamic_discovery によりサーバーの認証情報を自動検出します。初回接続時にローカルのブラウザが開いて認証され、トークンは ~/.gemini/mcp-oauth-tokens.json に保存されます。認証状態の確認や再認証は /mcp auth コマンドで行えます。

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

設定を変更したら、Gemini CLIを再起動します。
/mcp コマンドを実行し、各サーバーの先頭に緑の●と「Ready」が表示されれば接続完了です。あわせて利用可能なツールも一覧表示されます。
接続できないときは、JSONの構文エラー・OAuth認証の未完了・サーバーの起動失敗を確認します。

設定項目の詳細は、Gemini CLI公式ドキュメント「MCP servers」を参照してください。

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

LP最適化プラットフォームの Squad beyondはMCPに対応しており、Gemini CLIから直接データを参照・分析できます。

5-1. Geminiへの接続

Squad beyondはリモートのHTTPサーバーとして提供されています。gemini mcp add コマンド、または settings.json の httpUrl で登録し、OAuthで認証します。

gemini mcp add --transport http squadbeyond https://squadbeyond-mcp-server-production.squadbeyond.workers.dev/mcp

settings.jsonで設定する場合は次のように記述します。

{  "mcpServers": {    "squadbeyond": {      "httpUrl": "https://squadbeyond-mcp-server-production.squadbeyond.workers.dev/mcp"    }  }}

対応：Gemini CLIが利用できる環境
MCPサーバーURL：https://squadbeyond-mcp-server-production.squadbeyond.workers.dev/mcp
認証方式：OAuth（初回接続時にブラウザが開いて認証。/mcp auth でも認証・再認証できます）

接続後に取得できるデータは、Squad beyond上のアカウント権限に連動します。

接続手順の詳細は、Squad beyond公式ヘルプのMCPの接続・設定方法を参照してください。

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

接続すると、GeminiからSquad beyond上の次のようなデータを扱えます。

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

5-3. 活用例

「今週のレポートを取得して、CVRが高い順にLPをランキングして」

このように自然文で指示するだけで、Geminiがデータを参照してランキング化や分析を行います。媒体別のCVR比較や、週次レポートの下書き生成も同様に依頼できます。

LPのどの指標を見て改善するかは、LP分析で押さえる5つの指標で解説しています。

Squad beyond に無料相談＞＞

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

認証情報の管理：APIキーやトークンは環境変数（env）で管理し、設定ファイルに直書きしないようにします。企業環境では特に推奨されます。
ツールの権限：使用するツールを絞り、書き込みを伴うツールは慎重に扱います。
レート制限：Squad beyond MCPの場合、リクエストは1分間に10回までです（約1分で自動解除）。
権限との連動：取得できるデータはアカウント権限に紐づきます。権限のないデータは参照できません。
使うツールを絞る：includeTools（許可リスト）／excludeTools（除外リスト）で使用ツールを制御できます。trust: true はツール実行の確認を省略するため、信頼できるサーバーに限って使います。
再起動が必要：設定変更後はGemini CLIの再起動が必要です。
つながらないとき：/mcp でサーバーが表示されない場合は、URL・JSON構文・OAuth認証（ローカルブラウザが必要）・timeout（ミリ秒）を確認します。Windowsでローカルサーバーがエラーになるときはコマンドをラップするケースがあります。

書き込みを伴うツールを使う際の注意点は、MCP導入のセキュリティと注意点で詳しく解説しています。

7. Gemini CLIのMCPについてよくある質問（FAQ）

Q. Gemini CLIにMCPサーバーを設定するには？

A. gemini mcp add --transport http <名前> <URL> で追加するか、~/.gemini/settings.json の mcpServers に記述します（ローカルはcommand/args/env、リモートのHTTPは httpUrl）。設定後にGemini CLIを再起動します。

Q. MCPが接続できているか確認するには？

A. /mcp コマンドを実行し、各サーバーに緑の●と「Ready」が表示されれば完了です。表示されない場合はJSON構文・認証・起動状態を確認します。

Q. GeminiでSquad beyondは使えますか？

A. 使えます。Squad beyond MCPはGemini CLIに正式対応しており、settings.jsonにURLを登録しOAuthで認証すれば、レポート取得やCVR分析を依頼できます。

Q. 設定が反映されないときは？

A. Gemini CLIの再起動が必要です。再起動後に /mcp で接続状態を確認し、JSONの構文エラーがないかもあわせて確認します。

8. まとめ

Gemini CLIはMCPに対応しており、ツールやサービスを接続すれば、ターミナルからAIが外部データを直接参照・操作できるようになります。

設定は gemini mcp add コマンド、または ~/.gemini/settings.json の mcpServers に記述する
ローカルはcommand/args/env、リモートのHTTPは httpUrl（SSEは url）。OAuthは初回接続時にブラウザで認証し、変更後は再起動する
Squad beyond MCPに対応しており、レポート取得やLP分析を自然文の指示だけで実行できる

まずはWeb検索やレポート系のサーバーを1つ設定し、/mcp で接続を確認するところから始めてみてください。