leango
ツールの使い方

Gemini CLIでMCPを設定する方法｜settings.jsonの書き方と活用例を解説

Gemini CLIでMCPを設定する方法｜settings.jsonの書き方と活用例を解説

この記事でわかること

本記事では、Gemini CLIでMCPを設定する手順を、settings.jsonの場所（グローバルとプロジェクト別）・mcpServersの書き方・ローカルとリモートの指定の違い・環境変数の展開まで解説します。Gemini CLIから自社データを分析させたい方が、設定でつまずかずに接続できる内容です。

「Gemini CLIでMCPを使いたいが、設定ファイルをどこに置けばいいのかわからない」とお困りではないでしょうか。

Gemini CLI のMCP設定は settings.json の mcpServers に書きます。グローバル設定とプロジェクト別設定の2箇所があり、どちらに置くかで適用範囲が変わります。

本記事では、Gemini CLIでMCPを設定する手順と、Google広告のデータ分析に使う実践的な組み合わせまで解説します。

記事のポイント

  • settings.json の2つの置き場所と使い分け
  • mcpServers の書き方（ローカル / リモート）
  • 環境変数が自動展開される仕組みとセキュリティ上の利点
  • Gemini CLI がMCPサーバーを見つける流れ
  • Google広告MCPと組み合わせる実践例

目次

  • Gemini CLIのMCP設定ファイルの場所
  • mcpServers の書き方
  • 環境変数の扱い
  • Gemini CLI がMCPサーバーを認識する流れ
  • Google広告MCPと組み合わせる
  • つながらないときの確認ポイント
  • セキュリティ上の注意
  • よくある質問
  • まとめ

Gemini CLIのMCP設定ファイルの場所

Gemini CLI のMCPサーバー設定は、settings.json の mcpServers キーの下に記述します。置き場所は2つあります（出典: Gemini CLI 公式ドキュメント（MCP サーバー））。

種別パス適用範囲
グローバル設定~/.gemini/settings.jsonすべてのプロジェクト
プロジェクト別設定<プロジェクト>/.gemini/settings.jsonそのディレクトリ内のみ

使い分けの目安は次のとおりです。

  • 自分がいつも使うサーバー（ファイル操作・検索など）→ グローバル
  • 特定の案件のデータにだけ繋ぐサーバー → プロジェクト別

プロジェクト別に置くと、その案件のディレクトリを離れれば接続対象から外れます。 複数のクライアントのデータを扱う場合、混線を防ぐ意味でプロジェクト別のほうが安全です。

mcpServers の書き方

ローカルサーバー（stdio）の場合

自分のPC上でサーバーを起動する形です。command と args を指定します。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/work"
      ]
    }
  }
}

args の後半に並ぶパスが、そのままアクセス許可の範囲になります。必要最小限のディレクトリだけを渡してください。

リモートサーバーの場合

提供元のクラウドで動いているサーバーに繋ぐ形です。httpUrl を指定します。

{
  "mcpServers": {
    "example-remote": {
      "httpUrl": "https://mcp.example.com/mcp"
    }
  }
}

認証が必要な場合はヘッダーを渡せます。トークンを直書きせず、後述の環境変数展開を使ってください。

対応しているトランスポート

Gemini CLI は接続時に、次のトランスポートを適切に選択します。

  • Stdio — ローカルプロセスとの標準入出力による通信
  • SSE — Server-Sent Events
  • Streamable HTTP — リモートサーバー向けの標準的な方式

MCPの現行仕様（2026-07-28）で定義されているのは stdio と Streamable HTTP の2つです。SSE は以前の版で使われていた方式で、提供元が古い実装のままの場合に使われます。

環境変数の扱い

Gemini CLI は、MCPサーバー設定の env ブロック内の環境変数を自動的に展開します。

{
  "mcpServers": {
    "example": {
      "command": "npx",
      "args": ["-y", "some-mcp-server"],
      "env": {
        "API_TOKEN": "$MY_API_TOKEN"
      }
    }
  }
}

これにより、シェルや環境側で定義した変数を参照できるため、機密情報を settings.json に直接書き込む必要がなくなります。

settings.json はプロジェクトのディレクトリに置くとリポジトリに含まれる可能性があります。トークンを直書きするとGitにコミットされる事故が起きます。 環境変数の展開はこれを避けるための仕組みです。

Gemini CLI がMCPサーバーを認識する流れ

