如何通过 MCP 将 Google Merchant Center 连接到 Claude

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Google Merchant Center、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Google Merchant Center + Claude

通过 Merchant API v1 在任意 AI 智能体中操作 Google Merchant Center：处理后的商品和商品输入，Feed（数据源），商品状态和问题，用 Merchant Center Query Language 生成的效果、价格竞争力和畅销商品报告，本地和区域库存，促销和通知。使用 Google 通过 OAuth 登录；删除类工具在安装时关闭。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_MERCHANT_ACCOUNT_ID

步骤 1 — 获取凭证

设置只需进行一次，大约 15 分钟。你需要一个 Merchant Center 账户、一个能访问该账户的 Google 用户（一次性注册项目需要 Admin）以及一个 Google Cloud 项目。该连接器使用 Merchant API v1（https://merchantapi.googleapis.com），它取代了 Content API for Shopping v2.1：Google 已于 2026 年 8 月 18 日停用该 API，自 2026 年 9 月 1 日起其调用越来越多地以 HTTP 410 失败，并将在 2027 年初彻底关闭。

1. 打开 https://console.cloud.google.com，选择或创建一个项目，然后进入 APIs & Services、Library，启用 Merchant API。
2. 在 APIs & Services、OAuth consent screen 中，Google Workspace 用户选择 Internal，否则选择 External 并把发布状态设为 In production。应用处于 Testing 状态时，Google 会在 7 天后撤销其 refresh token，连接器每周都会失效。
3. 在 Credentials、Create credentials、OAuth client ID 中选择类型 Web application，并添加已授权的重定向 URI <your AnythingMCP URL>/api/mcp-oauth/callback，在 AnythingMCP Cloud 上为 https://cloud.anythingmcp.com/api/mcp-oauth/callback。
4. 把客户端 ID 粘贴到 GOOGLE_CLIENT_ID，把客户端密钥粘贴到 GOOGLE_CLIENT_SECRET。在 GOOGLE_MERCHANT_ACCOUNT_ID 中填写 Merchant Center 账户 ID：Merchant Center 顶部商店名称旁边的数字，或其地址中 a= 后面的数字（merchants.google.com/mc/overview?a=123456789）。对于高级账户（多客户），要管理高级账户本身就用它的 ID，要管理某个店铺就用该子账户的 ID。
5. 在连接器页面点击 Authorize with Provider，用一个属于该 Merchant Center 账户用户的 Google 账户登录：设置和写入需要 Admin，商品和 Feed 需要 Standard，读取需要 Read only（Performance reporting 只覆盖效果报告）。
6. 一次性注册 Cloud 项目：运行 google_merchant_center_register_gcp_project，可以附带 developer_email。该 Google 账户会成为技术联系人并获得 API 开发者角色；如果它还不是该账户的用户，会收到一封需在 14 天内接受的邀请。注册完成之前，其他所有调用都会返回 401 GCP project with id ... is not registered with the merchant account。注册需要 Admin 用户，并在主账户（高级账户或独立账户）上进行，而不是在每个子账户上。google_merchant_center_get_developer_registration 会显示已注册的项目编号。
7. 运行 google_merchant_center_get_account 检查连接。

同一个 Cloud 项目和 OAuth 客户端可以服务所有 Google 连接器（Gmail、Google Calendar、Google Drive、Google Sheets、Search Console、Analytics、Ads、Merchant Center）：在该项目中启用每个 API，复用 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET，并为每个连接器各授权一次。

权限范围和账户：连接器请求 https://www.googleapis.com/auth/content，这是 Merchant API 唯一的 scope（读写）。AI 能做什么，受登录用户在 Merchant Center 中的权限限制；如果要只读的智能体，请用 Read only 用户登录，并关闭所有 insert、update、create、fetch 和 register 工具。一个连接器只处理 GOOGLE_MERCHANT_ACCOUNT_ID 中的那一个账户。google_merchant_center_list_accounts 列出用户能打开的所有账户，google_merchant_center_list_subaccounts 列出高级账户的子账户。要处理另一个账户，请用那个 ID 再安装一次连接器。

读取内容：账户及其时区和语言，商家信息（地址、电话、客户服务），首页及其验证和声明状态，带严重程度的账户问题，带资格状态的计划（免费商品详情、购物广告、本地商品详情、结账），运费设置，区域，用户及其访问权限，以及 API 配额。从所有数据源合并而来的处理后商品，包括其属性以及按目标平台和国家的 productStatus（含商品级问题）；按报告上下文和国家统计的状态数量以及最常见的问题。数据源（Feed）和最近一次文件上传的结果。每个商品的本地和区域库存，带审核状态的促销，以及通知订阅。用 Merchant Center Query Language 生成的报告：商品效果（点击、展示、CTR、转化），每个商品的状态和问题，价格竞争力和价格建议（suggested_price），畅销商品和竞争可见度。

