用自己的 AI 工具管店

把店铺接进 WorkBuddy、Kimi、Claude 等 AI 工具，一句话查订单、上架、回客服。

快捷直达打开 AI 工具接入 ↗打开商户中心 ↗

你将完成什么

让日常在用的 AI 工具直接替你打理这家店：问一句「今天有哪些订单要发货」，它就去查；说一句「把这个商品下架」，它就去改。配置一次，之后一直可用。

谁能操作：门诊管理员（签发 Key 需要管理员账号）。

开始前准备

电脑上已装好一个能接入外部工具的 AI 工具：WorkBuddy、Kimi Code、Claude Code、Cursor、VS Code 都可以。
商户中心的管理员账号。

操作步骤

第 1 步 · 签发 Key

点哪登录后台 → AI 工具接入
做什么点「签发 Key」
会看到一串以 ak- 开头的字符。只显示这一次，先复制保存好。

第 2 步 · 复制配置

点哪同一页往下，找到「配置示例」
做什么点「复制配置示例」——地址和 Key 已经自动填好
会看到一段长这样的配置

{
  "mcpServers": {
    "clinic_merchant": {
      "url": "https://api.znmz.jinsixian.cn/open/v1/mcp",
      "headers": { "Authorization": "Bearer ak-tenant-你的Key" }
    }
  }
}

第 3 步 · 放进 AI 工具并点信任

在下面「各工具怎么放」里找到你用的工具，照做。

最关键的一步是点「信任 / 允许」：只把配置加进去、不点信任，工具不会出现在对话里。

第 4 步 · 验证真的能用

做什么新开一个对话，说「看看我的店面档案」
会看到店名、发布状态、服务项目数。再让它「列出今天的订单」，多数工具会显示它调用了哪个工具

各工具怎么放

WorkBuddy

打开 WorkBuddy → 左侧「插件」→ 右上「MCP 服务器」→「配置 MCP」
粘贴第 2 步复制的配置，保存。保存后会自动连接，不用重启
首次连接会问是否信任，点「信任」（Trust）；确认服务器开关是启用的
新开一个对话，说「看看我的店面档案」

信任是按「域名 + 服务器名」记的：换域名（或端口）要重新点一次信任；只换 Key、改地址后面的路径不用。

Kimi Code

把下面这段写进 Kimi 的配置文件（第一行注释写了放在哪）：

// 文件：~/.kimi-code/mcp.json
{
  "mcpServers": {
    "clinic_merchant": {
      "url": "https://api.znmz.jinsixian.cn/open/v1/mcp",
      "headers": { "Authorization": "Bearer ak-tenant-你的Key" }
    }
  }
}

保存后重启 kimi，输入 /mcp 能看到这家店的连接状态；第一次调用工具时会问是否允许，选「本次会话都允许」即可。

Claude Code

在项目目录新建一个文件（第一行注释就是文件名）：

// 文件：.mcp.json
{
  "mcpServers": {
    "clinic_merchant": {
      "type": "http",
      "url": "https://api.znmz.jinsixian.cn/open/v1/mcp",
      "headers": { "Authorization": "Bearer ak-tenant-你的Key" }
    }
  }
}

第一次在该目录运行 claude 会问是否允许这个项目里的服务器，选允许；之后运行 claude mcp list，看到 Connected 就通了。

Cursor

写进全局或项目里的配置文件（第一行注释是全局那份的位置）：

// 文件：~/.cursor/mcp.json
{
  "mcpServers": {
    "clinic_merchant": {
      "url": "https://api.znmz.jinsixian.cn/open/v1/mcp",
      "headers": { "Authorization": "Bearer ak-tenant-你的Key" }
    }
  }
}

保存后重启 Cursor → 侧栏 Customize → 找到 clinic_merchant 打开开关；对话里第一次调用会弹确认，点允许。

VS Code

在项目里新建文件（注意这里写 servers，不是 mcpServers）：

// 文件：.vscode/mcp.json
{
  "servers": {
    "clinic_merchant": {
      "type": "http",
      "url": "https://api.znmz.jinsixian.cn/open/v1/mcp",
      "headers": { "Authorization": "Bearer ak-tenant-你的Key" }
    }
  }
}

保存后命令面板运行 MCP: List Servers，选中 clinic_merchant 点「Start」；工作区第一次使用会提示是否信任，点允许。然后在对话里说「用店铺工具查一下店面档案」。

其他工具

CodeBuddy、Trae、LM Studio、Cherry Studio 等：在设置里搜「MCP」，添加一个 HTTP 类型的服务器，地址填第 2 步复制的那一串，请求头加 Authorization: Bearer <你的 Key>；保存后同样要在列表里点「信任 / 启用」。

CodeBuddy命令行版（CodeBuddy Code）可以在用户目录的 .codebuddy 文件夹里放配置文件；IDE 版只在 Craft 模式下能用外部工具。
Qoder / 通义灵码IDE 里加服务器只填「名称 + 地址」，没有填请求头的地方；要带 Key 接入请改用 Qoder 命令行版，或换用上面的工具。
Trae设置 → MCP → 添加，填地址和请求头即可。

常见问题

问：加完以后工具列表是空的？

答：先确认点过「信任 / 允许」，再看服务器开关是否打开——WorkBuddy、VS Code、Claude Code 都是「添加不等于启用」。换过域名后要重新信任一次。

问：提示连不上或 404？

答：地址用「配置示例」里复制的那一份；官网主域名下没有这个入口。

问：提示未授权或 401？

答：可能是 Key 复制不完整、被「重新签发」作废，或请求头少了 Bearer 前缀。回「AI 工具接入」重新签发，再把新 Key 换进工具。

问：换了 Key 要重新点信任吗？

答：不用。信任按「域名 + 服务器名」记，只换 Key 或改地址后面的路径都不影响；换了域名（或端口）才要重新信任。

问：能连上，但一调用就失败？

答：在「AI 工具接入」页点「一键开通全部经营能力」；页面里标「未开通」的工具暂时调不动。

问：换电脑要重配吗？

答：要。Key 可以继续用，但每台电脑都要在自己的工具里重新添加并信任一次。