Claude CodeとGeminiを連携する方法|MCPの設定手順と確認

大規模プロジェクトの開発中、AIがファイル全体の依存関係を把握しきれず、修正が手戻りになってしまうことはありませんか。Claude Codeの機動力は魅力的ですが、コードベースが数万行を超えると、コンテキスト(記憶容量)の制限が開発のボトルネックとなります。
本記事では、Claude Codeの実行力とGeminiの広大な解析力をMCP(Model Context Protocol)で統合し、大規模開発の壁を突破する「AI分業アーキテクチャ」の構築手法を解説します。
なぜ「Claude Code × Gemini」の連携が開発現場で求められるのか
複数のAIを組み合わせることは、単なる機能追加ではなく、開発チームに「専任のスペシャリスト」を増員することと同義です。
Claude Codeが抱える大規模プロジェクトの「コンテキストの壁」とは
Claude Codeは、CLI(コマンドラインインターフェース)を通じて直接ターミナルで作業を実行できる非常に強力なツールです。しかし、どれほど優秀なモデルであっても、一度に処理できる情報の量には物理的な限界があります。数千ファイルに及ぶ大規模なプロジェクトでは、全てのコンテキストをメモリ上に展開しようとすると、重要な文脈が欠落したり、指示の精度が低下したりする「記憶のオーバーフロー」が発生します。
Geminiの「超長大コンテキスト」という強力な武器
Googleが提供するGeminiの上位モデルは、圧倒的なコンテキストウィンドウ(一度に読み込めるデータ量)を誇ります。これは、まるで数万冊の資料を瞬時に読み込む「超人級の調査員」を雇うようなものです。Claude Codeが処理しきれない膨大なソースコード全体をGeminiに読み込ませることで、全体像を俯瞰した正確な解析が可能になります。
エージェントチームにおける「司令塔」と「資料室」の役割分担
効率的な開発体制は、以下のように役割を明確化することで最大化されます。
| 役割 | 担当AI | 得意分野 |
|---|---|---|
| 司令塔 | Claude Code | コードの実装、コマンド実行、ファイルの作成・編集 |
| 資料室 | Gemini | コードベース全体の構造把握、依存関係の解析、長大なドキュメントの要約 |
このように「Claude=実行役」「Gemini=参謀役」という分業体制を敷くことで、大規模開発でも一貫性を維持したまま高速な実装が可能になります。
関連記事:【開発者向け】AIエージェント開発フレームワーク比較と選び方のコツ

MCPを活用してClaude CodeにGeminiを接続する具体的なステップ
MCP(Model Context Protocol)は、AIツール同士を繋ぐ共通言語のような仕組みです。異なるシステム間を翻訳する「仲介者」の役割を果たします。
MCP(Model Context Protocol)が担う「翻訳者」の役割
MCPは、どのAIがどのツールを呼び出すかを標準化するプロトコルです。これを利用することで、Claude CodeからGemini側の検索機能やデータ取得機能を安全かつ直接的に呼び出すことが可能になります。これまでAIごとに閉じていた機能を、一つの連携ツールとして統合できるのです。
claude mcp addでGeminiのMCPサーバーを追加する手順
Claude Codeでは、MCPサーバーを設定ファイルの手書きではなく、claude mcp addコマンドで追加するのが公式の手順です。Claude Codeの公式ドキュメントに載っている基本の形は次のとおりです。
claude mcp add [オプション] <名前> -- <起動コマンド> [引数...]
「--」より後ろは、MCPサーバーを起動するコマンドとしてそのまま渡されます。
Geminiを呼び出すMCPサーバーとして使われている「gemini-mcp-tool」の場合、公式の説明書に載っている追加コマンドは次の1行です。
claude mcp add gemini-cli -- npx -y gemini-mcp-tool
追加先(スコープ)は3種類あり、--scope projectのように指定します。何も付けなければ「ローカル」になります。
| スコープ | 使える範囲 | 保存される場所 |
|---|---|---|
| ローカル(既定) | 今のプロジェクトだけ・自分だけ | ~/.claude.json |
| プロジェクト | 今のプロジェクト・チームで共有 | プロジェクト直下の .mcp.json |
| ユーザー | 自分のすべてのプロジェクト | ~/.claude.json |
APIキーが必要なMCPサーバーを使う場合は、キーをコードや共有する設定ファイルに書かず、--env GEMINI_API_KEY=…のように追加時に渡します。公式ドキュメントによると、--envの直後にサーバー名を置くとキーの続きと読まれて失敗するため、間に--transport stdioなどの別のオプションを挟みます。
Gemini CLIは終了・gemini-mcp-toolは今Antigravity CLIで動く
【2026年11月18日追記】GoogleのGemini CLIは、2026年6月18日に提供を終了しました。
gemini-mcp-toolの公式の説明書には「Gemini CLI is retired. This tool now defaults to Antigravity CLI (agy)」とあり、今は後継のAntigravity CLIを使って動きます。
関連記事:Gemini CLIが6/18終了|急に使えない原因・最短復旧と移行先
接続確認と開発環境での動作テスト
追加できたかは、ターミナルで次のコマンドを実行して確かめます。
claude mcp list
公式ドキュメントによると、サーバーごとに「✔ Connected」(接続済み)や「✘ Failed to connect」(接続失敗)などの状態が表示されます。Claude Codeを起動した画面の中では、/mcpと入力すると同じように状態を確認できます。
プロジェクト(.mcp.json)に追加したサーバーは、最初は「⏸ Pending approval」と表示されます。Claude Codeを起動して承認するまで使えないので、表示が変わらないときはまずここを確認してください。
関連記事:Claude CodeをVS Codeで導入!設定と401エラー対処法