Gemini CLI のMCP統合は、次の流れで動きます。

  1. settings.json の mcpServers に書かれたサーバーを順番に処理する
  2. 適切なトランスポート（Stdio / SSE / Streamable HTTP）で接続を確立する
  3. MCPプロトコルで各サーバーからツール定義を取得する
  4. 取得したツールのスキーマを Gemini API 互換に整形・検証する

4番目の工程があるため、MCPサーバー側のスキーマが特殊だと、そのツールだけ認識されないことがあります。 「他のクライアントでは動くのに Gemini CLI だと出ない」場合はここが原因の候補になります。

Google広告MCPと組み合わせる

Gemini CLI と相性がよい組み合わせが Google Ads MCP Server です。Googleが公式にオープンソースで公開しており、対応クライアントの例として Gemini が挙げられています。

提供されるツールは3つです。

ツール内容
list_accessible_customersアクセス可能なGoogle Ads顧客IDとアカウント名の一覧
searchGAQL（Google Ads Query Language）を実行してメトリクス・予算・ステータスを取得
get_resource_metadataGoogle Ads APIリソースタイプのメタデータを取得

重要な制約として、この実装は厳格に読み取り専用です。 入札の変更、キャンペーンの停止、アセットの新規作成はできません。

必要な前提は、22文字の開発者トークン、プロジェクトID、OAuth認証情報またはサービスアカウントです。詳細は「Google広告MCPとは？できることと接続手順・読み取り専用という制約を解説」で解説しています。

実際の使い方

接続後、次のように依頼できます。

先月のキャンペーン別のCPAとコンバージョン数を取得して、CPAが悪化した上位5件を挙げてください。実行したGAQLクエリも表示してください。

GAQLクエリを必ず出力させてください。 期間の指定や指標の取り違えは、クエリを見ないと検出できません。AIの要約だけを信用すると、集計期間がずれた数字で判断してしまいます。

つながらないときの確認ポイント

症状確認すること
サーバーが認識されないsettings.json のJSON構文 / 置き場所（グローバルかプロジェクトか）
一部のツールだけ出ないスキーマが Gemini API 互換に整形できているか
認証エラー環境変数が実際に展開されているか（echo $MY_API_TOKEN で確認）
ローカルサーバーが起動しないcommand を単体でターミナル実行してエラーを見る
リモートサーバーに繋がらないhttpUrl の末尾が提供元の指定どおりか

プロジェクト別設定を置いている場合、実行しているディレクトリが正しいかを最初に確認してください。 別のディレクトリから起動すると、その設定は読まれません。

セキュリティ上の注意

ローカルMCPサーバーは、MCPクライアントと同じ権限で任意のコードを実行できます。 公式のセキュリティ文書は、設定ファイルに悪意ある起動コマンドを埋め込む攻撃を具体例つきで挙げています。

  • 出所の分からないサーバーを settings.json に書かない
  • アクセスを許可するディレクトリは必要最小限にする
  • トークンは環境変数で渡し、設定ファイルに直書きしない
  • プロジェクト別設定ファイルをリポジトリにコミットする場合、中身に機密情報が無いか確認する

詳細は「MCP導入のセキュリティリスクと対策」で解説しています。

よくある質問

Q. Gemini CLI の settings.json はどこに置けばいいですか？

A. すべてのプロジェクトで使うならホームディレクトリの ~/.gemini/settings.json、特定の案件だけで使うならそのプロジェクト内の .gemini/settings.json です。プロジェクト別に置くと、そのディレクトリを離れれば接続対象から外れます。

Q. リモートMCPサーバーとローカルMCPサーバーで書き方が違いますか？

A. 違います。ローカルは command と args、リモートは httpUrl を指定します。接続先がどちらなのかは提供元のドキュメントで確認してください。

Q. Gemini CLI で MCP を使うのに有料プランは必要ですか？

A. Gemini CLI 自体の利用条件と、接続先のMCPサーバー側の条件の両方に依存します。例えば Squad beyond MCP は Gemini CLI については Enterprise プランのみ対応としています。接続先の提供元のドキュメントを確認してください。

Q. トークンを settings.json に直接書いても大丈夫ですか？

A. 推奨されません。Gemini CLI は env ブロック内の環境変数を自動展開するため、$MY_API_TOKEN のように参照する形にしてください。プロジェクト内の設定ファイルはリポジトリに含まれる可能性があるため、直書きは事故につながります。

まとめ

