AIエージェント・MCP

Google Cloud Developer Pluginとは？Claude Codeへの導入手順と安全設定【2026年10月】

Google Cloud Developer Pluginとは？Claude Codeへの導入手順と安全設定【2026年10月】

Google Cloud Developer Plugin（パッケージ名 google-cloud-developer）は、Claude CodeやCodexなどのAIコーディングエージェントに、Google Cloud用のスキル5本と公式ドキュメント検索用のMCPサーバー設定をまとめて入れる、Google公式のプラグインです。2026年9月11日付のGoogle Cloud公式ブログで発表されました。この記事では、同梱物の中身をリポジトリの実ファイルから読み解き、Claude Codeへの導入コマンドとAPIキーの渡し方、初期版で起きた認証の不具合、gcloudスキルが課す禁止事項、そして社内で採用する条件と見送る場面までを、2026年10月12時点の公式情報で整理します。

まとめ：Google Cloud Developer Pluginで入るものと導入前に決めること

このプラグインの価値は、エージェントの「古い記憶でgcloudを打つ」癖を抑える点にあります。コマンドを提案する前に gcloud help で構文を確かめさせ、IAMの変更や削除は人の承認なしに実行させない規則がスキルに明記されている構成です。加えて、Googleの公式ドキュメントを引けるMCPサーバーが付くため、版の新しいサービスでも根拠を確かめながら作業できます。

導入自体は2コマンドとAPIキー1本で終わります。決めるべきは権限の側です。スキルの規則はあくまでエージェントへの指示で、強制力はありません。Claude Code側の permissions.deny で削除・課金・IAM変更を止め、本番プロジェクトの権限を持つ端末には入れない。この2つを先に決めてから入れるのが安全な順番です。

Google Cloud Developer Plugin同梱の5スキルとMCPサーバー

まず、インストールすると手元に何が入るのかを、リポジトリの実ファイルで確かめます。

plugin.jsonの版番号とAgent Plugins仕様に沿った同梱物の構成

本体はGoogleのAgent Skillsリポジトリ（google/skills・Apache 2.0）の plugins/cloud/google-cloud-developer にあります。Claude Code向けのplugin.jsonは2026年10月12時点で "version": "1.1.10"、作者は Google LLC です。説明文には、初回プロジェクトのオンボーディング、認証情報の選び方、gcloudコマンドの安全検証、Developer Knowledge MCPサーバーの4点が並びます。

同じフォルダに .claude-plugin・.codex-plugin・.antigravity-plugin と gemini-extension.json が並んでいるのが特徴です。発表ブログによると、スキルとMCPサーバーを持ち運べる単位に束ねるベンダー中立の「Agent Plugins仕様」に沿って作られており、1つの中身を複数のエージェントへ配る構造になっています。Claude Code側のプラグインの仕組みはClaude Codeプラグインの作り方と社内配布を解説した記事で詳しく扱いました。

gcloud・認証・初期設定など同梱5スキルの役割と使われる場面

プラグインのフォルダに入っているスキルは次の5本です。表では長い名前の共通部分を略し、google-cloud-recipe- を「recipe-」、retrieving-developer- を「retrieving-」と書いています。

スキル名 担う作業
gcloud gcloudコマンドの構文確認と安全規則
recipe-auth 認証方式と認証情報の選び方
recipe-onboarding 初回プロジェクトの準備
retrieving-knowledge 公式ドキュメントの検索と取得
finding-google-skills カタログから追加スキルを探す

実務で効くのは上の2本です。残りは入口の案内で、GKEやBigQueryといった製品別の知識は含みません。同梱のルールファイルは、製品別スキルを必要なときにネットワーク越しに読む「取得」を推奨し、インストールは利用者自身に任せる方針を示しています。スキルという仕組みそのものはAnthropic公式スキルの中身と導入手順の記事を参照してください。

Developer Knowledge MCPサーバーの3ツールと引ける文書の範囲

.mcp.jsonには、developer-knowledge という名前のサーバーが、Streamable HTTPで https://developerknowledge.googleapis.com/mcp に接続する設定として書かれています。APIキーは環境変数 DEVELOPERKNOWLEDGE_API_KEY から X-Goog-Api-Key ヘッダーへ渡る仕組みで、キーそのものはファイルに含まれません。