生産性を最大化する「AI分業ワークフロー」の実践例
ツールを導入するだけでなく、運用ルールを定めることで、AIエージェントのパフォーマンスは劇的に向上します。
設計・実装はClaude、複雑な依存関係の特定はGemini
リファクタリング(コードの内部構造の改善)を行う際、まずはGeminiに対して「現在のプロジェクト全体のモジュール依存関係を特定して」と指示を出します。その結果を受け取り、Claude Codeに「この依存関係に基づき、AモジュールをBモジュールから切り離す修正を行って」と指示を出すのです。これにより、人間がファイル間を横断して調査する時間を大幅に削減できます。
コスト管理とAPI利用料を最適化するコツ
全てをGeminiの長大コンテキストに投げるのは経済的ではありません。以下の運用ルールが推奨されます。
- 日常の小規模修正: Claude Code単体で完結させる。
- 大規模調査・エラー分析: Geminiを併用し、深い分析を依頼する。
APIの利用料は従量課金が基本です。利用ログを定期的に確認し、コストパフォーマンスを評価しましょう。
関連記事:【中規模ビジネス向け】Claude Codeの料金体系と主要API比較ガイド

ビジネス現場で必須となるAI利用のセキュリティと運用ルール
企業導入においては、利便性と同じくらいセキュリティが重要です。
社内コードを外部APIへ送信する際の安全対策
Gemini等のAPIを利用する際は、設定画面で「入力されたデータをモデルの学習に使用しない(オプトアウト)」設定が有効になっていることを必ず確認してください。機密情報の取り扱いは、契約内容と規約に基づいた運用が必須です。
APIキーの流出を防ぐための環境管理の鉄則
APIキーは決してGit等のバージョン管理ツールに含めないでください。git-secretsなどのツールを活用し、誤って環境変数をコミットしない仕組みを導入しましょう。また、権限を制限したAPIキー(スコープ制限)を利用することで、万が一の漏洩時にも被害を最小限に抑えられます。

まとめ
Claude CodeとGeminiを組み合わせることで、大規模開発におけるコンテキスト制限という「限界」を、チームによる「分業」で乗り越えることができます。
- Claude Codeは「実行役」として実装を完遂する。
- Geminiは「解析役」として膨大な情報を網羅的に分析する。
- MCPを導入して両者をシームレスに接続する。
- セキュリティとコストを意識した運用ルールを策定する。
まずはGemini APIの無料枠を活用して、既存プロジェクトの一部でMCP接続を試してみてください。今すぐ「AI専任チーム」を構築し、開発の生産性を次のステージへ引き上げましょう。




