赛狐ERP的MCP的功能使用说明

赛狐AI功能

赛狐 MCP

赛狐 MCP 是赛狐官方提供的 AI 连接服务。完成一次简单配置后，您就可以在 Cherry Studio、Codex、Cursor、Trae、WorkBuddy 、豆包工作台等主流 AI 工具中，用自然语言直接查询店铺、订单、在线产品和广告数据，甚至让 AI 帮您批量调整 SP 广告——不需要写一行代码。
本介绍将带您完成：什么是赛狐 MCP → 完成 2 项启用 → 5 分钟接入AI→ 用好 23 个工具

一、什么是赛狐 MCP

1.1 定义

MCP（Model Context Protocol，模型上下文协议）是由 Anthropic 开源的标准化协议，用于统一大语言模型（LLM）与外部数据源、工具之间的通信方式，解决 AI 模型因"数据孤岛"而无法充分发挥潜力的问题。

1.2 通俗理解：MCP 就像给 AI 装了「万能插座」

家里的插座是统一的接口：不管插台灯、手机还是电脑，都能即插即用。MCP 做的是同一件事——让 AI 用同一套"协议"连接任何工具，无论是电脑上的文件、搜索引擎、数据库，还是赛狐 ERP 软件。
对赛狐用户来说，接入 MCP 后，AI 就多了一双能直接读取赛狐数据的"手"：您用日常语言提问，AI 自动去查数、算数、给结论。

二、如何启用？

2.1 启用 MCP

权限：需使用管理员或者子管理员账号操作
操作路径：【设置】-【业务设置】-【全局】-【开放接口】页面完成，预计 10 分钟

2.2 获取密钥

在赛狐【设置】-【业务设置】-【全局】-【MCP 管理】页面复制服务器 URL和X-MCP-Key

注意：

MCP 的请求频率限制与 OpenAPI 一致，高频查询请合理安排。
X-MCP-Key 相当于账号密码，每个赛狐子账号都有自己专属的X-MCP-Key，请妥善保管，不要分享给他人或泄露到公开场合。如怀疑泄露，请在【MCP管理】中重置。

三、如何将赛狐 MCP 添加至 AI 工具？

本章含所有工具通用的配置信息，您再任选正在使用的一款AI工具跟随操作即可，全程约 5 分钟

3.1 配置需要哪些信息

3.2 通用配置（适用于支持手动输入 JSON 的工具）

{
"mcpServers": {
"Sellfox-MCP": {
"type": "streamableHttp",
"url": "https://api-mcp.sellfox.com/mcp",
"headers": {
"X-MCP-Key": "你的密钥"
}
}
}
}

3.3 在各AI工具中配置

3.3.1 配置-Cherry Studio

①打开 Cherry Studio，选择右下角【设置】

②在【MCP】-【MCP服务器】中点击【+添加】-【快速创建】

③填入赛狐后台复制的【服务器 URL 与 X-MCP-Key】，点击【添加】
类型：默认选择“可流式传输的HTTP(streamableHttp)”；
URL：填写系统服务器地址，比如：https://api-mcp.sellfox.com/mcp；
请求头：X-MCP-Key=你的密钥

④检查确认赛狐MCP链接开启，【工具】中内容均开启设置，点击【保存】完成设置

⑤在对话框页面，点击【添加助手】，编辑助手，在【MCP】设置中，确认已勾选开启“赛狐MCP”，保存设置后，在对话框中直接输入问题，即可调用赛狐MCP

3.3.2 配置-Cursor

①打开Cursor，点击【Customize】-【MCPs】
②点击【+ New MCP Server】
③将赛狐后台【设置】-【业务设置】-【全局】-【MCP管理】中复制的信息，粘贴到配置列中填入
④保存后，在Cursor的AI对话中即可直接调用赛狐数据

3.3.3 配置-Trae

①打开Trae，进入【插件市场】 >【 MCP】，点击【管理】；

②在管理页面选择MCP，点击【+添加】> 手动配置；

③到赛狐【设置】-【业务设置】-【全局】-【MCP管理】中复制密钥信息，粘贴到Trae的手动配置页中，确认保存

④在MCP页中确认赛狐MCP状态已开通，在聊天框可以输入有关赛狐MCP的问题，输出相关内容，确认已链接成功

3.3.4 配置-Work Buddy

①打开Work Buddy，进入【专家·技能·连接器】-【连接器】

②点击右上角【+自定义连接器】 > 【配置MCP】；

③将赛狐后台【设置】-【业务设置】-【全局】-【MCP管理】中复制的信息，粘贴到配置列中，确认【保存】

④返回MCP列表，并确认MCP服务管理状态是开启的

⑤点击【新建任务】，在对话框中输入自然语言，返回相关数据，确认MCP已对接成功

3.3.5 配置-Codex

①在Codex中，进入【Settings】>【Plugins】；

②在Plugins中，点击【Add】>【Add MCP server】；
③填入赛狐后台复制的【服务器 URL 与 X-MCP-Key】URL：
填写系统服务器地址：https://api-mcp.sellfox.com/mcp
X-MCP-Key=“赛狐系统中复制的密钥”

3.3.6 配置-豆包工作台

①打开飞书的豆包工作台，进入【插件·技能·伙伴】-【插件】-【管理】页面

②进入【技能·连接器】页面，点击【+添加】-【新建自定义连接器】

③在编辑自定义连接器页面中，输入相关信息：服务器名称：自定义，名称能识别出赛狐MCP即可；
传输类型：选择“HTTP”；
服务器URL：“https://api-mcp.sellfox.com/mcp”；
自定义Headers：左侧输入框输入“X-MCP-Key”，右侧输入框“赛狐系统中复制的密钥”

④保存好MCP设置后，在【新工作任务】的会话框中输入问题，输出数据，确认赛狐MCP连接成功。

3.3.7 配置-其他 AI 工具

赛狐 MCP 可与任何支持自定义 MCP 工具的 AI 平台集成，通用配置步骤：
①获取 MCP 服务地址：https://api-mcp.sellfox.com/mcp
②在 AI 工具的 MCP / 工具管理中，选择"添加自定义 MCP 工具"
③填写 URL，传输方式选择 HTTP Streaming / Streamable HTTP
④在请求头（Headers）中添加“X-MCP-Key”：“赛狐账号中复制的密钥”
⑤保存后即可在对话中使用

3.4 权限设置

支持分别给子账号设置“MCP查询权限”和“MCP写入权限”，子账号设置权限之后才会在【设置】-【业务设置】-【全局】-【MCP管理】页面看到属于自己的接入地址和密钥。
MCP查询权限：仅可查询店铺数据，适合日常分析、报表场景；
MCP写入权限：可查询并修改店铺数据，例如调整广告预算，适合有操作需求的运营角色。