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

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

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

IDE ではなく、独自のアプリケーションまたはエージェントコードからデベロッパーナレッジ MCP サーバーに接続するには、MCP SDK を使用して接続するをご覧ください。

MCP サーバーの機能

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

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

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

answer_query ツールは、生の検索結果や完全な Markdown ファイルではなく、デベロッパーナレッジコーパスから抽出された質問に対する直接的な回答が必要な場合に使用します。

認証方法を選択する

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

API キー: Claude Code、Cursor、GitHub Copilot、Codex、その他のリモート MCP クライアントなどのサードパーティ IDE や CLI エージェントに最適です。HTTPS 経由で X-Goog-Api-Key ヘッダーに API キーを渡します。
OAuth と ADC: アプリケーションのデフォルト認証情報（ADC）のサポートが組み込まれている Google Antigravity に最適です。また、API キーではなく OAuth 2.0 署名なしトークンまたはスタンドアロンの 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 または ADC を構成する前に、次のことを確認してください。

API を有効にする

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

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

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

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

ADC

Google Antigravity には ADC のサポートが組み込まれており、更新トークンが自動的に更新されます。他の MCP クライアントは、Authorization ヘッダーに有効期間の短い署名なしトークンを渡すことで、ADC を使用できます。

Google アカウントで認証し、割り当てプロジェクトを設定します。
```
gcloud auth application-default login \
  --project=PROJECT_ID
```
ブラウザが開いたら、Google アカウントでログインし、リクエストされた権限を付与します。
（省略可）ADC サポートが組み込まれていないサードパーティの MCP クライアントを構成する場合は、クライアントの Authorization ヘッダーで使用する署名なしトークン（1 時間有効）を生成します。
```
gcloud auth application-default print-access-token
```

OAuth クライアント ID

Google リモート MCP サーバーは OAuth 動的クライアント登録（DCR）をサポートしていないため、AI アシスタントがインタラクティブ OAuth フローを使用する場合は、OAuth 2.0 クライアント ID とシークレットを作成します。

[ブランディング] ページに移動して、プロジェクトを選択します。[アプリ名] と [ユーザーサポートのメールアドレス] を入力し、[保存] をクリックします。
[対象ページ] に移動し、[ユーザータイプ] を [外部] に設定します。
同じページで、[テストユーザー] の [ユーザーを追加] をクリックし、Google のメールアドレスを入力して、[保存] をクリックします。
[クライアント] ページに移動し、[クライアントを作成] をクリックして、MCP クライアントに必要なアプリケーションの種類を選択します。
- クライアント ID とシークレットを求めるデスクトップクライアント（VS Code など）の場合は、[デスクトップアプリ] を選択します。
- [ウェブアプリケーション] を選択し、静的 OAuth リダイレクトコールバックを必要とするクライアント（Cursor や Claude Code のカスタムコネクタなど）のクライアントのリダイレクト URI を追加します。クライアントでドキュメント化されているリダイレクト URI を正確に使用します。カスタムリダイレクト URI はサポートされていません。クライアント固有のリダイレクト URI については、AI アプリケーションで MCP を構成するをご覧ください。
[作成] をクリックし、クライアント ID とクライアントシークレットをコピーします（または、JSON クライアント認証情報ファイルをダウンロードします）。

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

認証情報を取得したら、コーディング環境のセットアップ手順に沿って操作します。各コーディング環境の手順では、次の認証方法がサポートされています。

コーディング環境	認証方法
Google Antigravity	組み込みの Google 認証情報（ADC）または API キー
Claude Code、Cursor、GitHub Copilot、Codex	API キー
その他	API キー、ADC 署名なしトークン、OAuth 2.0 クライアント ID

Claude Code、Cursor、GitHub Copilot、Codex で ADC 署名なしトークンまたは OAuth 2.0 クライアント ID を使用するには、[その他] タブの手順に沿って操作します。

使用するテンプレートに応じて、次のプレースホルダを置き換えます。

