如何通过 MCP 将 Payhip 连接到 Gemini

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

Payhip + Gemini

在 AI 智能体中管理你 Payhip 店铺的优惠码并验证软件许可证密钥：列出和查看优惠券，经你批准后创建新优惠券，验证买家的许可证密钥，并在你允许时停用、重新启用密钥或统计其激活次数。

前提条件

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

PAYHIP_API_KEY

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 Payhip 店铺及其 API 密钥。如果要处理许可证密钥，还需要一个已开启许可证密钥的商品。

1. 在 Payhip 中打开 Settings → Developer，复制 API key。
2. 只把这个密钥粘贴到 PAYHIP_API_KEY。优惠券相关的工具会用到它。
3. 可选（用于许可证密钥）：在 Payhip 中打开商品，如果 Generate unique license keys 还没勾选就勾上，然后把该复选框下方显示的 product secret key 复制到 PAYHIP_PRODUCT_SECRET_KEY。
4. 安装连接器并运行 payhip_list_coupons：它会列出你的优惠码，并确认 API 密钥可用。如果设置了 product secret key，再用某位买家收到的密钥运行 payhip_verify_license，确认许可证这部分也能用。

每次安装对应一个授权商品：一个 product secret key 只属于一个商品。要验证多个商品的密钥，请为每个商品分别安装一次连接器，并以商品名称命名。优惠券在每个安装里都能用，因为它们使用的是店铺的 API 密钥。

可读取的内容：店铺的优惠码，包括代码、类型（单个商品、全部商品或一个合集）、折扣百分比或金额、开始和结束日期、最低消费、使用上限和备注；以及已配置商品的许可证密钥状态：是否启用、买家邮箱、商品和规格、已使用次数以及签发时间。

只有优惠券和许可证密钥：目前 Payhip API 只覆盖这两个方面。商品、销售、客户和结算都无法通过它获取。

如何理解数据：金额（减免金额、最低消费）以分为单位，折扣百分比就是百分数。payhip_verify_license 返回空结果表示该商品下不存在这个密钥。订单退款后，Payhip 会自动停用对应的密钥。密钥的使用次数是一个由你的软件增减的计数器；Payhip 不强制上限，上限由你的软件控制。

安装时关闭：payhip_create_coupon、payhip_disable_license、payhip_enable_license、payhip_increase_license_usage 和 payhip_decrease_license_usage。新优惠券一创建就能在结账时使用，而被停用的密钥会让买家无法使用你的软件，直到重新启用。订阅类商品无法通过 API 设置优惠券。需要哪些工具由管理员开启。

每次修改前都会询问：开启写入工具后，AI 会先展示优惠码、折扣和适用范围，或者要处理的许可证密钥及将要执行的操作，等你同意后才执行。

限制：优惠券列表每页最多 100 条，因此店铺优惠券很多时，AI 会分页读取，而不是一次全部请求。

常见错误：401 authentication_fail 表示 API 密钥或 product secret key 错误或缺失：请从 Settings → Developer 重新复制 PAYHIP_API_KEY，许可证工具则请在商品页面核对 PAYHIP_PRODUCT_SECRET_KEY。Payhip 的防火墙会对来自数据中心地址的优惠券请求发起验证，因此在配置了出站代理的环境（例如 AnythingMCP Cloud）中，优惠券请求会经由 AnythingMCP 的出站代理发出。在没有设置 CONNECTOR_PROXY_URL 的自托管服务器上，优惠券请求可能返回带 HTML 页面的 403。

该连接器不会读取商品、销售、客户或结算信息，也不会办理退款或签发新的许可证密钥。

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

可用工具

示例提示

• “许可证密钥 7XK2-9QPL-44MZ-H1TR 有效吗？是谁买的，已经用了几次？”
• “列出我们所有的优惠码及各自的折扣，并告诉我哪些这个月到期。”
• “优惠券 DOUBLE11 的使用条件是什么：最低消费、使用上限，以及适用于哪个商品？”
• “有买家说退款之后他的密钥就用不了了。帮我查一下它是否还启用，以及绑定的是哪个邮箱。”
• “我们的优惠券里，哪些适用于全部商品，哪些只适用于单个商品或某个合集？”

FAQ

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

下一步

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