MCP 接入

连接地址

在 agent 的「添加 MCP 连接 / MCP server」里填下面这个地址，类型选 HTTP（Streamable HTTP）。

https://lab.lzc2002.top/mcp/

第一次连接会打开本站登录页：登录并确认授权后，agent 拿到的是一枚只能访问本 MCP 服务的令牌，你的密码不会经过 agent。

按软件接入

选你用的客户端，照着做一次就行。所有客户端填的都是同一个地址，传输类型选 HTTP / Streamable HTTP。

目前仅桌面客户端支持自定义连接器，浏览器、移动端暂时无法配置。

打开 WorkBuddy，在左侧菜单中选择专家 · 技能 · 连接器。
在右侧页面顶部选择连接器，点击自定义连接器。
点击弹窗右上角的配置 MCP，粘贴下面这段配置：

{
  "mcpServers": {
    "Reagentory有剂可循 试剂台账本": {
      "type": "http",
      "url": "https://lab.lzc2002.top/mcp/",
      "disabled": false
    }
  }
}

保存后回到列表，在连接器管理页右上角打开自定义 MCP 入口，对新出现的 Reagentory有剂可循试剂台账本 点信任——不信任不会生效。
在已安装的 MCP 服务里找到 Reagentory有剂可循试剂台账本，点击右侧连接，在浏览器中完成登录和授权。

也可以直接改配置文件 ~/.workbuddy/mcp.json（Windows 上是 C:\Users\<你的用户名>\.workbuddy\mcp.json），改完重启客户端。

打开 Claude，进入 Settings › Connectors。
点击右上角 Add，选择 Add Connector。
输入服务器地址：

https://lab.lzc2002.top/mcp/

创建后点击 Connect，按页面提示完成登录和授权。

打开 Cursor，进入 Cursor Settings。
左侧选择 Tools & MCP，点击 Add Custom MCP。
编辑 .cursor/mcp.json，加入：

{
  "mcpServers": {
    "Reagentory有剂可循 试剂台账本": {
      "url": "https://lab.lzc2002.top/mcp/"
    }
  }
}

保存后重新打开 Tools & MCP，找到 Reagentory有剂可循试剂台账本，点击 connect，在浏览器中完成登录和授权。

在工作区中创建或编辑 .vscode/mcp.json，加入：

{
  "servers": {
    "Reagentory有剂可循 试剂台账本": {
      "type": "http",
      "url": "https://lab.lzc2002.top/mcp/"
    }
  }
}

也可以走命令面板（Ctrl+Shift+P / Cmd+Shift+P）运行 Add Server，类型选 HTTP (HTTP or Server-Sent Events)，填入上面的地址和 ID。
保存后按指引在浏览器中完成登录和授权。

在终端里运行：

claude mcp add --transport http "Reagentory有剂可循 试剂台账本" https://lab.lzc2002.top/mcp/

在 Claude Code 会话里运行 /mcp，按提示完成授权。

在终端里运行：

codex mcp add "Reagentory有剂可循 试剂台账本" --url https://lab.lzc2002.top/mcp/

命令执行后会自动提示完成登录和授权。

目前仅桌面客户端支持自定义连接器。

打开豆包，在左侧菜单中选择连接器 · 技能 · 伙伴。
页面右上角点击添加，选择新建自定义连接器。
传输类型选 HTTP，输入服务器地址：

https://lab.lzc2002.top/mcp/

保存后按指引在浏览器中完成登录和授权。

打开千问办公，在左侧菜单中选择连接器。
右上角点击添加，选择手动填写配置。
服务器类型选 Streamable HTTP，输入服务器地址：

https://lab.lzc2002.top/mcp/

保存后按指引在浏览器中完成登录和授权。

打开 TRAE，进入设置。
左侧选择 MCP，点击添加 › 手动添加。
粘贴下面这段配置：

{
  "mcpServers": {
    "Reagentory有剂可循 试剂台账本": {
      "url": "https://lab.lzc2002.top/mcp/"
    }
  }
}

保存后在列表里找到 Reagentory有剂可循试剂台账本，点击前往验证，在浏览器中完成登录和授权。

任何支持 Streamable HTTP 的客户端都能连。通用的填法：

地址 / URL：https://lab.lzc2002.top/mcp/
传输类型：HTTP、Streamable HTTP、http——各家叫法不同，不要选 SSE
鉴权：OAuth 2.1 自动授权，不用自己填令牌

