实验这是一个实验性 API 版本，仅用于测试和反馈。

连接到开发者知识 MCP 服务器

Google Developer Knowledge MCP 服务器让 AI 赋能的开发工具能够搜索 Google 的官方开发者文档，并检索 Google 产品（例如 Firebase、Google Cloud、Android、Google 地图等）的相关信息。通过将 AI 应用直接连接到我们的官方文档库，可确保您收到的代码和指南是最新的，并且基于权威的上下文。

设置服务器后，集成式工具可以帮助您处理以下请求：

植入指南
- 例如：在 Android 应用中，使用 Firebase Cloud Messaging 实现推送通知的最佳方式是什么？
代码生成和说明
- 例如：在 Google 文档中搜索用于列出 Cloud Storage 项目中所有存储分区的 Python 示例。
问题排查和调试
- 例如：为什么我的 Google 地图 API 密钥显示“仅用于开发目的”水印？
比较分析和总结
- 例如：帮我为新的微服务选择 Cloud Run 还是 Cloud Functions。创建一个 Markdown 表格，比较主要应用场景、并发和价格模式等关键方面。

MCP 服务器功能

Google 开发者知识 MCP 服务器可为您的 AI 应用提供以下工具：

工具名称	说明
`search_documents`	搜索 Google 的开发者文档（Firebase、Google Cloud、Android、Maps 等），查找与您的查询相关的网页和代码段。将 `get_documents` 与搜索结果中的 `parent` 搭配使用，即可获取完整网页内容。
`get_documents`	使用 `search_documents` 结果中的 `parent` 获取多个文档的完整内容。

search_documents 工具会将文档划分为较小的文本块，这些文本块经过优化，可用于 AI 赋能的搜索和检索。当您进行搜索时，该工具会返回一个或多个与您的查询相关的文档片段。如果您需要查看摘要周围的完整网页内容，请使用搜索结果中提供的 parent 将 get_documents 与之搭配使用，以检索完整网页内容。

安装

Google Developer Knowledge MCP 服务器是一个远程 MCP 服务器，它使用 Developer Knowledge API 来搜索和检索文档。您可以使用 OAuth 或 API 密钥进行身份验证。

使用 OAuth 进行身份验证

本部分将指导您完成使用 OAuth 向 Developer Knowledge MCP 服务器进行 AI 应用身份验证的过程。

前提条件：设置 Google Cloud CLI

在继续操作之前，请确保您已备妥：

第 1 步：在项目中启用 Developer Knowledge API

在 Google API 库中打开 Developer Knowledge API 页面。
检查您是否已选择要使用相应 API 的正确项目。
点击启用。启用或使用该 API 不需要任何特定的 IAM 角色。

第 2 步：在项目中启用开发者知识 MCP 服务器

如需启用 Developer Knowledge MCP 服务器，请运行以下命令，并将 PROJECT_ID 替换为您的 Google Cloud 项目 ID：

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

如果没有为您的 Google Cloud 项目启用 Developer Knowledge 服务，系统会提示您先启用该服务，然后再启用远程 MCP 服务器。

作为安全性最佳实践，我们建议您仅为 AI 应用正常运行所需的服务启用 MCP 服务器。

第 3 步：选择身份验证方法

您选择的身份验证方法取决于 AI 助理是否支持使用 gcloud CLI 的应用默认凭证 (ADC)，或者是否需要独立的 OAuth 客户端 ID。Gemini CLI 等助理可以使用您现有的 Google Cloud 登录信息实现无缝设置，而 Antigravity 等其他助理则需要您手动创建并提供自己的凭据，以建立安全连接。

选择与特定 AI 助理的设置要求对应的标签页。

ADC

关联账号

如需授予 MCP 服务器代表您执行操作的权限，请运行以下命令，并将 PROJECT_ID 替换为您的 Google Cloud 项目 ID：
```
gcloud auth application-default login
--project=PROJECT_ID
```
出现提示时，选择一个账号，然后点击继续。

配置 AI 应用

完成身份验证后，最后一步是向 AI 应用提供服务器配置详细信息。虽然确切的 JSON 结构因应用而异，但您可以将以下示例用作模板。

如需配置 Gemini CLI 或 Gemini Code Assist，请修改或创建以下配置文件之一：

在项目中：.gemini/settings.json
在您的主目录中：~/.gemini/settings.json

{
  "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"
      }
    }
  }
}

如需检查 MCP 服务器是否按预期运行，请继续验证安装。

手动凭据

配置 OAuth 权限请求页面

配置项目的 OAuth 权限请求页面，并将自己添加为测试用户。如果您已为 Google Cloud 项目完成此步骤，请跳至下一步。

