Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

連線至 Developer Knowledge MCP 伺服器

Google Developer Knowledge MCP 伺服器可讓 AI 輔助開發工具直接搜尋及擷取 Firebase、Google Cloud、Android、Google Maps Platform 等產品的官方 Google 開發人員說明文件。將程式碼輔助工具連結至 Google 的權威文件庫，即可避免手動搜尋網路、使用過時的內容，以及進行網頁擷取。

MCP 伺服器功能

Google Developer Knowledge MCP 伺服器為 AI 程式設計助理提供三項核心工具：

工具名稱	說明
`search_documents`	搜尋 Google 開發人員說明文件，並傳回最相關的網頁摘錄內容和文件名稱。
`get_documents`	使用 `search_documents` 傳回的名稱，擷取文件的完整 Markdown 內容。
`answer_query`	從開發人員知識集生成結構化答案。

這項search_documents工具會搜尋 Google 的說明文件，找出與查詢最相關的章節。提問後，這項工具會傳回簡短的文字段落。如果代理程式需要段落周圍的完整網頁內容，可以將文件的資源名稱傳遞至 get_documents，擷取整個網頁。

如要直接從開發人員知識內容取得問題的答案，而非原始搜尋結果或完整的 Markdown 檔案，請使用 answer_query 工具。

選擇驗證方式

視開發環境和 AI 助理而定，Developer Knowledge MCP 伺服器支援兩種驗證方法：

API 金鑰：最適合第三方 IDE 和 CLI 代理程式，例如 Claude Code、Cursor、GitHub Copilot、Codex 和其他遠端 MCP 用戶端。透過 HTTPS 在 X-Goog-Api-Key 標頭中傳遞 API 金鑰。
OAuth 和 ADC：最適合 Google Antigravity，因為這項服務內建支援應用程式預設憑證 (ADC)，或適合需要 OAuth 2.0 不記名權杖或獨立 OAuth 2.0 用戶端 ID (而非 API 金鑰) 的企業工作流程。

產生所選驗證方式所需的憑證，讓 AI 助理或程式設計代理程式向 Developer Knowledge MCP 伺服器服務驗證要求。

選取分頁來建立憑證：

API 金鑰

必要條件

建立 API 金鑰前，請確認您已完成下列事項：

Google Cloud 專案。
已安裝 gcloud CLI (如要透過指令列設定)。

啟用 API 並建立 API 金鑰

您可以使用 Google Cloud 控制台或 gcloud CLI 產生 API 金鑰：

Google Cloud Console

在 Google Cloud 控制台中開啟 Developer Knowledge API 頁面。
選取 Google Cloud 雲端專案，然後按一下「啟用」。
前往「Credentials」(憑證) 頁面。
按一下「建立憑證」並選取「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 前，請確認您具備：

Google Cloud 專案。
已安裝 gcloud CLI。

啟用 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 標頭中使用：
```
gcloud auth application-default print-access-token
```

OAuth 用戶端 ID

如果 AI 助理使用互動式 OAuth 流程，請建立 OAuth 2.0 用戶端 ID 和密鑰，因為 Google 遠端 MCP 伺服器不支援 OAuth 動態用戶端註冊 (DCR)。

前往品牌宣傳頁面，然後選取專案。輸入「應用程式名稱」和「使用者支援電子郵件」，然後按一下「儲存」。
前往「目標對象」頁面，然後將「使用者類型」設為「外部」。
在同一頁面中，按一下「測試使用者」下方的「新增使用者」，輸入 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 檔案中設定 MCP 伺服器 (或在 ~/.gemini/config/mcp_config.json 中全域設定)：

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 工作區中都可使用，請開啟「Command Palette」(指令面板)，執行「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 傳輸伺服器：

伺服器網址：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"
      }
    }
  }
}

專案必須具備 serviceusage.services.use 權限，才能使用 X-Goog-User-Project 標頭。專案擁有者和編輯者具備這項權限。其他使用者則需要包含這項權限的角色，例如服務使用情形消費者 (roles/serviceusage.serviceUsageConsumer)。

OAuth 用戶端 ID

如要使用獨立的 OAuth 2.0 用戶端 ID 和密鑰進行驗證，請按照下列步驟操作：

在用戶端設定中新增 MCP 伺服器端點，但不要加入 API 金鑰標頭：
```
{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}
```
注意： VS Code 使用頂層 servers 鍵，而非 mcpServers。將伺服器新增至您以工作區開啟的資料夾中的 .vscode/mcp.json，或從指令區塊執行 MCP：開啟使用者設定，讓伺服器在所有工作區中都可用。如要瞭解 VS Code 檔案結構，請參閱「GitHub Copilot」分頁，並省略 headers 區段。
為用戶端完成 OAuth 設定：
- 互動式提示 (例如 VS Code)：將測試提示傳送至代理。如果系統提示不支援 Dynamic Client Registration，請繼續操作並輸入「用戶端 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 伺服器提供的核心工具。

Agent Skills 是一組指令，AI 程式設計助理會在開始工作前讀取這些指令。retrieving-developer-knowledge 技能適用於支援開放式代理程式技能標準的任何助理，可協助助理執行下列操作：