API キー（YOUR_API_KEY）: 未加工の API キー文字列に置き換えます。
プロジェクト ID（PROJECT_ID）: Google Cloud プロジェクト ID に置き換えます。
アクセストークン（ACCESS_TOKEN）: gcloud auth application-default print-access-token の署名なしトークンに置き換えます。

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-developer-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 ワークスペースでサーバーを使用できるようにするには、コマンドパレットを開き、[MCP: Open User Configuration] を実行して、ユーザープロファイルの mcp.json ファイルに次の行を追加します。

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

Codex

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

[mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

その他

他のリモート MCP クライアント（JetBrains AI Assistant、Windsurf、Cline、Zed、Continue、Claude Desktop など）を構成する場合、またはサードパーティクライアントで ADC 署名なしトークンまたは OAuth 2.0 クライアント ID を使用する場合は、認証方法を選択します。

API キー

次の設定で 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"
      }
    }
  }
}

ADC 署名なしトークン

MCP クライアントに ADC のサポートが組み込まれていない場合は、gcloud auth application-default print-access-token からベアラートークンと Google Cloud プロジェクト ID をリクエストヘッダーに渡すことで、ADC で認証できます。

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN",
        "X-Goog-User-Project": "PROJECT_ID"
      }
    }
  }
}

X-Goog-User-Project ヘッダーには、プロジェクトに対する serviceusage.services.use 権限が必要です。プロジェクトオーナーと編集者にはこの権限が付与されます。他のユーザーには、Service Usage コンシューマー（roles/serviceusage.serviceUsageConsumer）など、このロールを含むロールが必要です。

OAuth クライアント ID

スタンドアロンの OAuth 2.0 クライアント ID とシークレットを使用して認証するには:

API キーヘッダーなしで MCP サーバーエンドポイントをクライアント構成に追加します。
```
{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}
```
注: VS Code では、mcpServers ではなく、最上位の servers キーが使用されます。ワークスペースとして開いたフォルダの .vscode/mcp.json にサーバーを追加するか、コマンドパレットから MCP: Open User Configuration を実行して、すべてのワークスペースで使用できるようにします。VS Code のファイル構造については、[GitHub Copilot] タブを参照し、headers セクションを省略してください。
クライアントの OAuth 設定を完了します。
- インタラクティブプロンプト（VS Code など）: テストプロンプトをエージェントに送信します。動的クライアント登録がサポートされていないというメッセージが表示されたら、続行してクライアント ID とクライアントシークレットを入力し、Google アカウントでログインします。
- 静的 OAuth 構成（Cursor や Claude Code など）: クライアントの OAuth 設定で、OAuth クライアント ID、クライアントシークレット、リダイレクト URI を指定します。クライアント固有の手順については、AI アプリケーションで MCP を構成するをご覧ください。
クライアントから OAuth スコープを指定するよう求められた場合は、https://www.googleapis.com/auth/devprofiles.full_control を使用します。

この構成で Google Cloud プロジェクト ID を指定する必要はありません。リクエストは、OAuth クライアント ID を所有するプロジェクトに帰属します。

接続を確認する

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

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

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

Developer Knowledge エージェントスキルを使用する

公式の retrieving-developer-knowledge エージェントスキルをインストールして、Developer Knowledge MCP サーバーが提供するコアツールをいつどのように使用するかをアシスタントに教えます。

エージェントスキルは、AI コーディング支援がタスクを開始する前に読み取る一連の指示です。retrieving-developer-knowledge スキルは、オープンエージェントスキル標準をサポートするアシスタントと連携し、アシスタントが次の処理を行うのに役立ちます。

適切なツールを選択する: 幅広い「How-to」に関する質問や比較には answer_query を使用し、正確な CLI フラグ、IAM 権限、コード構文を検索する場合は search_documents（2 ～ 5 個のキーワードに焦点を当てる）を使用するようにアシスタントに指示します。
回答する前にエラーを確認する: 回答を記述する前に、ドキュメントの検索が実際に成功したことを確認するようアシスタントに指示します。これにより、API キーや割り当てエラーをドキュメントの欠落と誤認したり、古いトレーニングデータから推測したりすることを回避できます。
REST API にフォールバックする: エディタが MCP サーバーをサポートしていない場合や、MCP 接続が失敗した場合に、アシスタントに curl コマンドを提供して Developer Knowledge API を直接呼び出します。

