如何通过 MCP 将 Veepee Pink Connect 连接到 Gemini

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

Veepee Pink Connect + Gemini

通过 Pink Connect，让 AI 智能体帮你在 Veepee 和 Privalia 上销售：包含明细、地址、物流跟踪和退款的订单，按销售渠道划分的商品报价，顾客消息，退货申请和承运商。回复消息、就订单发起新消息以及更改退货状态的工具也已包含，但安装时处于关闭状态。

前提条件

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

PINK_CONNECT_TOKEN

步骤 1 — 获取凭证

拿到令牌后，设置大约需要 2 分钟。你需要一个通过 Pink Connect 管理的 Veepee 或 Privalia 卖家账号。Pink Connect 是 Veepee 集团旗下各平台的卖家 API。

1. 获取你的 Pink Connect 卖家账号的 API 令牌。它显示在 Pink Connect 门户 www.pink-connect.com 中，也可能由你在 Veepee 的平台对接人发给你。
2. 把令牌单独粘贴到 PINK_CONNECT_TOKEN，不要加 Bearer、引号或空格。
3. 安装连接器并运行 pink_connect_list_carriers：它会列出 Pink Connect 支持的约 200 家承运商，并确认令牌可用。

销售渠道：平台的每个国家站点都是一个有独立编号的店铺渠道，例如 Veepee 意大利站和 Privalia 意大利站各有一个。每个订单都带有所属渠道，因此 AI 会先从你的订单中读取渠道 ID。商品报价总是按单个渠道列出。

可读取的内容：订单的状态、日期、金额和币种、收货及账单地址、订单明细（每行的 GTIN、SKU、价格、税率、数量和状态）、包含承运商、运单号和跟踪链接的配送信息、退款以及顾客选择的配送方式；你在各渠道的商品报价，包括名称、品牌、售价和建议价、带起止日期的折扣、库存、价目表和平台状态；顾客消息的主题、正文、发送方、已读状态和附件；退货申请的订单明细、数量、原因（例如 PRODUCT_DAMAGED 或 SIZE_DONT_FIT）、类型（如 HOMEPICKUP）和状态；以及承运商列表。

Pink Connect 的返回方式：订单按从旧到新的顺序返回，所以查询近期订单时，AI 总是按某个日期之后有更新的订单来取，每页最多 100 条。单个订单通过 Pink Connect 的订单 ID 读取，它不同于平台的订单号；要按 Veepee 或 Privalia 的订单号查找，AI 会同时提供平台和该平台的订单号。查询顾客消息时如果不按订单或日期筛选，Pink Connect 会扫描全部历史，可能要半分钟，因此 AI 总会带上筛选条件。商品报价状态以西班牙语返回，例如 "Producto Publicado"。

安装后仅可读取：安装后默认开启的工具都只读取数据。没有任何工具会动用资金：更改退货状态不会退款，退款在本连接器之外处理。

安装时关闭：pink_connect_reply_notification 用于回复顾客消息，pink_connect_create_order_message 用于在尚无对话的订单上发起新对话，pink_connect_update_return_request 用于把退货从 PENDING 改为 PROCESSING（已接受）或 REJECTED，或从 PROCESSING 改为 COMPLETE（已收到货物）。它们会直接触达真实顾客，所以需要管理员有意识地开启。即使开启后，AI 也会先展示订单、用顾客语言写好的确切消息，或退货及其新状态，等你同意后再执行。

限制：Pink Connect 每次调用最多返回 100 个订单或退货申请，而一个订单约 2 KB，所以 AI 会使用较小的分页，并按日期或渠道筛选，而不是读取全部数据。

常见错误：401 表示令牌错误或已过期，请向 Veepee 申请新的令牌。400 "Invalid page size (max 100)" 表示每页超过了 100 条。422 消息为西班牙语并会说明问题，例如 "Canal de Venta no puede estar vacío" 表示缺少渠道 ID。未知 ID 会返回一个 HTML 格式的 404 页面。

该连接器不会修改商品报价、价格或库存，不会确认发货或上传运单号，不会取消订单，也不会退款。

步骤 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 现在可以调用 Veepee Pink Connect 的工具。

可用工具

示例提示

• “从周一到现在 Veepee 和 Privalia 来了哪些订单？其中哪些还没有发货？”
• “给我看最近 7 天的未读顾客消息，以及每条消息对应的订单。”
• “哪些退货申请还在等待处理？顾客给出的原因分别是什么？”
• “列出我在 Privalia 意大利站上库存少于 5 件的商品报价。”
• “查找 Veepee 订单 87654321，告诉我承运商和物流跟踪链接。”

FAQ

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

下一步

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