UpSeller MCP 配置与使用指南

更新于 2026年11月05日复制链接

一、功能介绍

UpSeller 支持通过 MCP(AI 工具连接)将 UpSeller 数据接入 Claude、Codex、ChatGPT、Cursor 等 AI 工具。
连接成功后,您可以通过 AI 工具查询 UpSeller 中的库存和销售数据,方便获取及分析店铺经营信息。

二、使用前准备

使用 MCP 前,请确认:
  • 您的账号套餐为专业版及以上,或组合套餐
  • 需要使用主账号登录 UpSeller,子账号暂不支持进入开放平台或申请 MCP Token
  • MCP 功能无需额外付费

三、MCP 配置步骤

第一步:获取 MCP Token

1.登录 UpSeller 后台,进入左侧菜单栏的【开放平台】→【API / MCP】
2.首次使用时,点击页面中的【生成】按钮

UpSeller MCP 配置与使用指南

3.生成成功后,复制并保存页面显示的 MCP Token

UpSeller MCP 配置与使用指南

注意: MCP Token 属于敏感信息,请妥善保管,不要分享给他人。如有安全风险,可以在同一页面重新生成或删除 Token

第二步:配置 MCP 服务

在您使用的 AI 工具中添加 MCP 服务,并填写以下信息:
  • Transport:streamable-http
  • MCP 服务地址:https://openapi.upseller.com/mcp
  • MCP Token:填写刚刚获取的 Token
完成配置后,即可通过 AI 工具使用 UpSeller 提供的 MCP 功能。不同 AI 工具的具体配置入口可能有所不同,请根据对应工具的配置要求操作

四、各 AI 工具接入 MCP 配置流程

如何在 Cursor、Claude、Codex、豆包(扣子) 中接入 UpSeller MCP 服务
接入前的通用准备
无论使用哪种工具,都需要先准备好以下二项信息(在「MCP配置步骤」章节中生成)

UpSeller MCP 配置与使用指南

{
"mcpServers": {
"upseller": {
"url": "https://openapi.upseller.com/mcp",
"headers": {
"Authorization": "Bearer 你的MCP_Token",
"X-Upseller-Language": "cn",
}
}
}
}


1、Cursor

图形界面入口:打开 Cursor

UpSeller MCP 配置与使用指南

点击Customize

UpSeller MCP 配置与使用指南

点击MCPS-->点击New MCP Server

UpSeller MCP 配置与使用指南

复制以下内容到mcp.json

UpSeller MCP 配置与使用指南

  • 全局生效:~/.cursor/mcp.json

  • 仅当前项目:项目根目录 .cursor/mcp.json
{
"mcpServers": {
"upseller": {
"url": "https://openapi.upseller.com/mcp",
"headers": {
"Authorization": "Bearer 你的MCP_Token",
"X-Upseller-Language": "cn",
}
}
}
}

点击保存后查看是否添加Upseller MCP服务

UpSeller MCP 配置与使用指南

2、Claude

方式一:直接在命令行添加

claude mcp add --transport http upseller https://openapi.upseller.com/mcp --header "Authorization: Bearer 用户MCC_Token" --header "X-Upseller-Language: cn" --header "Accept: application/json, text/event-stream"

UpSeller MCP 配置与使用指南

方式二:在C:\Users\admin下.claude.json文件中配置

{
"mcpServers": {
"upseller": {
"type": "http",
"url": "https://openapi.upseller.com/mcp",
"headers": {
"Authorization": "Bearer 用户MCP_Token",
"X-Upseller-Language": "cn",
"Accept": "application/json,text/event-stream"
}
}
}
}

3、Codex(OpenAI Codex )

点击Plugins进入插件市场

UpSeller MCP 配置与使用指南

点击设置进入MCPs

UpSeller MCP 配置与使用指南
UpSeller MCP 配置与使用指南

点击Add Server

UpSeller MCP 配置与使用指南

类型选择HTTP

UpSeller MCP 配置与使用指南

填入对应信息

UpSeller MCP 配置与使用指南

Name: Upseller-MCP
Type: HTTP
URL: https://openapi.upseller.com/mcp
Headers:

  • Bearer 令牌环境变量:(用户MCP-Token)
  • X-Upseller-Language: "cn"(语种类型,可选`cn` `en` `es` `pt`)

4、豆包 / 扣子(Coze)

注意: 必须要客户端才能集成MCP服务

点击技能·连接器·伙伴

UpSeller MCP 配置与使用指南

点击新建连接器

UpSeller MCP 配置与使用指南

输入MCP服务相关信息
填入参数如下:

UpSeller MCP 配置与使用指南

服务名称: Upseller-MCP
传输类型: HTTP
服务器URL: https://openapi.upseller.com/mcp
自定义Headers:

  • Authorization:Bearer "用户Token"(填写自己的MCP_Token,前缀Bearer 固定不变)
  • X-Upseller-Language: "cn"(语种类型,可选`cn` `en` `es` `pt`)

UpSeller MCP 配置与使用指南

点击确定安装后查看已添加MCP

UpSeller MCP 配置与使用指南

五、目前支持的业务功能

目前,UpSeller MCP 已开放库存和数据两个模块:
1. 库存模块

  • 查询当前账号下的仓库列表

  • 查询指定仓库下全部或指定 SKU 的库存详情

2. 数据模块

  • 销售业绩:支持按日期、按店铺查询

  • 产品销量:支持按产品、按变种、按产品 SKU、按变种 SKU 查询

  • 商品销量:支持按全部商品、新品、畅销品、滞销品查询

注意: 数据模块的销售业绩、产品销量和商品销量,单次查询周期最长均为 7 天。

六、详细使用教程

如果您需要了解各模块的具体查询方式及参数说明,可以参考以下帮助文档:
Open API 接口+MCP 服务操作指南
MCP:销售数据查询指南

在线客服
微信客服群
回到顶部