{
  "mcpServers": {
    "Reagentory有剂可循 试剂台账本": {
      "type": "http",
      "url": "https://lab.lzc2002.top/mcp/"
    }
  }
}

接入后能做什么

查试剂：按名称、别名、CAS 号、一瓶一码或库位搜索，列出匹配的每一瓶。
看档案：某一瓶的完整字段——厂商、纯度、规格、有效期、库存状态、存放位置、领取人、管制属性。
查危险性：GHS 类别与类别号、象形图、判定标准，以及预防 / 应急反应 / 安全储存 / 废弃处置四段防范说明。
录入库：先查资料（库里历史记录优先，没有再查 CAS 资料库），确认后生成新的一瓶一码。
改状态与库位：领用中、已废弃、空瓶、放回在库并更新存放位置。
打标签：把标签加入云打印队列，打印终端自动出签。

写入类操作（录入、改状态、打印）需要你在对话框里确认，agent 不会擅自改动台账。

复杂场景：上面这些能力的组合

拍标签入库：发一张试剂瓶照片——它先读出字段并校验（CAS 校验位、日期先后、规格单位都会核一遍，防止 OCR 抄错），再查资料补全、按历史数据推荐存放位置，你确认后才入库，最后问你要不要打标签。
订单截图入库：发一张采购订单或商品页截图，它按行拆出每一样试剂，逐条校验、查资料、推荐库位，你一次确认后逐条入库，最后一次性批量打标签。
实验方案核对库存：粘贴一段实验方案或试剂清单，它会取库存清单逐项比对，告诉你要用的试剂哪些有、放在哪、哪些缺。

这几类场景需要读较大范围的库存数据，比普通查询慢一些；普通「有没有 XX」仍然走搜索，不会全表扫描。

已授权的连接

下面是已拿到访问令牌的客户端。撤销后它必须重新走一次登录授权。

给开发者的信息

传输方式: Streamable HTTP，单端点 POST /mcp/，无会话
协议版本: 当前修订版 2026-07-28，并向下兼容 2025-11-25 / 2025-06-18 / 2025-03-26
发现: server/discover（2026）或 initialize（旧版）自报版本、能力与授权入口
授权: OAuth 2.1 授权码 + PKCE（仅 S256），支持 Client ID Metadata Documents 与动态注册
权限范围: mcp:read（查询、查资料、查危险性）、mcp:write（录入、改状态、打印）

受保护资源元数据：/.well-known/oauth-protected-resource；授权服务端元数据：/.well-known/oauth-authorization-server。

常见问题

报 `SSE error: Invalid content type, expected "text/event-stream"`？

客户端把它当成了旧版 HTTP+SSE 传输——那种模式会先发一条 GET 去开长连接，期望拿到 text/event-stream。本服务只支持 Streamable HTTP（一次 POST、一次响应）， GET 会直接跳到本页，于是客户端读到 HTML 就报上面这句。

请把客户端的传输类型改成 HTTP / Streamable HTTP，不要选 SSE。只支持 SSE 的老客户端暂时连不上。

我的客户端只支持 SSE，能连吗？

暂时不能。SSE 传输要求服务端记住每条连接（响应要从另一条长连接推回去），与本服务无状态的设计冲突。目前主流客户端都已支持 Streamable HTTP。

为什么加了配置还是连不上？

WorkBuddy 需要在连接器管理页右上角打开自定义 MCP 入口，对新服务器点信任才会生效。
改了 mcp.json 一般要重启客户端才重新加载。
地址要带结尾的斜杠：https://lab.lzc2002.top/mcp/。

每次都要重新登录吗？

不需要。授权后客户端持有刷新令牌，会自动续期。只有你主动撤销授权、改密码或使用「全下线」时，才会要求重新登录。

agent 会看到我的密码吗？

不会。登录发生在本站的登录页，agent 只拿到一枚只能访问本 MCP 服务的令牌，它甚至不能拿来调用本站的普通接口。想收回授权，在上面「已授权的连接」里点撤销即可。

操作没有按预期执行？

工具被设计成不许替你猜：命中多瓶时会让你认领，缺关键信息会反问你，写入前一定会先复述改动。描述越具体（名称、CAS、一瓶一码、房间柜位）结果越准。