打开 Google Cloud 控制台的身份验证概览页面，然后点击开始。
输入应用名称，选择支持电子邮件地址，然后点击下一步。
在受众群体部分，选择外部，然后点击下一步。
在联系信息中输入您的电子邮件地址，然后点击下一步。
查看并同意《Google API 服务：用户数据政策》，然后点击继续。
点击创建。

添加测试用户

在 Google Auth Platform 中，点击受众群体。
在测试用户下，点击添加用户。
输入您的电子邮件地址和任何其他已获授权的测试用户，然后点击保存。

创建 OAuth 客户端

如需以最终用户身份进行身份验证并访问应用中的用户数据，您需要创建一个 OAuth 2.0 客户端 ID。客户端 ID 用于向 Google 的 OAuth 服务器标识单个应用。

在 Google Auth Platform 中，点击客户端。
点击创建客户端。
从应用类型选择器中，选择桌面应用。
在名称字段中，输入凭证的名称。此名称仅在 Google Cloud 控制台中显示。
点击创建。此时会显示“OAuth 客户端已创建”界面，其中显示您的新客户端 ID 和客户端密钥。
点击确定。新创建的凭证会显示在 OAuth 2.0 客户端 ID 下。
点击新创建的客户端 ID。在客户端密钥部分中，点击下载图标以保存 JSON 文件。您将在后续步骤中使用此文件中的 client_id 和 client_secret 值。

配置 AI 应用

接下来，您需要向 AI 应用提供服务器配置详细信息。虽然具体步骤因应用而异，但您可以将以下示例用作模板。

如需将 Antigravity 配置为使用 MCP 服务器，请执行以下操作：

在 Antigravity 中，依次点击“智能体”窗格中的其他选项 菜单 > MCP 服务器 > 管理 MCP 服务器。

在打开的“管理 MCP 服务器”窗格顶部，点击查看原始配置以修改 mcp_config.json 文件：

{
  "mcpServers": {
    "google-developer-knowledge": {
      "serverUrl": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}

返回到管理 MCP 服务器，然后点击刷新。

添加 OAuth 凭据

首次尝试使用开发者知识 MCP 服务器时，AI 助理会提示您完成设置：

使用以下提示要求代理使用开发者知识 MCP 服务器：
```
How do I list Cloud Storage buckets?
```
如果您看到一条消息，要求您注册一个或多个重定向 URI，请点击相应选项以继续。由于您将客户端 ID 设置为桌面应用，因此无需在 Google Auth 平台中添加这些特定 URI。
当 AI 助理提示您输入客户端 ID 和客户端密钥 时，请粘贴您之前保存的客户端密钥 JSON 文件中的每个相应密钥。
出现提示时，选择一个账号，然后点击继续。
返回到 AI 助理。代理现在将使用新验证的服务器处理您的请求。

使用 API 密钥进行身份验证

本部分将引导您完成以下过程：使用 API 密钥向 Developer Knowledge MCP 服务器验证 AI 应用的身份。

第 1 步：创建 API 密钥

您可以使用 Google Cloud 控制台或 gcloud CLI 在 Google Cloud 项目中生成 Developer Knowledge API 密钥：

Google Cloud Console

启用 API

在 Google API 库中打开 Developer Knowledge API 页面。
检查您是否已选择要使用相应 API 的正确项目。
点击启用。启用或使用该 API 不需要任何特定的 IAM 角色。

创建并保护 API 密钥

在您启用 API 的项目的 Google Cloud 控制台中，前往“凭据”页面。
点击创建凭据，然后从菜单中选择 API 密钥。“API 密钥已创建”对话框会显示新创建的密钥的字符串。
点击修改 API 密钥。
在名称字段中，提供密钥的名称。
在 API restrictions 下，选择 Restrict key。
在选择 API 列表中，启用 Developer Knowledge API，然后点击确定。
- 注意：如果您刚刚启用了 Developer Knowledge API，则该 API 可能需要过一段时间才会显示在选择 API 列表中。
点击保存。

创建密钥后，点击显示密钥即可查看。请记下此值，以便在配置 AI 应用时使用。

gcloud CLI

如果您尚未下载并安装 gcloud CLI，请先执行此操作。
启用 Developer Knowledge API，并将 PROJECT_ID 替换为您的 Google Cloud 项目 ID：
```
gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID
```
使用同一 Google Cloud 项目 ID 创建 API 密钥：
```
gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
```
此命令会返回 API 密钥字符串。记下此值，以便在配置 AI 应用时使用。
通过添加 API 密钥限制来保护 API 密钥。为提高安全性，请将 API 密钥限制为仅适用于 Developer Knowledge API。

第 2 步：在项目中启用开发者知识 MCP 服务器

如需在 Google Cloud 项目中启用 Developer Knowledge MCP 服务器，请下载并安装 gcloud CLI，然后运行以下命令，将 PROJECT_ID 替换为您的 Google Cloud 项目 ID：

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

如果没有为您的 Google Cloud 项目启用 Developer Knowledge 服务，系统会提示您先启用该服务，然后再启用远程 MCP 服务器。

作为安全性最佳实践，我们建议您仅为 AI 应用正常运行所需的服务启用 MCP 服务器。

第 3 步：配置 AI 应用

按照以下说明配置热门 AI 应用。将 YOUR_API_KEY 替换为您在上一步中生成的 Developer Knowledge API 密钥：

Gemini CLI

如需配置 Gemini CLI，请运行以下命令：

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

或者，修改或创建以下配置文件之一：

在项目中：.gemini/settings.json
在您的主目录中：~/.gemini/settings.json

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

Gemini Code Assist

如需配置 Gemini Code Assist，请修改或创建以下配置文件之一：

在项目中：.gemini/settings.json
在您的主目录中：~/.gemini/settings.json

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

Claude Code

如需配置 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/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"
      }
    }
  }
}