Developer Knowledge MCPの公式ページによると、提供ツールは文書を探す search_documents、本文をMarkdownで取る get_documents、まとめた回答を返す answer_query の3つです。対象はGoogle Cloud・Firebase・Android・Google Maps Platformなどの公開ドキュメントで、英語版だけ。日本語ドキュメントや非公開の資料は引けないため、回答の根拠は英語の原文になります。MCPそのものの仕組みはMCPの標準規格とサーバーの仕組みを解説した記事にまとめています。

Claude Codeへ導入する手順｜API有効化からキー設定と動作確認まで

導入は「APIとキーの準備」「プラグインの追加」「動いているかの確認」の3段階です。

Developer Knowledge APIを有効化して用途を絞ったAPIキーを作る

Developer Knowledge APIのクイックスタートでは、APIの有効化にも利用にも特定のIAMロールは要らないとされています。キーは作成時に「Developer Knowledge API」だけに制限してください。同じキーでGeminiのモデル呼び出しもする場合はGenerative Language APIの追加が必要と書かれていますが、用途を混ぜると漏えい時の被害が広がるため、キーは分けるほうが無難です。

# ドキュメント検索専用のプロジェクトでAPIを有効化する
gcloud services enable developerknowledge.googleapis.com --project=YOUR_PROJECT_ID

# Developer Knowledge APIだけを呼べるキーを作る
gcloud services api-keys create \
  --display-name="dk-mcp-claude-code" \
  --api-target=service=developerknowledge.googleapis.com \
  --project=YOUR_PROJECT_ID

キー作成の --api-target はGoogle CloudのAPIキー管理ドキュメントに載っている指定方法です。キーを置くプロジェクトは、本番のリソースが無い検索専用のものにしておくと、キーが漏れても他のサービスへ波及しません。

marketplace追加とinstallの2コマンドで入れて環境変数を渡す

発表ブログに載っているClaude Code向けの手順は次のとおりです。キーはClaude Codeを起動する前にシェルの環境変数として設定します。

# Googleのマーケットプレイスを登録してプラグインを入れる
claude plugin marketplace add google/skills
claude plugin install google-cloud-developer@google-plugins

# 起動前にキーを渡す（.zshrcなどに書くならリポジトリに含めない）
export DEVELOPERKNOWLEDGE_API_KEY=YOUR_API_KEY
claude

マーケットプレイス名は google-plugins です。プラグインを使わずスキルだけ欲しい場合は、リポジトリのREADMEにある npx skills add google/skills で個別に選べます。Claude Codeの拡張手段全体のなかでの位置づけはClaude Codeの拡張機能を役割別に整理した記事が参考になります。

接続表示を信用しない動作確認とv1.1.3以前の認証の不具合

初期版には、Claude CodeでMCPサーバーが認証を通せない不具合がありました。GitHub Issue #223は2026年9月10日に v1.1.1 で報告されたもので、Gemini CLI向けの設定にはGoogleの認証情報を使う指定がある一方、Claude Code向けには認証の設定が無く、ツール呼び出しが「Request is missing required authentication credential.」で失敗していました。9月18日リリースの v1.1.3 で、APIキーを環境変数で渡す現在の方式に改められています。

この Issue でメンテナーが指摘しているのが、接続ステータスは認証の成否を映さないという点です。/mcp で接続済みに見えても、実際に「Cloud Runの最小インスタンス数の設定方法を公式ドキュメントで調べて」のような質問を投げ、search_documents が結果を返すかで確かめてください。スキル側にはcurlで取りに行く逃げ道もあるため、MCPが失敗していても回答自体は出てしまい、壊れていることに気づきにくい構造です。v1.1.3より前に入れた端末は、プラグインの更新から始めます。

gcloudスキルが課すガードレールと削除・課金を止める権限設定

このプラグインで最も実務に効くのが、gcloudスキルに書かれた安全規則です。中身と、その限界を見ます。

実行前のhelp確認とlistの絞り込みを必須にする2つの基本規則

gcloudスキルのSKILL.mdは、既存の知識は古く誤りやすいという前提に立ち、コマンドを提案・実行する前に末端のサブコマンドまで gcloud help で確かめるよう求めています。構文の確認にWeb検索を使うことは禁じられています。

もう1つが出力の絞り込みです。list 系コマンドは --limit・--filter・--format のどれかを付けないと実行させません。数千件のリソース一覧がそのまま会話に流れ込み、コンテキストを食い潰す事故を防ぐ規則です。ほかに、1回に1コマンドだけ実行しパイプやリダイレクトを使わない、操作系のコマンドには --project と --quiet を必ず付ける、--dry-run や --validate-only があれば先に使う、といった規則が並びます。

IAM変更・課金・削除をエージェントに自律実行させない禁止リスト

SKILL.mdには、利用者の承認なしに実行してはならない操作が列挙されています。IAMのポリシー・ロール・バインディングの変更、APIの有効化、gcloud * delete、gcloud billing、gcloud organizations、gcloud kms、gcloud infra-manager deployments apply です。

注意したいのは、これがエージェントへの指示文であって、実行を止める仕組みではないことです。しかも規則は --quiet を付けて確認プロンプトを飛ばすよう求めているため、gcloud側の「本当に削除しますか」も出ません。止める役はClaude Codeの権限設定に持たせます。Claude Codeの権限ドキュメントでは、ルールはdeny→ask→allowの順に評価され、* は任意の位置に置けます。

{
  "permissions": {
    "deny": [
      "Bash(gcloud * delete *)",
      "Bash(gcloud billing *)",
      "Bash(gcloud organizations *)",
      "Bash(gcloud kms *)",
      "Bash(gcloud * add-iam-policy-binding *)",
      "Bash(gcloud * set-iam-policy *)"
    ],
    "ask": [
      "Bash(gcloud *)"
    ]
  }
}

この内容をリポジトリの .claude/settings.json に置けば、チーム全員の端末で同じ線が引けます。denyに当たる操作は人がターミナルで実行し、それ以外のgcloudも毎回確認を挟む運用です。手間は増えますが、承認済みのコマンドを「今後は聞かない」で通す癖が付く前に、境界を決めておく価値があります。

CodexやAntigravityと同じプラグインを共有するときの設定の違い

中身は共通でも、MCPサーバーの渡し方はエージェントごとに違います。発表ブログでは、Antigravity CLIは agy plugin install にリポジトリ内のパスを渡し、Codex CLIは config.toml にサーバーを書き足す手順です。

# ~/.codex/config.toml（またはプロジェクトの .codex/config.toml）
[mcp_servers.developer-knowledge]
url = "https://developerknowledge.googleapis.com/mcp"
env_http_headers = { "X-Goog-Api-Key" = "DEVELOPERKNOWLEDGE_API_KEY" }

Codexでは設定後にサーバーが「not logged in」と表示されても想定どおりで、利用は妨げられないとブログに書かれています。認証の方式もクライアントごとに異なる仕組みです。MCP公式ページによると、AntigravityはApplication Default Credentials（ADC）に対応し、ほかのクライアントでも有効期限1時間のアクセストークンと X-Goog-User-Project ヘッダーで接続できます。キーを配りたくない組織は、この経路を検討してください。

Google Cloud Developer Pluginを採用する条件と見送る場面の判断

ここからは判断です。入れるかどうかは、エージェントがGoogle Cloudに触る頻度と、端末が持つ権限で決まります。

検証用プロジェクトでgcloud作業を日常的に任せるチームは採用

採用してよいのは、次の条件をすべて満たすチームです。

  • エージェントにgcloudのコマンドを書かせる作業が週に何度もある
  • エージェントを動かす端末の認証情報が、検証用・開発用のプロジェクトに限られている
  • 新しいサービスや版の変わった機能を扱い、公式ドキュメントの確認に時間を取られている
  • Claude Codeの権限設定をリポジトリで共有し、denyの線をチームでそろえられる

特に3つ目が効きます。モデルの学習時点より新しいフラグやリージョンの対応状況を、英語の原文から引いて確かめられるのは、このプラグインならではの利点です。

