条码大师

解决什么问题

在使用 MCP 客户端（如 Work Buddy、Trae、Qoder、VS Code）接入条码大师时，工程师常面临配置复杂、环境依赖不一以及租户隔离等问题。条码大师助手作为实施顾问角色，负责指导客户完成 MCP 的安装与验证，并提供物料、库存、包装策略及条码策略的查询与受控写入能力，避免在对话中编造数据或混淆业务概念。

核心能力与关键步骤

该技能主要围绕两类安装方式展开：

• 远程 HTTP URL：推荐终端用户使用，无需安装 Node，通过填写 MCP URL 和 Authorization 头部（如 Bearer oak_{KeyId}_{Secret}）即可连接。
• 本机 stdio（node）：适用于管理员已交付离线安装包（含 dist/index.js）且本机已安装 Node 18+ 的场景，通过配置环境变量和命令行参数启动。

在能力层面，技能提供 21 个工具（16 只读 + 5 写入），覆盖物料搜索、库存查询、出入库单据、包装策略和条码扫描/规则策略。对于写入操作（如套用包装策略、追加容器层、应用抓取策略），技能强制要求先预览、向用户逐层确认摘要，并在写入后回读验证，杜绝静默写入。

适用边界与注意点

• 租户隔离：组织由 API Key 自动识别，禁止填写 OrgOID。
• 策略区分：必须严格区分条码扫描策略、条码规则策略、包装策略和条码规则抓取策略，避免概念混淆。
• 错误处理：遇到 feature_disabled 或 material_has_scan_data 等错误时，需联系管理员调整开关或清理数据，不可自行猜测参数。
• 客户端差异：VS Code 需切换到 Agent 模式，Qoder 需在 My Servers 中添加 Streamable HTTP 配置。