AI 助手连接（MCP）

让 Claude 这类 AI 助手直接连进 StoreOps——用聊天的方式看月报、查账目、记账、建物料。AI 能做的事永远是你能做的事的一部分，而且成功执行的操作都会写入审计日志。

运作方式

连接码（sop_ 开头的一长串字符）就是 AI 助手的钥匙，绑定「这家店＋生成它的人」。
生成时可以选它能不能写入、角色上限、多久到期（默认 90 天）。AI 实际能做的事，是你当前的角色、连接码的读写权限、角色上限三者取交集，以最小的那个为准。
你之后被降权，连接码跟着缩小；你之后被升权，连接码不会跟着变大。
删账、日结、月关账、拨款核销只能在网页做，AI 一律被拦——即使连接码有写入权限。
连接码不是密码，可以随时撤销重新生成，不影响你的登录账号。

生成连接码

进入 设置 → 集成，找到「AI 助手连接」区块（需 manager 以上权限）。
填一个备注方便辨识（例如「店长电脑的 Claude」）。
选它可以做什么：只勾「读取数据」就是一条只读连接码，AI 只能看不能改。
选角色上限：只能选到你自己的角色为止。想给人试用，选「店员」最保险。
选有效期限：默认 90 天，也可以自定义天数或选「永久」。列表上快到期的会标「建议轮换」。
按 生成连接码。连接码只显示这一次，离开页面就看不到了——请立刻用「复制连接码」或「复制连接指令」存起来。
丢失了不用紧张：撤销旧的、再生成一条新的即可。每家店最多 50 条。

连接方式一览

你用的工具	连接方式
Claude Code（终端）	一行指令，页面上的「复制连接指令」直接就是它
Claude 网页版／桌面版／手机	自定义连接器，见在 Claude 网页版连接 StoreOps
Codex CLI	指令＋环境变量
Hermes	配置文件 `config.yaml`
Cursor、opencode 等支持 MCP 的工具	配置文件（URL＋Authorization header）
ChatGPT	目前接不上：它的自定义连接器只支持 OAuth／无认证，用不了固定连接码

各工具设置方式

以下示例把 https://你的网址 换成你实际使用的 StoreOps 网址、sop_你的连接码 换成刚生成的连接码。

bash

claude mcp add --transport http storeops https://你的网址/api/mcp \
  --header "Authorization: Bearer sop_你的连接码"

# 之后在 Claude Code 里输入 /mcp 可确认连接状态

bash

# Codex 不直接存连接码，改读环境变量（建议把 export 放进 ~/.bashrc 或 ~/.zshrc）
export STOREOPS_MCP_TOKEN="sop_你的连接码"

codex mcp add storeops \
  --url https://你的网址/api/mcp \
  --bearer-token-env-var STOREOPS_MCP_TOKEN

yaml

# ~/.hermes/config.yaml
mcp_servers:
  storeops:
    url: https://你的网址/api/mcp
    headers:
      Authorization: Bearer sop_你的连接码

json

// ~/.cursor/mcp.json（全局）或项目里的 .cursor/mcp.json
{
  "mcpServers": {
    "storeops": {
      "url": "https://你的网址/api/mcp",
      "headers": { "Authorization": "Bearer sop_你的连接码" }
    }
  }
}

json

// opencode.json
{
  "mcp": {
    "storeops": {
      "type": "remote",
      "url": "https://你的网址/api/mcp",
      "headers": { "Authorization": "Bearer sop_你的连接码" }
    }
  }
}

通用原则

只要工具支持「remote／HTTP MCP server＋自定义 header」，就能连 StoreOps：URL 填 https://你的网址/api/mcp，header 加 Authorization: Bearer sop_你的连接码。

可以请 AI 做什么

连上之后直接用中文聊：

「帮我审查 8 月的月报，跟 7 月比一比」（也可以用内置的 analyze_month 提示模板）
「记一笔今天的房租支出 25,000」
「列出低于安全库存的耗材」
「上周外卖的营收是多少？」

AI 可用的功能：读（月报、账目明细、物料、耗材、供应商、销售来源、收款方式、记账分类、关账状态、固定费用、日结内容）与写（记账、修改账目、建物料、建耗材、建供应商）。刻意没有提供任何删除功能——删东西请自己来。

撤销与安全

在「AI 助手连接」列表按撤销，该连接码立即失效。
连接码是一把可撤销的钥匙：在它的能力上限内，拿到的人就能以你的身份操作。不要发给别人、不要存在共享文件里。
AI 成功执行的操作、连接码的生成与撤销，都会出现在审计日志。
被「网页专属」或连接码权限拦下的调用，数据完全没被碰到，也不会留下记录（那只是 AI 问了一句它不能做的事）。但如果是权限不足或已关账被拦，那会留一笔记录，看得出是哪一条连接码想动什么。

疑难排解

症状	原因与解法
AI 回「请先登录」	连接码打错或已被撤销——重新生成一条，换掉工具设置里的旧码
「MCP endpoint not found」或 404	网址不对（结尾必须是 `/api/mcp`），或服务器尚未开启 MCP 功能
「请稍后再试」（429）	请求太频繁，等一分钟再试
改账被拒绝	该月份已关账，或该笔是同步／POS 自动生成的数据——这些保护对 AI 一样生效

AI 助手连接（MCP） ​

运作方式 ​

生成连接码 ​

连接方式一览 ​

各工具设置方式 ​

可以请 AI 做什么 ​

撤销与安全 ​

疑难排解 ​