Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Developer Knowledge MCP サーバーに接続する

Google Developer Knowledge MCP サーバーを使用すると、AI を活用した開発ツールから、Firebase、Google Cloud、Android、Google Maps Platform などのプロダクトの Google デベロッパー公式ドキュメントを直接検索して取得できます。コーディングアシスタントを Google の信頼できるドキュメントライブラリに接続することで、手動でのウェブ検索、古いコンテキスト、スクレイピングを回避できます。

MCP サーバーの機能

Google Developer Knowledge MCP サーバーは、AI コーディングアシスタントに次の 3 つのコアツールを提供します。

ツール名	説明
`search_documents`	Google デベロッパードキュメントを検索し、ドキュメント名とともに最も関連性の高いページの抜粋を返します。
`get_documents`	``search_documents`` から返された名前を使用して、ドキュメントの完全な Markdown コンテンツを取得します。
`answer_query`	Developer Knowledge コーパスに基づいて、構造化された合成回答を生成します。

search_documents ツールは、Google のドキュメントを検索して、クエリに一致する最も関連性の高いセクションを見つけます。質問すると、短いテキストパッセージが返されます。エージェントがパッセージの周囲のページコンテキスト全体を必要とする場合は、ドキュメントのリソース名を get_documents に渡して、ページ全体を取得できます。

Developer Knowledge コーパスから合成された質問への直接的な回答が必要な場合は、生の検索結果や完全な Markdown ファイルではなく、answer_query ツールを使用します。

認証方法を選択する

Developer Knowledge MCP サーバーは、開発環境と AI アシスタントに応じて 2 つの認証方法をサポートしています。

API キー: Claude Code、 Cursor、GitHub Copilot、Codex などのサードパーティ IDE および CLI エージェント、その他のリモート MCP クライアントに最適です。API キーは、HTTPS 経由で X-Goog-Api-Key ヘッダーに渡します。
OAuth と ADC: Google Antigravity、またはアプリケーションのデフォルト認証情報（ADC）またはスタンドアロン OAuth 2.0 クライアント ID を使用するエンタープライズワークフローに最適です。

選択した認証方法に必要な認証情報を生成して、AI アシスタントまたはコーディングエージェントが Developer Knowledge MCP サーバーサービスでリクエストを認証できるようにします。

タブを選択して認証情報を作成します。

API キー

前提条件

API キーを作成する前に、次のものがあることを確認してください。

Google Cloud プロジェクト。
gcloud CLI がインストールされていること（コマンドラインから構成する場合）。

API を有効にして API キーを作成する

API キーは、Google Cloud コンソールまたは gcloud CLI を使用して生成できます。

Google Cloud Console

Google Cloud コンソールで Developer Knowledge API ページを開きます。
Google Cloud プロジェクトを選択して、[有効にする] をクリックします。
[認証情報] ページに移動します。
[認証情報を作成] をクリックし、[API キー] を選択します。
[API キーを編集] アクションをクリックして、制限を構成します。
- [API の制限] で [キーを制限] を選択します。
- [Developer Knowledge API] を選択します。
- モデル呼び出し（GEMINI_API_KEY など）に同じキーを使用する場合は、[Generative Language API] も選択します。
[保存] をクリックし、API キーをコピーします。

gcloud CLI

プロジェクトで Developer Knowledge API を有効にします。 PROJECT_ID は実際のプロジェクト ID に置き換えます。
```
gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID
```
API キーを作成します。
```
gcloud services api-keys create \
  --project=PROJECT_ID \
  --display-name="DK API Key"
```
このコマンドは、新しいキーに関するメタデータの詳細を返します。コマンド出力から次の両方の値をコピーして保存します。
- keyString: これは生の API キーです（例: AIzaSy...）。この値は IDE 構成に貼り付けます。
- name: これはキーのリソースパスです（例: projects/PROJECT_ID/locations/global/keys/UNIQUE_ID）。このパスを使用して、次のステップでキーを制限します。
不正使用を防ぐため、キーを Developer Knowledge API に制限します。KEY_NAME は、前のステップでコピーした完全な name パスに置き換えます。
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com
```
重要: AI クライアントの一般的なモデル呼び出し（GEMINI_API_KEY など）に同じキーを使用する場合は、Generative Language API も許可する必要があります:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com \
  --api-target=service=generativelanguage.googleapis.com
```

