クイックサマリー: Google Cloud Developer Pluginは、Claude CodeにGoogle Cloudの開発手順と公式ドキュメントへのアクセス経路を追加するプラグインです。対応CLIはClaude Codeで、SkillsとMCPという2つの経路を通じて、Google Cloud・Firebase・Android・Mapsなどの公式情報を必要なタイミングで参照できるようになります。ライセンスはGoogleが公開している「Google Agent Skills」リポジトリの一部として提供されるオープンな配布物です。
Claude CodeでGoogle Cloud関連の実装を依頼したとき、他の依頼より手戻りが多いと感じたことはないでしょうか。原因はモデルの能力ではなく、渡している情報の鮮度にあることが多いです。Google Cloudはプロダクト数が多く更新も速いため、モデルの学習時点の知識と現在の作法にズレが生じやすいという事情があります。Google Cloud Developer Pluginは、この「どの知識をいつ渡すか」という管理をプラグイン側に肩代わりさせる仕組みです。この記事では、プラグインの構成・インストール手順・実際の開発フローでの活用例までをまとめます。
- Google Cloud Developer Pluginの構成要素（Skills / MCP）と役割分担
- Claude Codeへのインストールと認証設定の具体的な手順
- 実際の依頼でどのようにSkillとMCPが呼び出されるかの実例
- Agents CLI・ADK Docs MCPなど類似手段との使い分け
Google Cloud Developer Pluginで何ができるか
プラグインの役割は、Google Cloudを使った開発に必要な知識と手順をClaude Codeに提供することです。構成要素は次の3つに分かれます。
- Google Cloud向けSkills: プロジェクトや認証の準備など、設定や作業の手順を与える
- finding-google-skills: 依頼内容に合うGoogle製品のSkillをカタログから探す
- Developer Knowledge MCP: APIの使い方や設定条件など、Google公式の開発資料を検索・取得する
Skillは「作業の進め方」を得る経路、MCPは「技術情報を調べる経路」という住み分けです。公開されている定義を確認すると、v1.1.4時点で同梱されるSkillは5つでした。依頼に合うSkillを探すfinding-google-skills、gcloudコマンドの安全性を検証するgcloud、最初のプロジェクト作成を案内するgoogle-cloud-recipe-onboarding、認証方式の選択を助けるgoogle-cloud-recipe-auth、Developer Knowledge MCPの使い方を伝えるretrieving-developer-knowledgeです。全Skillの本文を事前に読み込む設計ではなく、依頼に応じてオンデマンドで該当するSkillだけを読み込む点が特徴です。ユーザー側が最初からSkill名を把握している必要はありません。
インストール・有効化手順
導入は大きく3ステップです。コマンドは公式手順に沿ったものを記載します。
Step 1: プラグインをインストールする
claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-pluginsStep 2: Developer Knowledge MCPの認証を設定する
Developer Knowledge MCPを利用するには、APIの有効化とAPIキーの設定が必要です。Google Cloudプロジェクト、APIを有効化できる権限、認証済みのgcloud CLIを用意したうえで、以下を実行します。
gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID続けてAPIキーを作成・制限し、環境変数に設定してから同じシェルでClaude Codeを起動します。
export DEVELOPERKNOWLEDGE_API_KEY="YOUR_API_KEY"
claude起動後に別のターミナルで環境変数を設定しても、すでに起動しているClaude Codeのプロセスには引き継がれません。接続できない場合は、キーを設定した同じシェルから起動したか、対象プロジェクトでAPIを有効化済みかを先に確認してください。APIキーの値は記事やGitの差分に含めないよう注意が必要です。組織のポリシーでAPIキーの作成自体が禁止されている場合、公式のMCPガイドはOAuthやApplication Default Credentials（ADC）も認証方式として案内しており、Antigravityやエンタープライズのワークフローに適した経路として挙げられています。
課金・クォータについて: Developer Knowledge APIはGoogle Cloudの1サービスとして提供されるため、有効化には対象プロジェクトへの課金先アカウント（Billing Account）の紐付けが前提になります（Google Cloud全般の仕様として、APIの有効化自体には多くの場合Billing Accountの設定が必要です）。無料枠の有無・リクエスト数あたりの単価・1分あたりのクォータ上限といった具体的な数値は、プレビュー期間中は特に変更されやすい情報のため、本記事では確定値として記載しません。実際に運用する前に、Google Cloudコンソールの「APIとサービス」画面から該当APIの料金ページとクォータ設定を必ず確認し、想定外の課金が発生しないよう上限を明示的に設定しておくことをおすすめします。開発中の検証段階では、クォータをあらかじめ低めに設定しておくと、意図しない大量呼び出しに気づきやすくなります。
Step 3: 作りたいものと実行範囲を伝える
導入後は、対象のGoogle製品と完成させたい内容を自然言語で伝えます。「ローカルで動かす」「既存プロジェクトへ追加する」といった実行条件も併せて伝えるのが実践的です。
導入後の確認・更新・アンインストール
インストール直後は、SkillとMCPが実際に読み込まれる状態になっているかを確認しておくと、後のトラブルシューティングが早くなります。以下のコマンドを一通り把握しておくことをおすすめします。
- インストール状況の確認: Claude Code内で
/pluginと入力するか、claude plugin details google-cloud-developer@google-pluginsを実行します。有効化されているSkill一覧やMCPサーバーの接続状態を確認できます - プラグイン・カタログの更新: Google側でSkillの内容や同梱数が更新されることがあるため、
claude plugin marketplace update google/skillsで定期的にマーケットプレイスのカタログを最新化しておきます。カタログ更新後にclaude plugin install google-cloud-developer@google-pluginsを再実行すると、プラグイン本体も最新版に揃います - プラグインのアンインストール: 不要になった場合や、動作トラブルの切り分けのために一度リセットしたい場合は
claude plugin uninstall google-cloud-developer@google-pluginsを実行します。Developer Knowledge MCPの認証情報も併せて片付ける場合は、シェルの設定ファイル（.bashrcや.zshrc等）に永続化したDEVELOPERKNOWLEDGE_API_KEYの行を削除するか、unset DEVELOPERKNOWLEDGE_API_KEYで現在のシェルセッションから環境変数を解除します
プラグインを入れ直しても症状が変わらない場合は、認証情報の解除・環境変数の再設定・APIの有効化状況の3点を切り分けて確認すると原因を特定しやすくなります。
実用例：実開発フローに組み込む方法
実際にADK（Agent Development Kit）を使って、旅行先の料理とレストランを調べるエージェントを作らせた検証例があります。実装方法は指定せず、要件だけをClaude Codeに渡す形です。環境はgoogle-adk 2.9.2、Python 3.12、モデルはVertex AI経由のgemini-3.5-flashが使われました。
この検証では78回のツール呼び出しのうち1番目がfinding-google-skillsでした。組み立てられた検索語は「Google ADK (Agent Development Kit) Python agent with google_search grounding, run locally with adk web」というもので、依頼文からキーワードを抽出してSkillカタログに問い合わせる動きが確認できます。ただしこのケースでは製品別のSkillは1つも読み込まれませんでした。カタログ自体にADK専用のSkillが存在しなかったためで、これはSkill Finderが失敗したのではなく「該当なし」と正しく判定し、無駄にコンテキストを消費せず次の経路へ切り替えたという結果です。
Skillが空振りした分、Developer Knowledge MCP側が動きます。実際に投げられたクエリは「ADK built-in tools google_search limitations combining with other tools AgentTool」というもので、google_searchを他のツールと併用できるかを確認する内容でした。取得された公式ドキュメントには「ADK Python has a built-in workaround which bypasses this limitation」という記述があり、回避策としてbypass_multi_tools_limit=Trueという引数が実在することが分かりました。ソースコードを部分的に読んだだけでは気づきにくい情報を、MCP経由の公式ドキュメント検索が1回で補った例といえます。
最後にadk webコマンドでローカル起動し、「サマルカンドに旅行します。食べるべき料理と、おすすめのレストランを教えて」と尋ねたところ、検索クエリ20件・参照元37件を経て、日本語・英語・ロシア語を使い分けながら店ごとの住所・価格帯・出典URL付きで回答が返ってきました。ここで実際に働いているのはアプリ側が使うGoogle Searchであり、プラグイン自体が生成した情報ではない点は切り分けて理解しておく必要があります。
類似スキル・代替との比較
| ツール名 | 対応CLI | ライセンス | 特徴 |
|---|---|---|---|
| Google Cloud Developer Plugin | Claude Code | Google公開（OSS配布） | Skillsカタログ検索とMCPによる公式ドキュメント参照の2経路を提供 |
| Agents CLI（ADK向けSkills） | 各種AIコーディングエージェント | Google公開 | ADK開発の進め方（google-agents-cli-workflow等）を直接導入できる。ADK開発が確定している場合向け |
| ADK Docs MCP | 各種AIコーディングエージェント | Google公開 | ADK公式資料の検索・参照に特化した別のMCP設定。Developer Knowledge MCPとは別物 |
ADK開発だけを行うと決まっている場合は、Agents CLIのSkillsを直接導入する方法や、ADK Docs MCPを個別に設定する方法もあります。Google Cloud全般の開発支援や周辺設定からサポートしてほしい場合はGoogle Cloud Developer Pluginが入口として適しています。
注意点・制約・セキュリティ
- Developer Knowledge MCPの利用にはAPIキーまたはOAuth/ADCによる認証設定が必須で、Google Cloud側のAPI有効化（
developerknowledge.googleapis.com）と、多くの場合Billing Accountの紐付けが前提になります。無料枠やクォータの具体的な数値はプレビュー期間中に変わりうるため、必ず公式の料金・クォータページで最新情報を確認してください - APIキーは環境変数経由で渡す設計のため、値をコードやMarkdownに直接書き込まないよう管理する必要があります
- finding-google-skillsが参照するカタログに該当するSkillが無い製品（記事内の検証時点ではADKなど）では、Skill側の恩恵を受けられずMCP検索のみに頼ることになります
- MCPが取得する情報が有効に働くのは、依頼者側が誤った前提を持っている場合です。すでに正しい情報を把握している依頼では、参照しても結果が大きく変わらないことがあります
- プラグインが不要になった場合やトラブル時の切り分けには
claude plugin uninstall google-cloud-developer@google-pluginsでアンインストールし、DEVELOPERKNOWLEDGE_API_KEYの環境変数を解除することでリセットできます（詳細は「導入後の確認・更新・アンインストール」を参照）
よくある質問（FAQ）
Google Cloud Developer Pluginは無料で使えますか？
プラグイン自体はGoogleが公開しているGoogle Agent Skillsリポジトリの一部として無料で配布されています。ただしDeveloper Knowledge MCPの呼び出し先はGoogle CloudのAPIのため、対象プロジェクトへのBilling Account紐付けが前提になる場合があります。無料枠の有無やリクエスト数あたりの料金、クォータ上限はプレビュー期間中に変更されやすい情報のため、Google Cloudコンソールの料金・クォータページで最新の条件を確認してください。
対応しているCLIはClaude Codeだけですか？
記事で扱った手順はClaude Codeでの導入を前提としています。Developer Knowledge MCP自体はMCP対応の他のAI開発ツールからも利用できる可能性がありますが、finding-google-skillsを含むSkills経路はClaude Codeのプラグイン機構向けに提供されています。
インストールしても動かない場合はどうすればよいですか？
まず`claude plugin marketplace add google/skills`と`claude plugin install google-cloud-developer@google-plugins`が正常に完了しているかを確認します。次に`/plugin`または`claude plugin details google-cloud-developer@google-plugins`でSkill・MCPが認識されているか確認してください。MCP経由の検索が動かない場合は、`DEVELOPERKNOWLEDGE_API_KEY`を設定した同じシェルからClaude Codeを起動しているか、対象プロジェクトで`developerknowledge.googleapis.com`を有効化済みかを確認してください。それでも解消しない場合は、`claude plugin uninstall google-cloud-developer@google-plugins`で一度アンインストールし、環境変数を`unset`してから再インストールすると切り分けやすくなります。
APIキーを作成できない組織のポリシーでも使えますか？
公式のMCPガイドはAPIキー以外にOAuthやApplication Default Credentials（ADC）も認証方式として案内しています。組織ポリシーでAPIキー発行が制限されている場合は、この方式での接続を検討してください。
ADK（Agent Development Kit）の開発専用のプラグインですか？
いいえ、Google Cloud全般の開発支援を目的としたプラグインです。ADK開発に特化した手順が必要な場合は、Agents CLIが提供するSkills（google-agents-cli-workflow等）やADK Docs MCPを個別に導入する方法もあります。
セキュリティ面で気をつけることはありますか？
APIキーなどの認証情報は環境変数で渡す設計です。コードやMarkdown、チャットログに値をそのまま貼り付けないよう管理し、Google Cloud側のAPIキー制限（利用API・呼び出し元の制限）も併せて設定することが推奨されます。
既存のCLAUDE.mdに手順を書き溜める方法と何が違いますか？
CLAUDE.mdやプロンプトに毎回情報を貼る方法は、内容の正しさと更新の責任が書いた人側に残ります。プラグインはSkillカタログとMCPの参照先がGoogle側で管理されているため、Google Cloudの仕様変更があっても利用者側で書き溜めた情報を手動更新する必要がない点が異なります。カタログ自体の更新は`claude plugin marketplace update google/skills`で反映できます。
プラグインが不要になったら、どうやって削除すればよいですか？
claude plugin uninstall google-cloud-developer@google-pluginsを実行するとプラグイン本体を削除できます。Developer Knowledge MCPの認証情報を併せて片付ける場合は、シェルの設定ファイルに永続化したDEVELOPERKNOWLEDGE_API_KEYの記述を削除するか、現在のセッションでunset DEVELOPERKNOWLEDGE_API_KEYを実行してください。Google Cloud側で有効化したAPI（developerknowledge.googleapis.com）は、使わなくなった場合は別途コンソールから無効化するとクォータ・課金設定の掃除になります。
まとめ
Google Cloud Developer Pluginは、Google製品の開発手順と公式ドキュメントへの経路をClaude Codeに常駐させるプラグインです。要点は次の3つです。
- カタログから製品別Skillを探すSkills経路と、公式文書を直接検索するMCP経路を持ち、依頼に応じてオンデマンドで参照される
- 導入は
claude plugin marketplace addとclaude plugin installの2コマンドで完了し、MCP利用時のみAPIキーまたはOAuth/ADCの認証設定と、Google Cloud側のBilling Account紐付けが追加で必要になる - 導入後は
/pluginやclaude plugin detailsで状態を確認でき、claude plugin marketplace updateでの更新、claude plugin uninstallでの削除まで一貫してコマンドで管理できる
さらに詳しい認証方式やSkillカタログの内容、料金・クォータの最新値は、Claude Code上でclaude plugin detailsを実行するか、公式のDeveloper Knowledge MCPガイドとGoogle Cloudの料金ページを参照することをおすすめします。
コメント