如何通过 MCP 将 Meta Catalog 连接到 Gemini

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

Meta Catalog + Gemini

让你的 AI 检查和维护 Meta 商品目录（Commerce Manager）：包含价格、库存和审核状态的商品、商品组、数据 Feed 及上传错误，以及目录诊断。在你确认后，还能批量更新、添加或删除商品（安装时关闭）。

前提条件

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

META_CATALOG_ACCESS_TOKEN, META_CATALOG_BUSINESS_ID

步骤 1 — 获取凭证

设置大约需要 10 分钟。你需要一个在 Commerce Manager 中有商品目录的 Meta 业务资产组合，以及一个 Meta 应用。

1. 打开 developers.facebook.com/apps/creation，创建一个关联到你业务资产组合的商务应用。如果你已经在用 Meta Ads 连接器，可以直接复用它的应用。
2. 推荐使用不会过期的令牌：在 Business Settings 中打开 Users → System users，添加一个系统用户。在 Assign assets → Catalogs 中把你的目录分配给它（Manage catalog，如果 AI 只需读取则选 View catalog）。点击 Generate token，选择应用，有效期选 Never，并勾选 catalog_management 和 business_management。Meta 可能会先要求你验证业务资产组合。
3. 把令牌粘贴到 META_CATALOG_ACCESS_TOKEN。它以 EA 开头；粘贴时不要带 Bearer 一词。
4. 把业务资产组合 ID 填入 META_CATALOG_BUSINESS_ID：只有数字，可在 Business Settings → Business info 中找到，或取 business.facebook.com 地址栏里的 business_id=。使用系统用户令牌时，meta_catalog_list_businesses 会返回空列表，所以请从 Business Settings 中获取 ID。
5. 安装连接器并运行 meta_catalog_check_permissions：两项权限都应显示为 granted。然后 meta_catalog_list_catalogs 会列出你的目录及其商品数量。

改用用户令牌时：在 Graph API Explorer 中生成的用户令牌（你的应用、User Token、同样两项权限）只有一到两小时有效。请同时填写可选的 META_APP_ID 和 META_APP_SECRET（在应用的 App settings → Basic 中）：AnythingMCP 会在第一次调用时把它换成约 60 天有效的长期令牌，并在剩余不到 10 天时自动续期，和 Meta Ads 连接器一样。不填写的话，你需要自己在 Access Token Debugger 中延长令牌（Extend Access Token），并在 60 天到期前替换；连接器页面会提前提醒你。使用系统用户令牌时，这两项留空即可。

可读取的内容：你公司拥有的目录，以及客户共享给你公司的目录（以代理商或合作伙伴的视角，附带你在每个目录上的角色）；商品的 SKU（retailer_id）、名称、价格和促销价、供货状态、库存、审核状态（approved、pending、rejected、outdated）、可见性、错误和拒绝原因；商品组及其筛选规则和所含商品；数据 Feed 的计划、上传记录（检测到、已保存、无效和已删除的条目数）以及带行号和 SKU 的上传错误；还有 Commerce Manager 中显示的诊断，标记为 MUST_FIX 或 OPPORTUNITY。

找出商品为什么不展示：AI 先查看 meta_catalog_get_diagnostics，再列出有错误或处于某个审核状态的商品，然后用 meta_catalog_get_product 读取单个商品的具体错误和拒绝原因。遇到 Feed 问题时，它会依次查看 meta_catalog_list_feeds、meta_catalog_list_feed_uploads 和 meta_catalog_list_upload_errors。

每个商品有两个 ID：Meta 为每个商品分配自己的 ID，而你的 SKU 是 retailer_id（Feed 中的 id 列）。AI 对单个商品使用 Meta ID，批量修改和筛选时使用 SKU。价格以带货币的文本返回，例如 19.99 EUR。

改动会出现在广告和商店中：目录为 Advantage+ 目录广告、Facebook 和 Instagram 商店以及商品标记提供数据，所以目录里的改动会在这些地方显示。由定时 Feed 提供的商品会在下一次 Feed 上传时被覆盖：想让改动长期生效，请修正 Feed 源数据或使用补充 Feed。

安装时关闭：meta_catalog_batch_update_items、meta_catalog_create_product、meta_catalog_update_product 和 meta_catalog_delete_product。它们会改变顾客在广告和商店中看到的内容，删除的商品无法恢复，只能重新添加。如果需要 AI 编辑目录，管理员可以逐个开启。

每次修改前都会询问：开启后，AI 会说明目录、商品（名称和 SKU）以及修改前后的值，等你同意后再执行。一个批次最多可包含 5,000 项修改（建议少于 3,000 项），并在后台处理：AI 会用 meta_catalog_check_batch_status 跟踪直到完成，并向你报告错误。

限制：Meta 会限制 API 调用频率。出现错误代码 4、17、613、80009 和 80014（批次上限）时，请等几分钟再重试。

常见错误：代码 190 表示令牌无效或已过期，请创建新令牌。如果附带子代码 467、460 或 458（已退出登录、已改密码、应用已移除），会话已彻底结束，在你保存新令牌之前连接器不会再发送该令牌。代码 10 以及 200 到 299 表示缺少权限，或系统用户无权访问该目录：请分配目录并重新生成令牌。代码 100 表示某个参数、字段或筛选条件有误。

该连接器不会创建或删除目录、Feed 或商品组，不会修改 Feed 计划或上传 Feed 文件，不处理本地化目录、像素或事件源，不投放目录广告（这由 Meta Ads 连接器负责），也不会在 Instagram 帖子中标记商品。

步骤 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 — 在 Gemini 中添加连接器

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

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Meta Catalog 的工具。

可用工具

示例提示

• “我们主目录里的商品为什么被拒或不展示？列出 MUST_FIX 问题，以及每个问题影响多少件商品。”
• “我们商品 Feed 的上一次上传成功了吗？把错误连同行号和 SKU 一起给我看。”
• “‘夏季促销’商品组里，现在有哪些商品缺货？”
• “把 SKU TSHIRT-RED-M 改成 24.90 美元并设为有货。改动之前先给我看修改前后的值。”
• “列出客户共享给我们的目录，以及每个目录有多少商品。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT