将 Claude、Cursor、Hermes 或任何 AI 智能体与 MCP 连接

Store Console 内置了 MCP 服务器 （Model Context Protocol，模型上下文协议）。您现有的 AI 智能体（如 Claude、Cursor、VS Code 或 Hermes 智能体）可以连接到您的商店并进行操作：列出今日订单、更改订单状态或商品、记录货到付款、更新价格、调整库存、查找客户、提取销售或库存报告，以及规划和安排 Social Hub 帖子。该智能体使用与管理面板内助手相同的工具，且操作权限绝不会超过令牌持有者的权限范围。

观看“连接 AI 智能体（通过 MCP）”导览 (1:21)。每个模块都有一个视频教程。

概览

领域	智能体可执行的操作	需经您确认
订单与销售	搜索并筛选订单，打开包含行项目和地址的订单，处理电话订单，更改订单状态，在发货前编辑商品，记录货到付款或银行转账，发起退款，生成销售和商品销售报告	所有更改；退款仍需人工在“退款”模块中审批
产品	搜索商品，打开商品详情，创建草稿商品，更改名称、描述、SEO、品牌和分类，发布或取消发布，设置价格和促销价	所有变更
库存	各仓库库存，低库存和缺货行项目，添加或扣减库存并注明原因	所有调整
客户	查找客户，查看地址、按状态分类的订单及近期订单，生成客户报告	—
产品评论	待审核或低评分评论；可进行批准、附带理由拒绝或公开回复	所有操作
社交中心	Facebook、Instagram、WhatsApp、TikTok、YouTube 和 X 的连接状态、内容日历、发布状态及结果、立即发布或定时发布、重新安排、取消或重试、报告、审批队列及评论	发布、定时与变更
广告与WhatsApp	Meta广告结果，规划新活动，暂停或更改预算，从CRM细分中创建自定义受众；使用批准的模板进行WhatsApp活动：草稿、测试、发送、暂停、恢复或取消；隐藏、删除或私下回复评论	每次更改；新活动和WhatsApp发送也会在审批队列中等待
交付	包裹及其状态、快递列表、预约快递、更改包裹状态	预约与状态变更
营销与 CRM	创建优惠券和促销活动、查找并添加潜在客户与交易	所有变更
内容与媒体	撰写博客文章、上传图片和视频至媒体库	博客文章
支持、项目、供应商	查找、打开、回复并解决工单；查找、创建、移动并分配 Momentum 任务；查找并添加供应商	所有变更
人员	待审批的请假申请；批准或附带员工可见的理由进行拒绝	所有决策
报告	销售、会计、预算、财务、营销、弃购、库存、人力资源、薪资及支持报告	—

1. 开启 MCP

前往 智能 → MCP 与 AI 代理。
在连接选项卡中，开启 允许 AI 代理连接。仅管理员可执行此操作。
选择每个令牌每分钟可发送的请求数（默认为 60）并保存。

当 MCP 关闭时，即使令牌有效，所有代理请求都将被拒绝。

2. 创建您的访问令牌

打开 访问令牌 并点击 创建令牌。
为其命名，例如“营销团队 — Claude”。
选择其可访问范围：全部区域或逐个区域设置， 无访问权限，只读或读写。
选择过期时间并点击 创建令牌。
请立即复制令牌。它以 scmcp_ 开头，且仅显示一次，并附带代理的就绪设置（令牌在屏幕上处于隐藏状态；“复制”操作会将真实令牌存入剪贴板）。

令牌的操作权限等同于其创建者。对于营销团队，请以拥有 社交媒体经理 角色的用户身份登录，并在该身份下创建具有 Social Hub 范围的令牌：这样代理即可规划和安排发布内容并读取 Social Hub 报告，但无法查看订单、客户或价格。

3. 连接您的代理

服务器地址为 https://your-store.com/mcp。请在 Authorization 标头中以 Bearer YOUR_TOKEN的形式发送令牌。“连接”选项卡下方显示了已填入您个人地址的各项设置。

Claude Code

claude mcp add --transport http store_console https://your-store.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor (.cursor/mcp.json）

{ "mcpServers": { "store_console": { "url": "https://your-store.com/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

Claude Desktop (claude_desktop_config.json，需要 Node.js)

{
  "mcpServers": {
    "store_console": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://your-store.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_TOKEN" }
    }
  }
}

Hermes 代理 (~/.hermes/config.yaml）

mcp_servers:
  store_console:
    url: "https://your-store.com/mcp"
    headers:
      Authorization: "Bearer YOUR_TOKEN"

任何其他 MCP 客户端

{ "mcpServers": { "store_console": { "type": "http", "url": "https://your-store.com/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN" } } } }

然后向您的代理询问一个简单的问题，例如“显示今天的订单”，以检查其是否正常工作。

4. 变更如何保持安全

您的权限，始终如一。 每个工具在运行前都会检查令牌所有者的角色。角色无法使用的工具甚至不会显示。
变更需经您确认。 当代理程序想要更改订单、价格、库存或文章时，商店会首先回复简短摘要且不保存任何内容。代理程序会向您展示该摘要，仅在您同意后才会执行更改。
每个请求均有记录。 交付日志 活动日志 选项卡以及 MCP 下的主活动日志会显示操作者、使用的令牌、工具、结果及耗时。密钥绝不会存储在日志中。
撤销或删除。 撤销可立即停止令牌；删除则会将其从列表中移除。
限制与关闭开关。 每个令牌都有每分钟请求限制。您可以随时撤销令牌，或为整个商店关闭 MCP。
部分作业受限。 外部代理程序无法运行、创建或删除计划任务。

常见问题

代理程序提示令牌缺失或错误。 请检查标头是否为 Authorization: Bearer scmcp_…，确认令牌未过期且未被撤销。

预期的工具缺失。 您的角色不包含该区域，或者令牌的作用域未涵盖该工具。请打开工具选项卡以查看您的角色具体可使用的功能。

代理程序提示 MCP 已关闭。 请联系管理员开启 允许 AI 代理连接。