从您选择的编码助理处获取有关 Merchant API 的情境智能信息。在集成开发环境 (IDE) 中，您现在可以使用 Model Context Protocol (MCP) 服务访问开发者文档集成。此服务可为您的编码助理提供来自官方 Google API 文档的权威上下文，从而加快集成和迁移工作流程的开发速度。
如需详细了解该协议本身，请参阅 Model Context Protocol 标准。
概览
从 Content API for Shopping 迁移到 Merchant API 或构建新的集成时，您需要了解新的服务结构、资源名称和方法。MCP 服务通过向编码助理提供官方文档和代码示例来简化此流程。
该服务采用高度专业化的检索增强生成 (RAG) 后端。当您向支持 MCP 的 IDE 编码助理询问有关 Merchant API 的问题时，该服务会从 Google 的官方资源中检索最相关的文本和代码片段，并将其作为上下文返回给编码助理。这样一来，您的助理就可以提供准确、最新的答案，而您无需离开开发环境。
运作方式
使用 MCP 集成的开发者文档可集成到现代 AI 辅助开发工作流程中：
- 您在与 MCP 兼容的编码助理或代理中提出问题。这可以是自然语言问题、Merchant API 代码示例请求，甚至是直接将您的代码翻译为 Merchant API 的请求。
- 您的编码助理会向 MCP 端点发送上下文请求。
- MCP 服务会搜索其已编入索引的官方 Merchant API 文档、指南和代码示例集合，以找到最相关的信息。
- 该服务会将这些权威代码段作为上下文返回给编码助理。
- 您的编码助理会使用此高质量的上下文信息，针对您的原始问题生成准确且实用的答案，或执行代码翻译任务。
使用入门
如需使用 MCP，请按以下步骤操作：
1. 使用兼容的工具
打开支持 Model Context Protocol 且具有可流式传输的 HTTP 传输的 IDE 或编码助理。
2. 端点配置
如需将 IDE 或编码助理连接到 MCP，请使用提供的远程端点详细信息，这可能需要您输入直接服务网址或 MCP 定义（具体取决于工具的配置）。
服务网址为：
MCP Server Name: "MAPI Docs MCP"
MCP Server URL: "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"
3. 添加代理说明（可选）
如需让智能体能够使用 MCP 直接翻译代码，请为其提供系统指令：MerchantIntegrator 智能体协议。这些指令会指导代理如何正确利用 MCP 进行代码翻译。根据您使用的工具，您可以在系统指令配置中提供这些指令，也可以将其作为代理的其他上下文文件提供。
使用场景示例
在以下常见使用情形中，MCP 可以加快您的工作流程。
情景 1：迁移 products.insert 代码
您可以要求代理直接将 Content API for Shopping products.insert 集成代码迁移到 Merchant API。
用户提示：
“将
products.insert代码迁移到 Merchant API”
通过为代理提供 System Instructions: MerchantIntegrator Agent Protocol 并授予其对 MCP 的访问权限，您的代理可以直接在 IDE 中将 Content API for Shopping 代码转换为 Merchant API 代码。在这种情况下，它会将 productInputs.insert 识别为等效的调用，并将商品属性从旧格式映射到 Merchant API 所需的新格式。它还可以更新必需的导入和依赖项管理文件（例如 requirements.txt、pom.xml 或 package.json）。您可以指示代理就地进行更改，也可以指示代理创建一个新文件夹。
场景 2：查找等效功能
您有一个使用 Content API for Shopping 的现有应用，需要更新该应用。您可以询问有关特定旧版方法的问题，以详细了解新实现和相关代码示例。
用户提示：
“Merchant API 中与 Content API for Shopping 中的 accountstatuses.get 方法等效的方法是什么？”
MCP 服务可提供来自官方迁移指南和参考文档的上下文，让助理能够提供详细的回答，包括新的 API 名称 accounts.issues。
方案 3：查找代码示例
您正在实现一项新功能，需要一个可供参考的实用示例。
用户提示：
“向我展示一个使用 Merchant API 添加新配送服务的 Python 代码示例。”
MCP 服务从 Google 官方 GitHub 代码库和开发者指南中检索相关代码示例。然后，Google 助理可以呈现一个完整的、可随时调整的代码块。
情景 4：了解 API 概念
您遇到新概念，或者想了解资源结构或整个 Merchant API 模式。
用户提示：
“如何使用 Merchant API 更新商品的商品目录？”
MCP 服务会返回产品资源文档和相关指南中的上下文。然后，您的助理可以说明如何使用 accounts.productInputs.insert 方法，并提供仅包含 productId 和您需要更新的与商品目录相关的字段的部分商品资源。
“如何使用 Merchant API 授权我的应用调用？”
MCP 服务会从涵盖不同授权方法的官方身份验证指南中检索上下文。然后，您的助理可以说明可用的主要选项，例如使用服务账号进行服务器到服务器的互动，或者在代表用户执行操作时使用 OAuth 2.0 客户端 ID。
场景 5：适应 API 变更
Merchant API 引入了与 Content API for Shopping 不同的新模式，例如批处理请求。Content API for Shopping 使用特定的 custombatch 方法，而 Merchant API 使用内置的通用 HTTP 批处理功能。
用户提示：
“在 Merchant API 中，执行 products.custombatch 的新方式是什么？”
MCP 服务从重构代码以处理并发请求中检索上下文，说明 Merchant API 中不存在专用 custombatch 方法。相反，它提供了有关使用 HTTP 批处理的文档，其中 Content-Type 为 multipart。然后，您的助理可以说明如何构建包含多个 API 调用的单个 HTTP 请求（发送到 https://merchantapi.googleapis.com/batch/{sub-api}/v1 端点），并提供有关如何构建多部分请求的示例。这会将可能令人困惑的迁移任务转变为引导式流程。
知识库来源
MCP 服务仅从公开和官方来源构建知识库，以确保其提供的上下文准确可靠。该服务会为官方开发者网站和代码示例代码库的全部内容编制索引，包括：
- Merchant API 开发者网站：所有指南、参考资料和文档。
- Merchant API Apps 脚本服务：Apps 脚本中的 Merchant API 用法示例。
- 官方代码示例：GitHub 代码库中所有由 Google 提供的 Merchant API 官方代码示例。
- 客户端库：商家支持的所有官方客户端库