エージェントスキルをインストールする

コーディングアシスタントを選択して、プロジェクトディレクトリに retrieving-developer-knowledge スキルをインストールします。

Google Antigravity

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=antigravity

Claude Code

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=claude-code

Cursor

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=cursor

Codex

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=codex

その他

オープンなエージェントスキル標準をサポートする他の AI アシスタントの場合は、次のコマンドを実行します。

npx skills add google/skills --skill retrieving-developer-knowledge

インストールされているスキルを最新バージョンに更新するには、次のコマンドを実行します。

npx skills update

スキルに関する完全な手順とリファレンスガイドについては、GitHub の retrieving-developer-knowledge ディレクトリをご覧ください。

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

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

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

エージェントスキルをインストールする（推奨）: retrieving-developer-knowledge エージェントスキルをインストールして、アシスタントが適切な検索ツール（answer_query または search_documents）を自動的に選択し、短いキーワード検索を使用して、必要な場合にのみページ全体をダウンロードするようにします。
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?
```
カスタムエージェントルールを追加する: retrieving-developer-knowledge スキルを使用していない場合は、アシスタントの指示ファイル（.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 を有効にする

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

リモート 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 は、実際の Google Cloud プロジェクト ID に置き換えます。

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

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

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

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

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

PROJECT_ID は、Google Cloud プロジェクト 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 サーバーへの接続またはクエリで問題が発生した場合は、次の表で症状またはエラーメッセージを確認してください。

設定エラーと接続エラー

症状またはエラー	考えられる原因	解決策
`/mcp` エンドポイントの `404 NOT_FOUND`	プロジェクトで API が有効になっていません。	Google Cloud コンソールで Developer Knowledge API を有効にするか、`gcloud services enable developerknowledge.googleapis.com` を実行します。
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	Google Cloud プロジェクトで Developer Knowledge API が有効になっていません。	Google Cloud コンソールで API を有効にするか、`gcloud services enable developerknowledge.googleapis.com` を実行します。
MCP ツールが見つからない、または接続に失敗する	コーディングツールがリモート HTTP MCP サーバーをサポートしていないか、サーバーに接続できない。	`retrieving-developer-knowledge` エージェントスキルをインストールします。これにより、MCP ツールが使用できない場合に、`curl` を使用して Developer Knowledge API REST エンドポイントにフォールバックする方法がアシスタントに指示されます。

API キーのエラー

症状またはエラー	考えられる原因	解決策
`400 Bad Request: API key not valid`	API キー文字列がないか、無効であるか、形式が正しくありません。	API キーが正しくコピーされ、`X-Goog-Api-Key` キーを使用して `headers` オブジェクトに構成されていることを確認します。URL のクエリパラメータとして API キーを渡さないでください。
`403 PERMISSION_DENIED: API target restriction`	API キーの制限リストに Developer Knowledge API が含まれていない。	Google Cloud コンソールの [認証情報] ページで API キーの制限を更新して、Developer Knowledge API を含めます。

OAuth エラーと ADC エラー

症状またはエラー	考えられる原因	解決策
`401 UNAUTHENTICATED` または ADC 認証情報がない	アプリケーションのデフォルト認証情報または ADC 署名なしトークンの有効期限が切れているか、初期化されていません。	`gcloud auth application-default login --project=PROJECT_ID` を実行してローカル認証情報を更新するか、`gcloud auth application-default print-access-token` を実行して新しいベアラートークンを生成します。
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	リクエストは、`X-Goog-User-Project` ヘッダーなしで ADC 署名なしトークンを使用します。	Google Cloud プロジェクト ID を含む `X-Goog-User-Project` ヘッダーを MCP クライアント構成に追加します。
`X-Goog-User-Project` ヘッダーを含む `403 PERMISSION_DENIED`	アカウントに、ヘッダーのプロジェクトに対する `serviceusage.services.use` 権限がありません。	プロジェクト管理者に、Service Usage コンシューマーロール（`roles/serviceusage.serviceUsageConsumer`）を付与するよう依頼します。
`403 access_denied` / 「アクセスがブロックされました: 認証エラー」	OAuth 同意画面でテストモードの外部ユーザータイプが使用されており、アカウントがテストユーザーとして登録されていない。	Google Cloud コンソール > Auth Platform > [オーディエンス] で、[テストユーザー] に有効な Google メールアドレスを追加します。
OAuth クライアントエラーまたは無効なリダイレクト URI	OAuth クライアントが、サポートされていないアプリケーションタイプで作成されたか、リダイレクト URI がありません。	対話型プロンプトを使用するクライアント（VS Code など）の場合は [デスクトップアプリ] を使用し、クライアントの承認済みリダイレクト URI（Cursor や Claude Code など）の場合は [ウェブアプリケーション] を使用します。

割り当てと安全フィルタのエラー

症状またはエラー	考えられる原因	解決策
`429 RESOURCE_EXHAUSTED`	プロジェクトの割り当て上限に達しました。	Google Cloud コンソールの Developer Knowledge API の割り当てページで使用状況を確認します。上限の詳細と引き上げのリクエストについては、Developer Knowledge API の割り当てをご覧ください。
`403 PERMISSION_DENIED`（Model Armor を使用）	Model Armor PIJB フィルタの誤検出により、安全なクエリがブロックされました。	Model Armor テンプレート設定で、PIJB フィルタの信頼度を `HIGH_AND_ABOVE` に設定します。

含まれるドキュメント

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

既知の制限事項

公開ドキュメントのみ: サーバーは、コーパスリファレンスに記載されている一般公開のドキュメントのみをインデックスに登録します。内部ドキュメント、非公開リポジトリ、サードパーティリソースは含まれません。
英語: サーバーは英語のドキュメントのみをインデックスに登録して返します。
ネットワーク依存関係と VPC Service Controls: Developer Knowledge MCP サーバーはリモートホスト型サービスであるため、クライアントは https://developerknowledge.googleapis.com に到達するためのネットワーク接続が必要です。
- Google Cloud VPC ネットワーク内: 公共のインターネットへの下り（外向き）は必要ありません。developerknowledge.googleapis.com にプライベートにアクセスするには、外部 IP アドレスや Cloud NAT を使用せずに、プライベート Google アクセス（private.googleapis.com / 199.36.153.8/30）または all-apis バンドルをターゲットとする Private Service Connect（PSC）エンドポイントを使用してトラフィックを転送します。
- VPC Service Controls（VPC-SC）: developerknowledge.googleapis.com は、制限付き VIP（restricted.googleapis.com / 199.36.153.4/30）または PSC vpc-sc エンドポイントではサポートされていません。VPC が *.googleapis.com を restricted.googleapis.com に転送する場合は、developerknowledge.googleapis.com が private.googleapis.com（199.36.153.8/30）に解決されるように、の特定の Cloud DNS 応答ポリシーまたは限定公開 DNS レコードを構成します。

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

MCP サーバーの機能

認証方法を選択する

API キー

前提条件

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

Google Cloud Console

gcloud CLI

OAuth と ADC

前提条件

API を有効にする

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

ADC

OAuth クライアント ID

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

Google Antigravity

Antigravity IDE と拡張機能

Google 認証情報

API キー

Antigravity CLI

Google 認証情報

API キー

Claude Code

Cursor

GitHub Copilot

ワークスペースの設定

グローバル ユーザー設定

Codex

その他

API キー

ADC 署名なしトークン

OAuth クライアント ID

接続を確認する

Developer Knowledge エージェント スキルを使用する

エージェント スキルをインストールする

Google Antigravity

Claude Code

Cursor

Codex

その他

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

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

Model Armor を使用する

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

Model Armor を有効にする

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

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

Model Armor の設定を調整する

トラブルシューティング

設定エラーと接続エラー

API キーのエラー

OAuth エラーと ADC エラー

割り当てと安全フィルタのエラー

含まれるドキュメント

既知の制限事項

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

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

グローバルユーザー設定

Developer Knowledge エージェントスキルを使用する

エージェントスキルをインストールする

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