如何通过 MCP 将 SellAuth 连接到 Gemini

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

SellAuth + Gemini

SellAuth 数字商品店铺，只读：收入与利润分析、热销商品和头部客户、发票（订单）、商品及其变体、客户、评价、支持工单和优惠券。已交付的商品密钥绝不会返回。

前提条件

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

SELLAUTH_API_KEY, SELLAUTH_SHOP_ID

步骤 1 — 获取凭证

设置大约需要 2 分钟。你需要一个 SellAuth 店铺，以及可以创建 API 密钥的后台访问权限。

1. 在 SellAuth 后台依次打开 Account 和 Developers（dash.sellauth.com/api），创建一个 API 密钥。
2. 只把密钥粘贴到 SELLAUTH_API_KEY，不要加 Bearer、空格或引号。
3. 把店铺的数字 ID 填入 SELLAUTH_SHOP_ID，例如 123456。如果不确定，sellauth_list_shops 会列出该密钥能访问的所有店铺及其 ID。
4. 安装连接器并运行 sellauth_list_shops：它会显示该密钥下的店铺及名称、子域名、货币和汇总数据，由此确认密钥可用。

一个连接器，一个店铺：除 sellauth_list_shops 外，所有工具都读取 SELLAUTH_SHOP_ID 对应的店铺。如果你的密钥能访问多个店铺，请为每个店铺各安装一次连接器。

可读取的内容：店铺的核心指标（收入、订单、客户、商品成本、利润和成本覆盖率）及与上一周期相比的变化；后台图表背后的收入、订单和利润时间序列；销量最高的 10 个商品和变体，以及消费最多的 10 位客户；发票（订单）的状态、价格、实付金额、支付网关、支付方式、客户邮箱、国家和商品明细，以及单张发票的完整信息（手续费、折扣、税费、付款、优惠券和争议状态）；商品和变体的价格、成本、库存、已售数量和可见性；客户的邮箱、Discord 名称、店内余额、已完成订单数和累计消费；评价的评分、内容、回复和争议；支持工单的主题、状态、关联发票和最新消息；以及优惠券的使用次数、有效期、带来的收入和节省金额。

查找订单：发票可以按状态筛选（已付款订单为 completed，另有 pending、expired、cancelled、refunded 和 partial），也可以按客户邮箱和创建日期范围筛选，并按 ID、价格、实付金额或日期排序。列表分页返回，AI 会继续获取下一页，直到拿全为止。除非字段另有说明，金额均为 USD。

不会出现在结果中的内容：交付给买家的序列号密钥、文件和链接、付款凭证、IP 地址，以及店铺自身的 Discord 和 Webhook 密钥，都不会传给 AI。不过发票中包含客户的邮箱和国家。

只读：所有工具都只读取数据。你的店铺不会发生任何变化，因此无需确认，安装时也没有被关闭的工具。

限制：列表每页最多返回 100 行。SellAuth 返回 429（调用过多）时，AI 会等待一分钟后再重试。

常见错误：401 表示 API 密钥错误或已被删除，请在 Developers 下创建新密钥并重新粘贴。403 表示密钥有效，但不能访问该店铺，请用 sellauth_list_shops 核对 SELLAUTH_SHOP_ID。404 表示该店铺中没有这个 ID 的发票或商品，或者不存在这个 ID 的店铺。

该连接器不会创建或修改商品、优惠券或发票，不会退款，不会回复工单或评价，也不会交付或显示商品密钥。

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

可用工具

示例提示

• “我的店铺表现如何？收入、订单和利润与上一周期相比怎样？”
• “哪 10 个商品给我赚得最多？每个商品的利润是多少？”
• “列出上个月已退款和已取消的订单，附上客户邮箱和金额。”
• “给我看看还没处理完的支持工单，以及每个工单对应的是哪个订单。”
• “哪些评价分数低或有争议？我们回复了吗？”

FAQ

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

下一步

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