選擇合適的工具：引導助理使用 answer_query 回答廣泛的「如何」問題和比較，並使用 search_documents (搭配兩到五個重點關鍵字) 查詢確切的 CLI 標記、IAM 權限或程式碼語法。
先檢查錯誤再回答：指示助理先確認文件搜尋是否成功，再撰寫答案，以免將 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

其他

如要使用支援開放式 Agent Skills 標準的其他 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)，使用簡短的關鍵字搜尋，並僅在需要時下載完整網頁。
依賴兩步驟檢索：讓代理程式先呼叫 search_documents，這會傳回重點程式碼片段 (區塊)，通常包含您需要的確切語法或 API 簽章，且不會耗用整頁的權杖。指示代理只有在周遭情境絕對必要時，才呼叫 get_documents。
概念性問題請使用 answer_query：需要生成說明或設計比較時，請指示服務專員使用 answer_query。這項工具會直接從開發人員知識庫生成答案，不會傳回完整的原始 Markdown 網頁。
撰寫具體且範圍明確的提示：避免使用範圍過於廣泛的提示，例如「說明所有 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 工具可執行多種動作，因此會帶來新的安全風險和考量。為盡量降低及管理這些風險，Google Cloud 提供預設設定和可自訂的政策，控管 Google Cloud 組織或專案中 MCP 工具的使用情形。

如要進一步瞭解 MCP 安全性和管理，請參閱「AI 安全性」。

使用 Model Armor

Model Armor 是一項 Google Cloud 服務，可以提高 AI 應用程式的安全性。這項功能會主動篩選 LLM 提示詞和回覆，防範各種風險並支援負責任的 AI 做法。無論您是在雲端環境或外部雲端供應商部署 AI，Model Armor 都能協助您防範惡意輸入、驗證內容安全性、保護敏感資料、維持法規遵循狀態，以及在多元的 AI 環境中，持續落實 AI 安全政策。

啟用 Model Armor 並啟用記錄功能後，Model Armor 會記錄整個酬載。這可能會導致記錄中的私密資訊外洩。

MCP 要求轉送至 Model Armor

Model Armor 僅在特定區域推出。啟用 Model Armor 後，如果您在 Model Armor 不支援的管轄區使用 MCP 伺服器，不同 MCP 伺服器的呼叫路徑行為可能不同，且可能會違反使用中和傳輸中資料的資料落地法規。如要進一步瞭解個別 MCP 伺服器的行為，請參閱「Model Armor 支援的產品」。

啟用 Model Armor

按照「與 Google 和 Google Cloud MCP 伺服器整合」中的步驟操作，啟用 Model Armor。

設定遠端 MCP 伺服器的防護機制

如要保護 MCP 工具呼叫和回應，可以使用 Model Armor 底限設定。底限設定會定義適用於整個專案的最低安全性篩選條件。這項設定會對專案中的所有 MCP 工具呼叫和回覆套用一致的篩選器。

設定 Model Armor 底限設定，並啟用 MCP 清理功能。詳情請參閱「設定 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 流量

如要停止讓 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 替換為 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 伺服器，請在下表找出您的症狀或錯誤訊息。

設定及連線錯誤

症狀或錯誤	可能原因	解析度
`404 NOT_FOUND` 的 `/mcp` 端點	專案未啟用 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 金鑰已正確複製，並在 `headers` 物件中以 `X-Goog-Api-Key` 金鑰設定。請勿在網址中以查詢參數的形式傳遞 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`	要求使用 ADC 持有者權杖，但沒有 `X-Goog-User-Project` 標頭。	在 MCP 用戶端設定中，新增含有 Google Cloud 雲端專案 ID 的 `X-Goog-User-Project` 標頭。
`403 PERMISSION_DENIED` 標頭`X-Goog-User-Project`	您的帳戶缺少標題中專案的 `serviceusage.services.use` 權限。	請專案管理員授予您「服務使用情形用戶」角色 (`roles/serviceusage.serviceUsageConsumer`)。
`403 access_denied` / "Access blocked: authorization error"	您的 OAuth 同意畫面在測試模式下使用「外部」使用者類型，且您的帳戶未列為測試使用者。	在 Google Cloud 控制台中，依序點選「Auth Platform」>「Audience」，然後在「Test users」下方新增有效的 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 虛擬私有雲網路內部：不需要公開網際網路輸出。您可以使用 Private Google Access (private.googleapis.com / 199.36.153.8/30) 路由傳送流量，或使用以 all-apis 套裝組合為目標的 Private Service Connect (PSC) 端點，在沒有外部 IP 位址或 Cloud NAT 的情況下，私下連線至 developerknowledge.googleapis.com。
- 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 設定特定的 Cloud DNS 回應政策或私人 DNS 記錄，以解析為 private.googleapis.com (199.36.153.8/30)。

連線至 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

MCP 要求轉送至 Model Armor

啟用 Model Armor

設定遠端 MCP 伺服器的防護機制

停用使用 Model Armor 掃描 MCP 流量

調整 Model Armor 設定

疑難排解

設定及連線錯誤

API 金鑰錯誤

OAuth 和 ADC 錯誤

配額和安全篩選器錯誤

隨附文件

已知限制

連線至 Developer Knowledge MCP 伺服器