Gemini CLIでMCPを設定する要点は次の3つです。

  • 設定は settings.json の mcpServers。グローバル（~/.gemini/）とプロジェクト別（<project>/.gemini/）の2箇所があり、案件ごとに分けるならプロジェクト別が安全
  • ローカルは command / args、リモートは httpUrl。トランスポートは Stdio / SSE / Streamable HTTP に対応
  • env の環境変数は自動展開される。トークンは直書きせず環境変数で渡す

Gemini CLI は取得したツールスキーマを Gemini API 互換に整形するため、他のクライアントで動くツールが認識されないことがあります。 その場合はスキーマ側を疑ってください。

MCPの基礎は「MCPとは？マーケティング業務での活用方法と2026年最新仕様」で解説しています。

CVR改善ならDejam！広告分析の次の一手を実行に移す

Dejamは、LP制作・ヒートマップ分析・ABテスト・AI自動解析をオールインワンで提供するCVR改善特化ツールです。Google広告の数字が悪化した原因がLP側にある場合、その改善を担います。

Dejamが選ばれる理由

  • 広告データとLPの効果を同じ画面で見比べられる: 広告ダッシュボードでGoogle広告・Meta広告など複数媒体を一元管理
  • 分析から実行までワンプロダクト: LP制作・ヒートマップ分析・ABテストを単一ツールで完結
  • 月額3万円〜利用可能: PV数に応じた従量課金
  • ユーザー課金なし: 何名で使っても追加費用は発生しない
  • ISMS認証取得: ISO/IEC 27001:2022 認証取得済み

Dejam は2026年9月時点でMCPサーバー・公開APIを提供していません。 Gemini CLI からDejamのデータを直接参照することはできず、AIによる改善案の提示はツール内のCROサジェストで提供しています。

Dejamの詳しい機能を見る →　無料トライアルを申し込む →

タグ: AIマーケティング 広告運用 MCP 生成AI AI活用 Model Context Protocol Gemini

この記事の監修者

平井 翔吏

平井 翔吏

株式会社LeanGo 代表取締役CEO / Dejamプロダクトオーナー

CVRを改善するノウハウを体系化するプロフェッショナル。

株式会社リクルートホールディングスに新卒入社、ゼクシィのUXデザインを担当。累計250件以上の施策を実施しCVR改善を140%達成。タグ検索の開発やゼクシィ花嫁割のリブランディングなどのプロジェクトオーナーとして事業を推進した。

株式会社LeanGoを設立。CVR改善ツールDejamのプロダクトオーナー。運用型LPOやセグメントCVRなど独自のメソッドを構築、PDCAハンドスピナーをはじめとするプロモーションも実施している。日本最高峰のダイレクトマーケティングカンファレンス「ダイレクトアジェンダ2025」「ダイレクトアジェンダ2026」のAgenda awardにて2連覇。

関連記事

ツールの使い方

Notion MCPとは？設定方法と外部AIツールから使う手順を解説

ツールの使い方

ChatGPTでMCPを使う方法｜Developer modeの接続手順と活用例を解説

ツールの使い方

Squad beyond MCPとは？できることと接続手順・料金の考え方を解説

ツールの使い方

ClaudeでMCPを接続する方法｜設定ファイルの書き方とトラブル対処を解説

「ツールの使い方」の他の記事をみる

この記事に関連するDejamの機能

あわせて読みたいお役立ち資料

CVR改善にお悩みの方へ

サイトのコンバージョン改善を進めるなら、ABテスト・ヒートマップ・LP制作機能が揃ったCVR改善ツール Dejam をぜひご活用ください。データに基づいたPDCAで、成果につながる改善を実現できます。

「ツールの運用リソースが足りない」「改善の方向性から一緒に考えてほしい」という場合は、専門家が伴走する CVR改善コンサルティング もご利用いただけます。

Dejamに無料でお問い合わせ CVR改善コンサルティングを見る
ブログ一覧に戻る
Dejamで無料トライアル
CVR改善機能を見る

CVR改善ツールならDejam

自信があるから、
無料でお試し。正直、悩むより導入した方が早い。

ヒートマップの読みやすさも、ABテストの作りやすさも、機能一覧を並べただけでは分かりません。自社のサイトに入れて、実際のユーザーの動きを見て、はじめて判断できることばかりです。

  • 契約前に実際の画面を触れる
  • ご相談だけでもOK
  • 相談の時点で費用はゼロ

どれを試したいですか？

サービスの導入相談も可能です

お問い合わせ前に、気になる点はありますか？

無料トライアルを申し込む