OAuth と ADC

前提条件

OAuth を構成する前に、次のものがあることを確認してください。

API を有効にする

次のコマンドを実行して、プロジェクトで Developer Knowledge API を有効にします。

gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID

OAuth 認証情報の種類を選択する

ツールに必要な認証情報のアプローチを選択します。

アプリケーションのデフォルト認証情報

AI アシスタントが ADC をサポートしている場合（Google Antigravity など）:

Google アカウントで認証し、割り当てプロジェクトを設定します。
```
gcloud auth application-default login \
  --project=PROJECT_ID
```
ブラウザが開いたら、Google アカウントでログインし、リクエストされた権限を付与します。

OAuth クライアント ID

AI アシスタントにスタンドアロン OAuth クライアント ID とシークレットが必要な場合:

OAuth 同意画面を開きます。
ユーザータイプを [外部] に設定し、必要なアプリ名とサポートメールを入力して、[保存して次へ] をクリックします。
[オーディエンス] ページの [テストユーザー] で [ユーザーを追加] をクリックし、Google メールアドレスを入力して [保存] をクリックします。
[クライアント] ページに移動し、 [クライアントを作成] をクリックして、[アプリケーションタイプ] を [デスクトップアプリ] に設定します。
[作成] をクリックし、JSON クライアント認証情報ファイルをダウンロードします。

IDE またはコーディングエージェントを構成する

認証情報を取得したら、使用するコーディング環境を選択してセットアップ手順を表示します。

選択した認証方法に応じて、構成テンプレートのプレースホルダを次のように置き換えます。

API キー認証: YOUR_API_KEY を生の API キー文字列に置き換えます。
OAuth または ADC 認証: PROJECT_ID を Google Cloud プロジェクト ID に置き換えます。

Google Antigravity

Antigravity IDE と拡張機能

Antigravity IDE または Antigravity 拡張機能（VS Code など）で MCP サーバーを構成するには、認証方法を選択します。

Google 認証情報

ワンクリックセットアップを使用して MCP サーバーをインストールするには:

[エージェント] パネルで、[**その他のオプション**] () メニューをクリックし、 [**MCP サーバー**] を選択します。
[Google Developer Knowledge] を検索します。
[**インストール**] ()アイコンをクリックします。 Antigravity は、アクティブな Google 認証情報を使用してサーバーを自動的に構成し、接続します。

API キー

Antigravity IDE または Antigravity 拡張機能で API キーを構成するには:

[エージェント] パネルで、[その他のオプション] () メニュー > [MCP サーバー] > [MCP サーバーを管理] > [生の構成を表示] （または .agents/mcp_config.json を開く）をクリックします。

次のサーバー構成を追加します。

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Antigravity CLI

プロジェクトの .agents/mcp_config.json ファイル（または ~/.gemini/config/mcp_config.json でグローバルに）で MCP サーバーを構成します。

Google 認証情報

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
      },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

API キー

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

ターミナルで次のコマンドを実行します。

claude mcp add google-dev-knowledge \
  --transport http https://developerknowledge.googleapis.com/mcp \
  --header "X-Goog-Api-Key: YOUR_API_KEY"

Cursor

Cursor を構成するには、プロジェクトルートの .cursor/mcp.json または ~/.cursor/mcp.json を編集します。

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

ワークスペースの設定

特定のワークスペース用に VS Code で GitHub Copilot を構成するには、.vscode/mcp.json を作成または編集します。

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

グローバルユーザー設定

すべての VS Code ワークスペースでサーバーを使用できるようにするには、ユーザー設定（JSON）を開き、"mcp" キーの下に以下を追加します。

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

Codex

Codex CLI または Codex エージェントを構成するには、サーバー構成を ~/.codex/config.json（またはプロジェクトの .codex/config.json）に追加します。

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

その他

その他のリモート MCP クライアント（JetBrains AI Assistant、Windsurf、Cline、Zed、Continue、Claude Desktop など）を構成するには、次の設定で HTTP トランスポートサーバーを構成します。

サーバーの URL: https://developerknowledge.googleapis.com/mcp
HTTP ヘッダー: X-Goog-Api-Key: YOUR_API_KEY

標準の JSON 構成テンプレート:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

接続を確認する

構成したら、AI アシスタントを再起動するか、MCP サーバーを再読み込みします。次に、テストプロンプトを送信して、ツールの統合が機能することを確認します。

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

エージェントが search_documents または answer_query を呼び出して Google ドキュメントから情報を返す場合、サーバーは接続されてアクティブになっています。

コンテキストウィンドウとトークンの使用量を最適化する

ドキュメントページ全体を AI モデルのコンテキストウィンドウに取得すると、大量のトークンが消費されます。複数の大きなドキュメントを取り込むと、トークン費用が高くなり、レイテンシが増加し、コンテキストウィンドウがオーバーフローする可能性があります。

迅速かつ費用対効果の高いレスポンスを確保するには、次のプロンプトエンジニアリングのベストプラクティスに従ってください。

2 段階の取得に依存する: エージェントに search_documents の呼び出しから開始させます。これにより、ページ全体のトークンを消費することなく、必要な正確な構文または API シグネチャを含む、絞り込まれたスニペット（チャンク）が返されます。周囲のコンテキストが厳密に必要な場合にのみ、エージェントに get_documents を呼び出すように指示します。
概念的な質問には answer_query を優先する: 合成された説明や設計の比較が必要な場合は、エージェントに answer_query を使用するように指示します。このツールは、生の Markdown ページ全体を返すことなく、Developer Knowledge コーパスから直接回答を合成します。
スコープが設定された具体的なプロンプトを作成する: 「Firebase のすべてを説明する」など、広すぎるプロンプトは避けてください。代わりに、ターゲットプロダクト、プラットフォーム、言語を指定します。
```
How do I write a Firestore transaction in Dart with error handling?
```
カスタムエージェントルールを追加する: プロジェクトレベルのガイドラインをアシスタントの命令ファイル（例: .cursorrules、CLAUDE.md、.github/copilot-instructions.md）に追加して、自動的なページ全体の取得を制限します。
```
When searching Google developer documentation, inspect search_documents
snippets first. Do not call get_documents unless the snippet lacks
necessary code context.
```

セキュリティと安全に関するオプションの構成

MCP ツールで実行できるアクションが多岐にわたるため、MCP によって新たなセキュリティリスクと考慮事項が加わります。これらのリスクを最小限に抑えて管理するために、Google Cloud は、Google Cloud 組織またはプロジェクトでの MCP ツールの使用を制御するデフォルト設定とカスタマイズ可能なポリシーを提供します。

MCP のセキュリティとガバナンスの詳細については、 AI のセキュリティと安全性をご覧ください。

Model Armor を使用する

Model Armor は、AI アプリケーションのセキュリティと安全性を強化するために設計された Google Cloud サービスです。LLM のプロンプトとレスポンスを事前にスクリーニングすることで、さまざまなリスクから保護し、責任ある AI への取り組みをサポートします。クラウド環境や外部クラウドプロバイダに AI をデプロイする場合でも、Model Armor を使用すると、悪意のある入力からの防御、コンテンツの安全性の検証、センシティブデータの保護、コンプライアンスの維持、多様な AI 環境全体で AI の安全性とセキュリティポリシーの一貫した適用が可能になります。

ロギングを有効にして Model Armorを有効にすると、Model Armor はペイロード全体をログに記録します。これにより、機密情報がログに公開される可能性があります。

Model Armor への MCP リクエストのルーティング

Model Armor は特定のリージョンで利用できます。Model Armor が有効になっていて、Model Armor がサポートしていない管轄区域で MCP サーバーを使用している場合、呼び出しのルーティング動作は MCP サーバーによって異なる可能性があり、使用中のデータと転送中のデータのデータ所在地コンプライアンスに違反する可能性があります。個々の MCP サーバーの動作の詳細については、 Model Armor 対応プロダクトをご覧ください。

