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

連線至 Developer Knowledge MCP 伺服器

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

如要從自己的應用程式或代理程式碼 (而非 IDE) 連線至 Developer Knowledge MCP 伺服器，請參閱「使用 MCP SDK 連線」。

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 Dynamic Client Registration (DCR)。

前往品牌宣傳頁面，然後選取專案。輸入「應用程式名稱」和「使用者支援電子郵件」，然後按一下「儲存」。
前往「Audience」(目標對象) 頁面，將「User type」(使用者類型) 設為「External」(外部)。
在同一頁面中，按一下「測試使用者」下方的「新增使用者」，輸入您的 Google 電子郵件地址，然後按一下「儲存」。
前往「用戶端」頁面，點選「建立用戶端」，然後選擇 MCP 用戶端所需的應用程式類型：
- 如果電腦版用戶端會提示輸入用戶端 ID 和密鑰 (例如 VS Code)，請選取「電腦版應用程式」。
- 選取「網頁應用程式」，並為需要靜態 OAuth 重新導向回呼的用戶端 (例如 Cursor 或 Claude Code 自訂連結器) 新增用戶端的重新導向 URI。請使用用戶端記錄的確切重新導向 URI；系統不支援自訂重新導向 URI。如需用戶端專屬的重新導向 URI，請參閱「在 AI 應用程式中設定 MCP」。
按一下「Create」(建立)，然後複製「Client ID」(用戶端 ID) 和「Client secret」(用戶端密鑰) (或下載 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 伺服器，請按照下列步驟操作：

在「Agent」面板中，按一下「Additional options」(其他選項) 選單，然後選取「MCP Servers」(MCP 伺服器)。
搜尋「Google Developer Knowledge」。
按一下「Install」圖示 ()。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 助理、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 用戶端未內建應用程式預設憑證支援，您可以透過 gcloud auth application-default print-access-token 傳遞不記名權杖，並在要求標頭中傳遞 Google Cloud 雲端專案 ID，藉此使用應用程式預設憑證進行驗證：

{
  "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: Open User Configuration，即可在所有工作區中使用。如要瞭解 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 伺服器提供的核心工具。

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

選擇合適的工具：引導助理在遇到廣泛的「How-to」問題和比較時使用 answer_query，並在查詢確切的 CLI 旗標、IAM 權限或程式碼語法時使用 search_documents (搭配兩到五個重點關鍵字)。
先檢查錯誤再回答：指示助理先確認文件搜尋是否成功，再撰寫答案，以免將 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)、使用簡短關鍵字搜尋，並僅在需要時下載完整網頁。
依賴兩步驟檢索：讓代理程式先呼叫 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 伺服器的防護機制

您可以使用 Model Armor 底限設定，保護 MCP 工具呼叫和回覆。底限設定會定義適用於整個專案的最低安全性篩選條件。這項設定會對專案中的所有 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」 >「目標對象」中，將您有效的 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：由於開發人員知識 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)：受限 VIP (restricted.googleapis.com/199.36.153.4/30) 或 PSC vpc-sc 端點不支援 developerknowledge.googleapis.com。如果虛擬私有雲將 *.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 伺服器