如需使服务器在每个项目中可用，请修改用户设置。点击 Open Settings (JSON) 按钮。

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

Windsurf

如需配置 Windsurf 编辑器，请修改 ~/.codeium/windsurf/mcp_config.json 文件。

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

验证安装

配置完成后，打开 AI 应用并输入提示，例如：

How do I list Cloud Storage buckets?

如果您看到对 search_documents 或其他开发者知识 MCP 服务器工具的工具调用，则表示服务器正常运行。

管理令牌使用情况

检索文档内容（尤其是使用 batch_get_documents 时）会消耗 AI 应用上下文窗口中的令牌。由于某些 Google 开发者文档页面非常大，因此提取多个文档可能会迅速导致费用增加、模型响应时间变慢以及上下文窗口溢出。

为了优化性能并避免收到意外的账单，请精心设计具体提示，以便仅获取所需信息。避免提出宽泛的请求（例如“比较所有 Firebase 产品”），以免迫使代理一次性提取大量数据。

包含的文档

如需了解服务器搜索哪些文档，请参阅语料库参考。

已知限制

内容范围：仅包含语料库参考中公开可见的网页。其他来源（例如 GitHub、OSS 网站、博客或 YouTube）的内容不包括在内。
仅限英语的结果：服务器仅支持英语结果。
依赖于网络：服务器的工具依赖于实时 Google Cloud 服务。如果您遇到持续性错误，请检查您的互联网连接和 Developer Knowledge API 密钥配置。

问题排查

如果您遇到问题，请确认以下事项：

AI 工具的 MCP 配置文件格式正确。
如果使用 API 身份验证方法，您在配置文件中使用了有效的 Developer Knowledge API 密钥，该密钥已启用 Developer Knowledge API。
您尚未用尽 Developer Knowledge API 配额。

Model Armor

如果您使用 Model Armor 来保护应用，则可能会遇到某些查询的 403 PERMISSION_DENIED 错误。由于 Developer Knowledge MCP 服务器仅返回来自可信 Google 来源的公开文档，因此我们建议将提示注入和越狱 (PIJB) 过滤条件的置信度级别设置为 HIGH_AND_ABOVE，以减少误报。如果您的使用场景不涉及访问私密或敏感数据的其他工具，您还可以考虑停用 PIJB 过滤器。

连接到开发者知识 MCP 服务器 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

MCP 服务器功能

安装

使用 OAuth 进行身份验证

前提条件：设置 Google Cloud CLI

第 1 步：在项目中启用 Developer Knowledge API

第 2 步：在项目中启用开发者知识 MCP 服务器

第 3 步：选择身份验证方法

ADC

关联账号

配置 AI 应用

手动凭据

配置 OAuth 权限请求页面

添加测试用户

创建 OAuth 客户端

配置 AI 应用

添加 OAuth 凭据

使用 API 密钥进行身份验证

第 1 步：创建 API 密钥

Google Cloud Console

启用 API

创建并保护 API 密钥

gcloud CLI

第 2 步：在项目中启用开发者知识 MCP 服务器

第 3 步：配置 AI 应用

Gemini CLI

Gemini Code Assist

Claude Code

光标

GitHub Copilot

Windsurf

验证安装

管理令牌使用情况

包含的文档

已知限制

问题排查

Model Armor

连接到开发者知识 MCP 服务器