Model Armor を有効にする

Model Armor を有効にするには、 Google および Google Cloud MCP サーバーと統合するの手順に沿って操作します。

リモート MCP サーバーの保護を構成する

MCP ツールの呼び出しとレスポンスを保護するには、Model Armor のフロア設定を使用します。フロア設定は、プロジェクト全体に適用される最小限のセキュリティフィルタを定義します。この構成では、プロジェクト内のすべての MCP ツールの呼び出しとレスポンスに一貫したフィルタセットが適用されます。

MCP サニタイズを有効にして、Model Armor のフロア設定を構成します。詳細については、Model Armor のフロア設定を構成するをご覧ください。

次のコマンド例をご覧ください。

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

PROJECT_ID は、実際のプロジェクト ID に置き換えます。

次の設定に注意してください。

INSPECT_AND_BLOCK: Google MCP サーバーのコンテンツを検査し、フィルタに一致するプロンプトとレスポンスをブロックする適用タイプ。
ENABLED: フィルタまたは適用を有効にする設定。
MEDIUM_AND_ABOVE: 責任ある AI - 危険フィルタ設定の信頼度。この設定は変更できますが、値を小さくすると誤検出が増える可能性があります。詳細については、Model Armor の信頼度をご覧ください。

Model Armor による MCP トラフィックのスキャンを無効にする

Model Armor がプロジェクトのフロア設定に基づいて Google MCP サーバーとの間のトラフィックを自動的にスキャンしないようにするには、次のコマンドを実行します。

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

PROJECT_ID は、プロジェクト ID に置き換えます。Model Armor は、このプロジェクトのフロア設定で定義されたルールを Google MCP サーバーのトラフィックに自動的に適用しません。

Model Armor のフロア設定と一般的な構成は、MCP だけでなく、他のサービスにも影響する可能性があります。Model Armor は Vertex AI などのサービスと統合されているため、フロア設定を変更すると、MCP だけでなく、統合されたすべてのサービスでトラフィックスキャンと安全性の動作に影響する可能性があります。

Model Armor の設定を調整する

Model Armor を使用してアプリケーションを保護している場合、403 PERMISSION_DENIED エラーが一部のクエリで発生することがあります。Developer Knowledge MCP サーバーは、信頼できる Google ソースからの公開ドキュメントのみを返すため、誤検出を減らすために、プロンプトインジェクションとジェイルブレイク（PIJB）フィルタを HIGH_AND_ABOVE の信頼度レベルに設定することをおすすめします。ユースケースに、非公開データや機密データにアクセスする他のツールが含まれていない場合は、PIJB フィルタを無効にすることもできます。

トラブルシューティング

Developer Knowledge MCP サーバーへの接続やクエリで問題が発生した場合は、次のトラブルシューティングマトリックスと解決手順をご覧ください。

トラブルシューティングマトリックス

