AI 客户端连接（MCP）

在与 Claude 或 ChatGPT 的对话中，即可创建 Shopee 商品、查看销售额和利润、搜索商品、查看或更新库存。只需用 SellBridge 账号连接，操作范围仅限于您自己的租户。

所需条件

  • Basic 及以上方案的 SellBridge 账号。Free 方案无法使用 AI 客户端连接。
  • 至少有 1 个已连接的 Shopee 店铺。
  • 支持 MCP 的 AI 客户端（见下文）。

端点为 https://mcp.sell-bridge.com/mcp。传输方式为 MCP 标准的 Streamable HTTP，认证使用 OAuth 2.1，无需事先注册应用或手动粘贴密钥。

连接方法

Claude.ai / Claude Desktop

  1. 打开 设置 →“连接器”→“添加自定义连接器”
  2. 在 URL 中输入 https://mcp.sell-bridge.com/mcp
  3. 在弹出的 SellBridge 登录 → 同意界面中点击“允许”

Claude Code

claude mcp add --transport http sell-bridge https://mcp.sell-bridge.com/mcp

ChatGPT

  1. 打开添加连接器（自定义连接器 / MCP）的界面
  2. 在 URL 中输入 https://mcp.sell-bridge.com/mcp，并完成 OAuth 授权同意

Cursor

添加到 ~/.cursor/mcp.json 中。

{
  "mcpServers": {
    "sell-bridge": { "url": "https://mcp.sell-bridge.com/mcp" }
  }
}

VS Code

添加到 .vscode/mcp.json 中。

{
  "servers": {
    "sell-bridge": { "type": "http", "url": "https://mcp.sell-bridge.com/mcp" }
  }
}

首次调用工具时，客户端会自动开始 OAuth。同意界面会显示连接方应用的名称。如果应用名称不熟悉，请不要允许。

使用示例

连接后，只需用日常语言提出请求即可。

  • “列出 SellBridge 中已连接的 Shopee 店铺”
  • “告诉我上个月的销售额和利润率”
  • “根据 Amazon 的 ASIN B0BZ8DZJQ6 起草面向 Shopee 的商品，并确认候选类目和必填属性”
  • “检查这个商品名称和描述能否在 Shopee 上架，进行合规确认”

可以做什么

所有操作仅针对您自己租户的数据。

类别内容
店铺查看已连接店铺的列表和连接状态
类目 / 属性获取上架所需的类目、属性、品牌和物流渠道
调研根据 Amazon 的 ASIN 起草上架信息
合规判定禁用·需注意词语，检索禁售·限售规则
价格计算计算建议价格，并按指定价格试算利润
销售·利润分析KPI、周度·月度销售额和订单数、利润表、低利润订单
商品·库存查询搜索商品目录及详情，库存记录及按状态统计的数量
订单查询定期获取订单列表、订单明细、按订单汇总的利润
Shopee 实时数据查询直接查询 Shopee 上的商品、变体和各类目上架上限
图片上传商品图片，合成品牌边框
上架模板获取已保存上架模板的列表和内容
创建商品⚠️创建单品／带变体的商品
编辑商品⚠️更新现有商品的库存、价格、商品名称、SKU、分期付款设置和公开状态
下架 / 删除⚠️下架和删除商品（不可恢复）

标有 ⚠️ 的类别会实际更改库存、价格和上架状态。删除和下架无法撤销。建议不要完全交给 AI，请在确认执行内容后再允许。

权限与数据处理

  • 租户隔离：所有调用都使用您所同意的 1 个租户的凭证执行。即使在参数中传入其他租户的 ID，也不会在该租户中解析，无法访问。
  • 不保存对话内容：服务器记录的是被调用的工具名称、响应时间和成功与否。对于更改库存、价格和上架状态的操作，仅额外记录以目标 ID 和数量为主的摘要，不记录商品描述、图片 URL 等。也不会读取 AI 客户端侧的对话记录或文件。
  • 解除：可随时在 SellBridge 的 设置 →“外部连接”→“API 密钥”标签页中解除已连接的连接器。解除后访问令牌和同意记录将失效。
  • 无人值守的处理：对于 cron、批处理等不涉及浏览器操作的处理，请使用在同一“API 密钥”标签页中签发的 API 密钥（以 sk_ 开头的字符串）。可按用途限定范围，并单独吊销。
  • 方案差异：从 AI 客户端连接在 Basic 及以上方案中可用，但上述“API 密钥”标签页（解除连接器和签发 API 密钥）是 Standard 及以上方案的界面。如果您使用的是 Basic 方案，请联系支持。

遇到问题时

  • 不断要求认证 / 401：令牌已过期。请在客户端中重新连接。
  • 只有特定工具被拒绝：范围或方案不足。请确认您的签约方案和操作内容。Free 方案下所有工具都会被拒绝。
  • “未验证应用”警告：表示连接方应用未经 SellBridge 验证。如果应用名称不熟悉，请不要允许。

如仍无法解决，请联系 support@sell-bridge.com。

For reviewers (English)

SellBridge is a SaaS dashboard for Japanese cross-border sellers on Shopee. This MCP server lets an AI client work with the seller's own SellBridge tenant: read sales, profit, inventory, catalog and orders, and create or maintain Shopee listings.

  • Endpoint: https://mcp.sell-bridge.com/mcp (Streamable HTTP)
  • Auth: OAuth 2.1 with dynamic client registration and PKCE. No manual client setup is required — the client starts the flow on first use.
  • Plan requirement: the free plan is deliberately not entitled to these tools. Every call from a free-plan account is refused. Use a basic-or-higher account.
  • Scope of data: every call is scoped to the single tenant the credential belongs to. The tools that write to a live Shopee store are the ones marked ⚠️ in the table above; your client asks for approval before running a tool.

To test in about ten minutes: add the endpoint as a custom connector, complete the OAuth consent, then ask for the connected stores, last month's sales, a listing draft from an Amazon ASIN, and a compliance check — the four prompts listed under 使用示例 above.