本番権限を持つ端末やキー配布を禁じた組織で導入を見送る判断基準

見送るのは2つの場面です。1つは、開発者の端末に本番プロジェクトのオーナー権限が付いたままの組織。スキルの禁止リストは承認を求める指示に過ぎず、承認する人が疲れていれば通ります。まず端末の認証を検証用に絞るのが先で、プラグインはその後です。GKE上のワークロードなら、Workload Identityでキーを持たない認証に切り替える方法も合わせて検討してください。

もう1つは、APIキーの配布を規程で禁じている組織です。Claude CodeやCodexでドキュメント検索を使うにはキーを各端末へ渡す必要があり、ADCで済むのは現時点でAntigravityに限られます。この場合はMCPサーバーを使わず、スキルだけを npx skills add で入れる構成に留める判断が妥当です。

プロジェクト権限とIAM設計まで含めて外部に相談するときの目安

エージェントにクラウドを触らせる段階で詰まるのは、たいていツールではなく権限の設計です。開発・検証・本番のプロジェクト分割、端末ごとのサービスアカウント、削除系を人の手に残す運用ルールが決まっていれば、プラグインは安全に入れられます。逆にここが曖昧なまま導入すると、便利さに押されて権限が広がっていく懸念があるため注意が必要です。Google Cloudの環境分割やIAMの設計から見直したい場合は、AWS・Google Cloud・Azureのインフラ構築の相談窓口で、エージェント運用を前提にした権限の切り方から設計できます。

Google Cloud Developer Pluginの導入検討でよくある質問と回答

導入前に出やすい疑問に、2026年10月12時点の公式情報で答えます。

Google Cloud Developer Pluginは無料で使えますか？

プラグイン本体はApache 2.0ライセンスで公開されており、無償で入れられます。Developer Knowledge APIについては、発表ブログとクイックスタートのどちらにも料金の記載がなく、クォータの数値も公式のクォータページへの案内に留まっています。利用量が多いチームは、キーを作ったプロジェクトのクォータ画面で上限を確かめ、429 RESOURCE_EXHAUSTED が出たときの扱いを決めておくと安心です。

Gemini CLIやCursorでも使えますか？

発表ブログが手順を示しているのはAntigravity CLI・Claude Code・Codex CLIの3つです。リポジトリには gemini-extension.json も同梱されており、Issue #223ではGemini CLIで動作していたと報告されています。MCPサーバー単体なら、Developer Knowledgeの公式ページがCursorやGitHub Copilotからの接続方法も案内しています。スキルの読み込み方はエージェントごとに違うため、プラグインとしての動作はClaude Code・Codex・Antigravityで確かめるのが確実です。

MCPサーバーが接続済みなのに公式文書を引かないのはなぜですか？

接続ステータスは認証の成否を反映しないと、Issue #223でメンテナーが説明しています。まずプラグインがv1.1.3以降か、Claude Codeを起動したシェルで DEVELOPERKNOWLEDGE_API_KEY が設定されているかを確かめてください。キーをDeveloper Knowledge API以外に制限していないか、APIを有効化したプロジェクトとキーのプロジェクトが一致しているかも見落としやすい点です。

GKEやBigQueryのスキルはプラグインに含まれますか？

含まれません。同梱は基礎の5本で、製品別のスキルはgoogle/skillsのカタログにあります。同梱ルールでは、必要になった時点でSKILL.mdをネットワーク越しに読む「取得」を推奨しており、取得したスキルが保持されるのはセッション終了までです。常に使う製品があるなら、npx skills add google/skills で個別にインストールするほうが毎回の取得を省けます。

日本語のドキュメントも検索対象になりますか？

なりません。Developer Knowledge MCPの公式ページでは、対象は英語の公開ドキュメントに限られると明記されています。日本語で質問した場合も、エージェントの回答は英語の原文を引いたうえで日本語で答える形式です。日本語版のドキュメントは更新が英語版より遅れることがあるため、版の新しい機能を調べる用途では英語の原文を根拠にできる点がむしろ利点になります。

関連記事

お気に入りに入れた記事の一覧

この記事は以下の記事からリンクされています

資料請求

RELATED POSTS 関連記事

一覧へ戻る

目次