症状またはエラー	考えられる原因	解決策
`400 Bad Request: API key not valid`	API キー文字列がないか、無効か、形式が正しくありません。	API キーが正しくコピーされ、 `headers` オブジェクトに `X-Goog-Api-Key` キーを使用して構成されていることを確認します。
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	Google Cloud プロジェクトで Developer Knowledge API が有効になっていません。	Google Cloud コンソールで API を有効にするか、 `gcloud services enable developerknowledge.googleapis.com`. を実行します。
`403 PERMISSION_DENIED: API target restriction`	API キー制限リストに Developer Knowledge API が含まれていません。	Google Cloud コンソールの [認証情報] ページで API キーの制限を更新して、Developer Knowledge API を含めます。
`401 UNAUTHENTICATED` または ADC 認証情報がない	アプリケーションのデフォルト認証情報の有効期限が切れているか、初期化されていません。	`gcloud auth application-default login --project=PROJECT_ID` を実行して、ローカル認証情報を更新します。
`403 access_denied` / 「アクセスがブロックされました: 承認エラー」	アカウントが OAuth 同意の承認済みテストユーザーとしてリストされていません。	[Google Cloud コンソール] > [認証プラットフォーム] > [オーディエンス] で、[テストユーザー] にメールアドレスを追加します。
OAuth クライアントエラーまたは無効なリダイレクト URI	OAuth クライアントが、サポートされていないアプリケーションタイプで作成されました。	タイプを [デスクトップアプリ]に設定して、OAuth クライアント ID を再作成します。
`/mcp` エンドポイントで `404 NOT_FOUND`	プロジェクトで API が有効になっていません。	Google Cloud コンソールで Developer Knowledge API を有効にするか、 `gcloud services enable developerknowledge.googleapis.com`. を実行します。
`429 RESOURCE_EXHAUSTED`	プロジェクトの割り当て上限に達しました。	コンソールで Developer Knowledge API の割り当て使用量を確認し、必要に応じて割り当ての引き上げをリクエストします。
Model Armor で `403 PERMISSION_DENIED`	Model Armor PIJB フィルタの誤検出により、安全なクエリがブロックされました。	Model Armor テンプレート設定で、PIJB フィルタの信頼度を `HIGH_AND_ABOVE` に設定します。

認証エラーと同意エラーを解決する

API キーヘッダーの構成: MCP JSON 構成に、"X-Goog-Api-Key" を含む headers セクションが含まれていることを確認します。API キーを URL のクエリパラメータとして渡さないでください。
OAuth 同意画面のテストユーザー: テストモードで外部ユーザータイプを使用するプロジェクトでデスクトップ OAuth クライアントを作成する場合、Google はテストユーザーにリストされていないアカウントのアクセスをブロックします。アクティブな Google メールアドレスが、Google Cloud コンソールの [オーディエンス] > [テストユーザー] に追加されていることを確認します。
割り当てとレート上限: 1 日あたりの使用量と 1 分あたりの使用量をモニタリングするには、Google Cloud コンソールで [IAM と管理] > [割り当てとシステム上限] に移動し、 [Developer Knowledge API] でフィルタします。

含まれるドキュメント

サーバーによってインデックス登録された Google プロダクトとドキュメントリポジトリの完全なリストについては、コーパスのリファレンスをご覧ください。

既知の制限事項

公開ドキュメントのみ: サーバーは、コーパスのリファレンスに記載されている一般公開されているドキュメントのみをインデックスに登録します。内部ドキュメント、非公開リポジトリ、サードパーティリソースは含まれません。
英語: サーバーは英語のドキュメントのみをインデックスに登録して返します。
ネットワークの依存関係: サーバーが https://developerknowledge.googleapis.comにアクセスするには、インターネットに接続している必要があります。

Developer Knowledge MCP サーバーに接続する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

MCP サーバーの機能

認証方法を選択する

API キー

前提条件

API を有効にして API キーを作成する

Google Cloud Console

gcloud CLI

OAuth と ADC

前提条件

API を有効にする

OAuth 認証情報の種類を選択する

アプリケーションのデフォルト認証情報

OAuth クライアント ID

IDE またはコーディング エージェントを構成する

Google Antigravity

Antigravity IDE と拡張機能

Google 認証情報

API キー

Antigravity CLI

Google 認証情報

API キー

Claude Code

Cursor

GitHub Copilot

ワークスペースの設定

グローバル ユーザー設定

Codex

その他

接続を確認する

コンテキスト ウィンドウとトークンの使用量を最適化する

セキュリティと安全に関するオプションの構成

Model Armor を使用する

Model Armor への MCP リクエストのルーティング

Model Armor を有効にする

リモート MCP サーバーの保護を構成する

Model Armor による MCP トラフィックのスキャンを無効にする

Model Armor の設定を調整する

トラブルシューティング

トラブルシューティング マトリックス

認証エラーと同意エラーを解決する

含まれるドキュメント

既知の制限事項

Developer Knowledge MCP サーバーに接続する

IDE またはコーディングエージェントを構成する

グローバルユーザー設定

コンテキストウィンドウとトークンの使用量を最適化する

トラブルシューティングマトリックス