MCP接入教程（以WorkBuddy 示例）

本教程以 WorkBuddy 为示例，面向第一次使用 Tigshop 开源商城系统 MCP管理的客户，按照“连接一次、直接对话、确认执行”的方式编写。

文中的配置和提问方式也适用于其他支持 MCP 的 AI 客户端；如果您使用的客户端菜单名称不同，以客户端实际页面为准。

一、开始前准备

使用前请准备：

Tigshop 管理后台管理员账号。
一个支持 MCP 远程连接的 AI 客户端（这里以下载workbuddy为例）。
当前环境的 Tigshop 地址。
如果需要识别商品图片，请确认 WorkBuddy 当前使用的是支持图片识别的模型。

二、在 Tigshop 生成密钥

三、在 WorkBuddy 中配置 Tigshop MCP

1.在 WorkBuddy 的“自定义 MCP 连接器”中加入下面的模板，并替换两个占位内容：

{
"mcpServers": {
"tigshop-mcp": {
"url": "http://<TIGSHOP地址>/adminapi/mcp",
"headers": {
"X-MCP-Api-Key": "<当前有效密钥>"
},
"disabled": false
}
}
}

填写说明：

配置项应该填写什么url，Tigshop 地址后加/adminapi/mcp。测试环境按管理员提供的 HTTP 地址填写，正式环境建议使用 HTTPS。
X-MCP-Api-Key 在 Tigshop 全局设置中复制的当前有效密钥。
disabled false 表示启用连接；如果暂时不使用，可以改成 true。
保存配置后刷新或重启 WorkBuddy 的 MCP 连接。不要把真实密钥发送到普通聊天、截图、工单或公开文档中。

2.在 WorkBuddy 中确认连接

保存连接后，在 WorkBuddy 中刷新 MCP 工具列表。如果 WorkBuddy 显示连接已启用，说明配置已经被加载。

如果 WorkBuddy 提示连接失败，请先确认地址、请求头名称、密钥有效期、disabled 状态和网络访问均正确。