写入内容：API 数据源中的商品输入（google_merchant_center_insert_product_input 创建或整体替换，google_merchant_center_update_product_input 修改 update_mask 中列出的字段，例如 product_attributes.price,product_attributes.availability），数据源（创建、修改、立即抓取文件 Feed），按门店或区域的本地和区域库存（insert 会替换该条目），促销数据源中的促销，以及在 PRODUCT_STATUS_CHANGE 或 ACCOUNT_SERVICE_CHANGE 时向 HTTPS 回调发送消息的通知订阅。来自文件 Feed 或在 Merchant Center 界面中添加的商品不能在这里编辑；请改用补充 API 数据源覆盖其属性。修改会在几分钟后出现在 google_merchant_center_get_product 中，广告和免费商品详情的审核可能需要几天，Google 会审核每个促销（该国家必须已启用促销计划）。

安装时关闭：google_merchant_center_delete_product_input、google_merchant_center_delete_local_inventory、google_merchant_center_delete_regional_inventory 和 google_merchant_center_delete_notification_subscription。这些操作无法撤销（被删除的商品会失去历史和状态），因此由管理员在团队需要时开启。

数据格式：商品 ID 为 contentLanguage~feedLabel~offerId，例如 en~US~sku123；包含 /、% 或 ~ 的 offer ID 需要把整个 ID 做不带填充的 base64url 编码后传入。资源名称是 accounts/123/dataSources/456 这样的路径，工具以最后一段作为 ID。金额以 micros 为单位：{"amountMicros": "19990000", "currencyCode": "EUR"} 即 19.99 EUR。大数字（micros、数量、ID）以 JSON 字符串返回。时间为 UTC 的 RFC 3339；报告中的 date 值使用账户时区。属性名为 camelCase（title、link、imageLink、availability、condition、gtins、brand、mpn、googleProductCategory、salePrice、shipping）。

报告：google_merchant_center_search_reports 接受 SELECT fields FROM table WHERE ... ORDER BY ... LIMIT n，字段名为 snake_case。条件只能用 AND 组合（用 IN 代替 OR），ORDER BY 只能用于已选字段。product_performance_view 和 non_product_performance_view 需要日期条件，例如 date DURING LAST_30_DAYS，以及至少一个指标。畅销商品表需要在筛选中包含 report_granularity 和 report_country_code。行以 results[] 返回，每行包含一个以表名命名的对象，例如 productPerformanceView。

分页和限制：列表工具返回 nextPageToken；AI 会带上 page_token 再次调用，直到它不再出现。google_merchant_center_list_products 默认每页 25 个商品，最多 1000 个；报告每页最多 100000 行（默认 1000 行）。google_merchant_center_list_quotas 按方法组显示每日和每分钟的上限以及今天的用量。商品写入按目录规模设有每日上限：请把批量修改分散进行，与其进行成千上万次单独更新，不如使用一个补充 Feed。

常见错误：401 GCP project with id ... is not registered 表示缺少第 6 步；其他 401 表示授权已过期或被撤销（同意屏幕处于 Testing 时 7 天后必然发生）：请再次点击 Authorize with Provider。403 The caller does not have access to the accounts 表示登录用户不是该账户的用户，或 GOOGLE_MERCHANT_ACCOUNT_ID 有误；403 Merchant API has not been used in project 表示 API 未启用（第 1 步）。商品输入返回 400 表示缺少必填属性或拼写错误，或者数据源不是 API 数据源。404 表示商品、数据源或促销 ID 不存在。429 RESOURCE_EXHAUSTED 表示配额已用完：查看 google_merchant_center_list_quotas 并稍后重试。

该连接器不处理订单和退货，不修改运费或退货政策，不创建账户或管理用户，不读取商品评价，也不管理 Google Ads 广告系列（那是 Google Ads 连接器的工作）。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Claude 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

推荐路径：在 claude.ai web 上工作，无需触碰任何配置文件。

1. 在 Claude 中打开 Customize → Connectors。
2. 点击 +，然后点击 Add custom connector。
3. 输入名称（例如 Google Merchant Center）和远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，然后点击 Add。
4. 点击 Connect，登录 AnythingMCP（OAuth）并允许访问。

下面所有工具都会出现在你的聊天中，开始输入提示。

可用工具

示例提示

• “给店铺做一次健康检查：账户问题，以及每个国家有多少商品被拒登。”
• “哪些商品不符合资格或被拒登？每个需要修复什么？”
• “显示过去 30 天点击量最高的 20 个商品，附带展示次数和 CTR。”
• “哪些商品的价格高于基准价格？按差距从大到小列出。”
• “把商品 enUSsku123 设为 OUT_OF_STOCK。发送前先给我看修改内容。”

FAQ

Claude Code 和 Claude Desktop 一样工作吗? 是的，两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。

下一步

• 连接器主页
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot