跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Gumroad,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
让你的 AI 读取你的 Gumroad 店铺:商品、可筛选的销售记录、会员订阅者、优惠码、结账字段、许可证密钥和 Webhook。在你确认后,它还能上架或下架商品,并创建优惠码。退款功能默认关闭。使用你的 Gumroad 应用的访问令牌。
试试这样问
Gumroad 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Gumroad、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Gumroad + Gemini
让你的 AI 读取你的 Gumroad 店铺:商品、可筛选的销售记录、会员订阅者、优惠码、结账字段、许可证密钥和 Webhook。在你确认后,它还能上架或下架商品,并创建优惠码。退款功能默认关闭。使用你的 Gumroad 应用的访问令牌。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
GUMROAD_ACCESS_TOKEN
步骤 1 — 获取凭证
配置大约需要 3 分钟,只需要你的 Gumroad 账户。
- 登录 Gumroad,打开 Settings → Advanced → Applications。
- 创建一个应用:名称随意,重定向 URI 填任意一个 https 地址即可(连接器不会用到)。点击 Create application。
- 在新应用上点击 Generate access token,把令牌复制到
GUMROAD_ACCESS_TOKEN,不要带 Bearer 字样。 - 安装连接器并运行
gumroad_get_user:它会显示令牌所属的账户。
请妥善保管令牌:Gumroad 令牌拥有 Gumroad 提供的全部权限,包括退款,任何拿到它的人都能管理你的店铺。连接器只使用其工具所需的功能。要撤销访问,请删除该应用或生成新令牌。
可以读取的内容:你的商品,含价格、币种、上架状态、会员详情、标签、销量和收入;单个商品的描述、规格和选项;按时间倒序的销售记录,可按日期、商品、买家邮箱或姓名、订单号或许可证密钥筛选,每条都包含价格、Gumroad 手续费、数量、规格、优惠码、退款和争议状态;会员订阅者及其状态(有效、待取消、付款失败、已取消)和相关日期;优惠码及各自的使用次数;商品在结账时要求填写的自定义字段;许可证密钥;以及账户中设置的 Webhook。
统计某段时间的收入:Gumroad 每页返回 10 笔销售,所以统计一个月或一年时,AI 会翻完所有销售记录再合计,并告诉你一共统计了多少笔。金额以商品币种的最小单位(例如美分)表示,时间为 UTC。
校验许可证不会消耗激活次数:gumroad_verify_license 会告诉你某个密钥对该商品是否有效、已使用多少次、属于哪笔购买,而且不会增加使用次数(除非你要求)。返回 404 表示该商品下没有这个密钥、密钥已停用,或这笔购买已失去访问权限。
每次修改前都会询问:gumroad_enable_product 会立即上架商品,gumroad_disable_product 会下架商品(已购买的用户仍保留访问权限),gumroad_create_offer_code 会创建一个顾客可立即使用的优惠码。每次操作前,AI 都会给你看相关商品,或优惠码及其折扣和限制,并等你同意。
安装时默认关闭:gumroad_refund_sale。退款会把钱退还给买家,而且无法撤销。只有管理员有意开启后才能使用;届时 AI 会先给你看这笔销售、买家和金额,只有在你确认后才退款。没有任何工具会删除商品、优惠码或自定义字段。
客户数据:销售记录和订阅者中包含买家的邮箱、姓名和许可证密钥。AI 只读取回答你的问题所需的内容,不会复制到其他地方。
常见错误:401 表示令牌有误或应用已被删除,请生成新令牌。"Not found" 表示 Gumroad 不认识这个商品、销售或订阅者 ID。
该连接器不会创建、编辑或删除商品、规格或文件,不会把销售标记为已发货,不会撤销访问权限,不会重发收据,不处理付款或税务表格,不发送邮件或管理工作流,也不会创建或删除 Webhook。
步骤 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" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list),anythingmcp应显示为已连接。 - 开始输入提示,Gemini CLI 现在可以调用
Gumroad的工具。
可用工具
| Tool | What it does |
|---|---|
gumroad_get_user | Read the Gumroad account the token belongs to: name, user id, e-mail, profile URL, bio and profile picture |
gumroad_list_products | List all your Gumroad products: id, name, published, price in cents with currency and formatted price, membership details, URL, tags and… |
gumroad_get_product | Read one product: name, description (HTML), price, currency, published, URL, membership recurrences, variants with their options and… |
gumroad_enable_product | Publish a product so it can be bought again (Gumroad calls this enable) |
gumroad_disable_product | Unpublish a product so it can no longer be bought (Gumroad calls this disable) |
gumroad_list_sales | List successful sales, newest first, 10 per page, with filters: after and before (YYYY-MM-DD), product_id, buyer email, order_id, buyer… |
gumroad_get_sale | Read one sale by its id: product, buyer, price and fees in cents, quantity, variants, custom fields, offer code, refund, chargeback and… |
gumroad_list_subscribers | List the subscribers of a membership or subscription product, 100 per page: subscriber id, buyer e-mail, status (alive… |
gumroad_get_subscriber | Read one subscriber by id: product, buyer e-mail, status, recurrence, charges so far, purchase ids and the cancellation, end and failure… |
gumroad_list_offer_codes | List the offer (discount) codes of a product, including universal codes valid for all products: id, code, amount off in cents or percent… |
gumroad_create_offer_code | Create a discount code for a product (or for all products with universal true) |
gumroad_list_custom_fields | List the custom fields a product asks for at checkout (for example a phone number or a terms checkbox): name, type and whether it is… |
gumroad_verify_license | Check a license key for a product: whether it exists and is valid, how often it was used, and the purchase it belongs to (buyer e-mail… |
gumroad_list_resource_subscriptions | List the webhooks (resource subscriptions) set up for one event type: id, event and the URL Gumroad posts to |
gumroad_refund_sale | Refund a sale in full, or partly with amount_cents |
示例提示
- “我上个月卖了多少单?每个商品各带来多少收入?”
- “这个月有哪些会员取消了订阅或付款失败?”
- “这个许可证密钥对 Plugin Pro 有效吗?已经用了几次?这次校验不要计入使用次数。”
- “为 Notion Template Pack 创建一个 8 折优惠码 BLACKFRIDAY,最多使用 100 次。创建前先给我看详情。”
- “把我 2024 年的旧课程下架,让别人再也买不到。”
FAQ
Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?