---
title: AI Agent 接入 OMS-MCP 集成指南
description: 文本抽取：安全性能/OMS/AI Agent 接入 OMS-MCP 集成指南
updated: 2026-11-04
tags: [原始文档, 抽取, 安全性能]
source: 安全性能/OMS/AI Agent 接入 OMS-MCP 集成指南
source_type: txt
source_hash: 23737128873e
extracted_at: 2026-11-04
quality: ok
---

（脱敏说明：同上，由多操作员集成指南转换为企业通用接入指南；客户与项目识别信息不出现在本文。）

企业 AI Agent 服务接入 Shopex OMS MCP 集成指南（多操作员）
 客户集成指南
 企业 AI Agent 服务接入 Shopex OMS MCP
多操作员集成指南（含后台无人值守服务）
 B/S 架构 Agent 服务如何优雅接入 OMS 能力 —— 助手服务按操作员授权（操作员型），后台服务密钥直换（Agent 型）；令牌隔离、权限实时收敛、审计定位到人 / 到服务账号
 版本 V1.12026 年 10 月配套文档：《MCP 授权 / 安全 / 审计日志 技术架构》V1.1读者：集成团队
 接入一句话：接入方 AI Agent 服务注册为 OAuth 机密客户端，每个操作员首次使用时经浏览器完成一次 OMS 登录与授权同意；
 之后接入方服务端按操作员持有独立令牌与独立 MCP 会话 —— 权限按操作员角色实时收敛、审计逐人可查、单人吊销不影响他人。
 1
次应用注册（全公司共享）
 1
次操作员授权（每人仅首次）
 30分
令牌效期（自动续期）
 按人
权限与审计隔离粒度
 4
项核心改造点
 壹总体方案
 为什么按操作员授权 · 整体架构 · 各方职责边界
 1.1 核心问题：多操作员意味着什么
 接入方 AI Agent 服务是 B/S 架构：操作员用浏览器访问接入方应用，接入方服务端代表操作员调用 OMS 能力。
 「多操作员」带来三个必须解决的问题，而共享一个凭证的粗暴做法三个都解决不了：
 问题 | 共享一个凭证的后果 | 按操作员授权的效果 | 
 权限隔离 | 所有人共享一个账号的权限，无法按人收权 | 每个操作员继承自己 OMS 账号的角色权限，实时收敛 | 
 审计定位 | 日志里只有一个账号，查不出"是谁干的" | 每次调用记录操作员身份 + 接入方应用 + 智能体 + 工具 | 
 独立吊销 | 撤销凭证 = 全员断线 | 吊销 / 停用单人，其他操作员不受影响 | 
 ✦ 关键机制（已在 OMS 侧就绪）：OAuth 授权与令牌按「操作员 × 应用」双维度管理 ——
 接入方只需注册一个应用，每个操作员各自完成一次授权，即获得绑定本人身份的独立令牌。操作员的 OMS 账号角色变化、停用、吊销，都只影响该操作员自己的令牌。
 1.2 先选形态：接入方是"给人用"还是"给机器用"
 OMS 提供三种授权形态。接入方 AI Agent 服务属于哪一种，决定了后续接入路径：
 授权形态 | 适合的程序 | 授权方式 | 令牌身份 | 本指南章节 | 
 公开型（动态注册） | 第三方 AI 连接器（WorkBuddy 等）、本地命令行工具 | 应用自助注册 + 每用户浏览器同意 | 各操作员本人 | —（OMS 侧自动完成，无需接入方开发） | 
 操作员型机密（管理端注册） | 接入方 B/S 架构 AI 助手服务（操作员在浏览器里使用） | 管理员注册应用 + 每操作员浏览器授权一次 | 各操作员本人 | 第贰 ～ 伍章（主体路径） | 
 Agent 型机密（管理端注册） | 接入方后台自动化服务（对账 / 同步 / 审单，无人值守） | 管理员注册时绑定服务账号 + 配角色（注册即授权） | 绑定的服务账号 | 第贰章 2.5（专节） | 
 ✦ 选型口诀：给人用的走浏览器授权（令牌身份 = 操作员本人，权限跟人走）；给机器用的走密钥直换（令牌身份 = 服务账号，权限跟角色走）。同一个客户既有助手又有后台服务 → 分开注册两个应用（一个程序一个客户端）：分开配权限、分开保管密钥、出问题分开止损，互不牵连。
 1.3 整体接入架构（操作员型路径）
 多操作员接入总体架构 —— 一个应用 · 每人一份令牌
 虚线框内为接入方系统（B/S 架构），右侧为 OMS 侧能力
 接入方 AI Agent 服务（B/S 架构）
 操作员 A
 浏览器
 （客服主管）
 令牌 A（其权限）
 操作员 B
 浏览器
 （仓储专员）
 令牌 B（其权限）
 操作员 N
 （权限各不相同）
 …按需扩展
 接入方前端
 对话 / 工作台界面
 授权入口
 （首次使用引导）
 变更预览卡片
 （写操作确认 UI）
 会话内聊天
 （工具结果呈现）
 接入方服务端
 （Agent 核心）
 按操作员
 令牌池
 MCP 会话池
 （每人独立）
 续期调度器
 （30 分钟轮换）
 确认流代理
 （prepare→apply）
 应用密钥保管
 OMS 侧（Shopex OMS）
 OAuth 授权服务
 登录 · 同意 · 签发令牌
 应用注册表
 接入方应用（唯一注册）
 操作员账号体系
 角色 · 权限 · 开关
 权限实时解析
 令牌 → 角色交集
 MCP 服务端（工具网关）
 会话隔离
 每操作员独立会话
 149 业务工具
 订单 · 库存 · 售后 …
 OMS 审计中心
 每次调用：操作员 + 接入方应用 + 智能体 + 工具 + 结果 + 耗时
 操作员可见自己的调用日志；管理员可见全部
 ① 授权流
 （仅首次）
 ② 工具调用
 （令牌 A / B / N）
 职责边界：
 接入方负责 —— 授权跳转与回调、按操作员的令牌 / 会话管理、续期调度、确认流 UI 呈现、密钥安全保管
 OMS 负责 —— 令牌签发验签、权限实时收敛、业务执行、全链路审计、吊销与止损
 图例：实线 = 日常数据流；紫色 = 一次性授权流；虚线 = 审计写入。操作员之间从令牌、会话到权限完全隔离。
 图 1-1 · 多操作员接入总体架构（一个应用注册 · 每操作员独立令牌与会话）
 贰接入流程
 一次性准备 · 操作员授权时序 · 日常调用与续期 · 令牌管理
 2.1 一次性准备（接入方运维 / OMS 管理员协作 · 操作员型路径）
 以下 4 步适用于操作员型（给人用的助手服务）。Agent 型（后台无人值守服务）的准备更简单 —— 无回调地址、无逐人授权，见 2.5 专节。
 1注册应用
向 OMS 管理员申请注册接入方应用（机密客户端），登记回调地址、申请的授权域。审批模式由企业方与 OMS 管理员约定（开放 / 需审批）。
 2获得凭证
审批通过后获得应用标识与密钥。密钥仅此一次展示，请立即存入接入方密钥管理服务（KMS / 加密配置中心），不得写入代码或前端。
 3开通账号（硬性前提）
操作员账号必须提前在 OMS 中创建，并按其岗位职责配置角色，管理员在用户管理中为其开启 MCP 接入开关。不存在"只注册接入方应用、无 OMS 账号"的接入方式 —— 授权登录用的是 OMS 账号本身。
 4登记回调
接入方注册 OAuth 回调地址（HTTPS），用于接收授权码。回调地址在 OMS 侧精确校验，登记后方可走通授权。
 ✦ 生产建议：开发、测试、生产环境建议各自注册独立的应用（各自回调地址与密钥），避免环境间令牌混用。接入方服务重启不丢失授权关系 —— 授权绑定的是「操作员 × 应用」，与接入方服务实例无关。
 ✦ 硬性前提：OMS 操作员账号必须提前创建
· 授权即登录 —— 操作员首次授权时的浏览器登录，用的就是 OMS 账号本身（口令 / 验证码 / 企业 SSO）；没有 OMS 账号，授权流程在登录一步就走不下去；
· 账号决定权限 —— AI 能做什么完全由该操作员的 OMS 角色决定，账号没建好、角色没配对，AI 的能力面就跟着错；
· 人员变动走 OMS —— 新员工入职：先在 OMS 建账号、配角色、开 MCP 接入开关，再到接入方系统完成授权；员工离职 / 转岗：在 OMS 侧停用账号或调整角色，其授权立即失效或收敛，无需通知接入方；
· OMS 是唯一身份源 —— 接入方系统无需也无法替操作员在 OMS 侧开账号；权限的增减收放，唯一入口是 OMS 的用户管理。
 2.2 操作员首次授权（核心时序）
 每个操作员只需完成一次。之后接入方服务端持久化该操作员的刷新令牌，即可长期代表其调用（令牌 30 分钟自动续期）。
 操作员授权时序图（每人仅首次）
 操作员
 接入方系统用户
 接入方服务端
 Agent 核心
 OMS 授权服务
 登录 · 同意 · 签发
 MCP 服务端
 工具网关
 阶段 ① 授权跳转与登录同意（浏览器内完成）
 阶段 ② 换取并持久化令牌（接入方服务端完成）
 阶段 ③ 建立 MCP 会话（此后进入日常调用）
 点击「连接 OMS」
 302 跳转 OMS 授权页（授权码 + 防截获）
 携带接入方应用标识 + 回调地址
 浏览器到达 OMS 授权页
 未登录 → 先进 OMS 登录页（口令密文 · 防重放）
 已登录 → 直接展示同意页
 同意页显示：操作员账号 + 接入方应用名 + 申请的授权域
 操作员确认「同意授权」
 302 回跳接入方回调地址（一次性授权码）
 回调携带授权码到达
 服务端换票（授权码 + 应用密钥 + PKCE 校验值）
 校验：应用密钥 · 回调地址 · PKCE · 授权码一次性
 签发：绑定该操作员身份的访问令牌 + 刷新令牌
 令牌对（访问 30 分钟 / 刷新可轮换）
 按操作员持久化：刷新令牌加密落库
 （建立 操作员 → 令牌 的映射）
 授权完成提示 → 返回工作台
 初始化 MCP 会话（携带操作员的访问令牌）
 验签 + 声明校验 → 会话绑定（应用 + 该操作员）
 会话 ID 下发，后续调用携带
 会话就绪（进入日常工具调用循环）
 接入方会话池登记：操作员 → MCP 会话
 请求
 响应
 接入方动作
 OMS 动作
 图 2-1 · 操作员首次授权时序（三阶段：浏览器同意 → 服务端换票 → 建立会话）
 2.3 日常调用与令牌续期
 授权完成后，接入方 Agent 代表操作员的每一次工具调用，以及 30 分钟一次的令牌续期，均由接入方服务端与 OMS 之间直接完成，操作员无感知：
 日常调用与令牌续期（多操作员并行示意）
 操作员 A 的调用（客服主管 · 可见订单与售后）
 操作员 B 的调用（仓储专员 · 可见库存与发货）
 后台：续期调度（每操作员独立，提前续）
 「帮我查这个客户的订单」→ 工具调用（会话 A · 令牌 A）
 订单数据（按 A 的角色过滤）+ 审计编号
 接入方服务端
 取 A 的令牌 / 会话
 填入 Agent 身份头
 MCP 工具调用
 结果 + 权限校验
 MCP
 服务端
 + OMS
 「这个 SKU 还有多少库存」→ 工具调用（会话 B · 令牌 B）
 库存数据（按 B 的角色过滤）+ 审计编号
 接入方服务端
 取 B 的令牌 / 会话
 与 A 完全隔离
 MCP 工具调用
 结果 + 权限校验
 续期调度器
 提前 2 分钟轮换
 刷新令牌轮换
 新访问令牌（30 分钟）
 调度触发（定时任务 / 惰性触发）
 要义：谁提问，就用谁的令牌 —— 权限、数据范围、审计、限流全部天然按操作员隔离
 并发规模建议：每操作员维护 1 个 MCP 会话复用即可；访问令牌过期前由后台统一续期，操作员全程无感知
 图 2-2 · 日常调用与令牌续期（多操作员并行）
 2.4 令牌与会话的管理规则
 对象 | 规则 | 原因 | 
 刷新令牌 | 按操作员加密持久化（KMS / 加密列），仅服务端可读 | 它是长期凭证，是接入方服务重启后免重新授权的关键 | 
 访问令牌 | 内存态即可，过期前续期，不落盘 | 30 分钟短效，落盘徒增泄露面 | 
 MCP 会话 | 每操作员 1 个，闲置复用；重建无副作用 | 会话与身份绑定，混用会被拒绝 | 
 续期时机 | 到期前 2 分钟主动续；收到 401 再兜底续一次重放 | 避免调用途中过期 | 
 令牌失效处理 | 续期失败（操作员改密 / 被停用）→ 标记该操作员需重新授权，提示其重新走授权流 | OMS 侧吊销会即时生效，接入方需有优雅降级 | 
 应用密钥 | 仅换票时使用，与操作员令牌分开保管 | 两者泄露影响面不同 | 
 ✦ 两个必须避免的反模式：
 ① 全员共享一个凭证 / 一个令牌 —— 权限、审计、吊销三个维度全部失控，一旦泄露等于全员失守；
 ② 把刷新令牌下发到浏览器 —— 刷新令牌必须只存在于接入方服务端，浏览器侧只持有接入方自己的会话。
 2.5 后台无人值守服务：Agent 型接入路径（专节）
 如果接入方的程序是后台自动化服务（每晚对账、库存同步、自动审单……没有操作员在浏览器前），走 Agent 型机密客户端 —— 授权在注册时一次完成，运行期凭密钥直换令牌，全程无浏览器：
 步骤 | 谁做 | 做什么 | 要点 | 
 ① 创建服务账号 | OMS 管理员 | 在用户管理创建"服务账号"（建议 svc_ 前缀命名）并配置角色 —— 或留到注册应用时"顺带创建" | 角色即权限边界：只读对账就只给读权限；服务账号不能登录控制台、不会出现在操作员列表里 | 
 ② 注册 Agent 型应用 | OMS 管理员 | 控制台注册时选择"Agent 型"，绑定上一步的服务账号，选择授权域 → 注册即授权 | 无需回调地址（没有浏览器环节）；密钥一次性交接，立即存入接入方密钥管理服务 | 
 ③ 服务侧配置 | 接入方集成团队 | 后台 worker 进程配置应用标识 + 密钥（仅该进程持有，不进代码仓库 / 不下发前端） | 与助手服务的密钥分开保管 —— 两个程序两个应用两份密钥 | 
 ④ 密钥换令牌 | 接入方后台服务 | 启动时 / 令牌到期前，凭密钥向令牌端点换取 30 分钟访问令牌（客户端凭证模式） | 令牌身份 = 绑定的服务账号；不发刷新令牌，到期重走本步即可（如提前 2 分钟） | 
 ⑤ 调用工具 | 接入方后台服务 | 与操作员型完全相同：Bearer 令牌 + MCP 会话，读写照常（写操作仍走三步确认，由服务程序自动确认） | 权限按服务账号角色实时解析；审计记录"服务账号 + 应用 + 工具" | 
 Agent 型接入：注册即授权 · 运行期密钥直换
 上半部 = 一次性准备（管理员）· 下半部 = 运行期循环（接入方后台服务）· 右侧 = 止损动作
 一次性准备（OMS 管理员 · 约几分钟）
 创建服务账号
 svc_ 前缀 · 配角色（权限边界）
 禁登录 · 不入操作员列表
 注册 Agent 型应用
 绑定服务账号 · 选授权域
 注册即授权（无需浏览器同意）
 密钥一次性交接
 存入接入方 KMS / 加密配置
 仅后台 worker 持有
 运行期循环（接入方后台服务 · 自动 · 无人工介入）
 密钥换令牌
 客户端凭证模式 · 校验密钥
 + 服务账号状态
 30 分钟访问令牌
 身份 = 服务账号 · 无刷新令牌
 结构与操作员型完全一致
 调用工具
 Bearer + 会话 · 读写照常
 到期前 2 分钟重换
 到期前自动重换（无人工介入）
 即时止损（任一动作
 下一次请求即拒绝）
 停用服务账号
 该 Agent 全部调用终止
 吊销应用
 疑似密钥泄露时止损
 轮换密钥
 换密不换应用标识 · 服务侧
 只更新密钥配置
 与操作员型的关系：令牌同构（同一套验签 / 权限 / 审计）· 差异仅在授权来源（管理员注册 vs 操作员同意）与身份来源（服务账号 vs 操作员本人）
 图 2-3 · Agent 型后台服务接入：一次准备 + 运行期密钥直换循环 + 即时止损
 ✦ Agent 型与操作员型的差异速览：授权发生时点（注册时 vs 每人首次使用时）· 令牌身份（服务账号 vs 操作员本人）· 续期方式（到期重换 vs 刷新令牌轮换）· 审计定位（到服务账号 + 应用 vs 到人 + 应用）。相同点：30 分钟短效令牌、五层校验、权限实时收敛、写操作三步确认、全链路审计 —— 下游机制一套复用。
 叁写操作确认流（接入方 UI 的关键配合点）
 为什么需要 · 三步交互 · 与接入方界面的融合方式
 3.1 为什么需要接入方配合
 OMS 侧对写操作（创建、修改、删除类工具）强制执行「试算预览 → 确认 → 执行」。首次调用只返回变更预览与确认凭证，不实际执行；
 必须携带确认凭证二次提交才真正写入。这个设计的目的是让人保留对 AI 改数据的最终控制权 —— 而确认动作发生在接入方界面上，因此需要接入方 UI 配合呈现。
 3.2 三步交互流（以"创建操作员账号"为例）
 写操作确认流 —— 接入方界面的三步配合
 操作员
 接入方界面
 接入方服务端
 Agent 核心
 OMS · MCP
 服务端
 STEP 1 发起（对话式）
 「帮我在 OMS 创建一个客服账号，角色给基础权限」
 工具调用（未带确认凭证）
 未执行 + 变更预览 + 确认凭证（300 秒有效）
 STEP 2 确认（接入方界面渲染确认卡片）
 Agent 回复中携带「待确认变更」结构化数据
 ⚠ 即将创建 OMS 操作员账号
 账号名：cs_zhang · 姓名：张三 · 角色：客服（基础权限）
 生效范围：订单查询、售后处理（只读为主）
 确认执行
 取消
 STEP 3 执行（携带确认凭证二次提交）
 操作员点击「确认执行」
 同一工具调用（携带确认凭证）
 执行成功 + 审计编号（谁确认的、何时、改了什么）
 确认凭证 300 秒有效且一次性：超时未确认 → 自动失效，需重新发起；重复提交 → 拒绝
 图 3-1 · 写操作三步确认流（接入方界面渲染确认卡片）
 3.3 与接入方界面的融合建议
 要点 | 建议 | 
 识别待确认状态 | 工具返回中带明确的"待确认"标记与变更摘要结构化字段，据此渲染确认卡片而非纯文本 | 
 确认卡片要素 | 操作类型徽章（创建/修改/删除）+ 变更清单（字段：旧值 → 新值）+ 剩余有效时间 + 确认/取消按钮 | 
 倒计时提示 | 确认凭证 300 秒有效，卡片上建议显示倒计时；超时后引导重新发起 | 
 审计编号回显 | 执行成功后向操作员展示审计编号，便于双方后续对账追溯 | 
 失败降级 | 权限不足（返回权限提示）时直接展示，不渲染确认卡片 | 
 ✦ 读操作无需任何确认：查询类工具直接返回结果。仅写操作（创建/修改/删除）需要上述三步流。接入方也可以选择把「确认」做成对话内快捷按钮（推荐），比跳转页面体验更好。
 肆错误处理与降级
 统一错误语义 · 六类典型场景的处置动作 · 重试策略
 4.1 统一错误语义
 MCP 工具调用失败按 JSON-RPC 错误返回，错误码语义稳定，接入方可按码分流处理：
 场景 | 典型错误 | 接入方处置动作 | 
 令牌过期 | 401 类（未认证质询） | 静默用刷新令牌续期一次，成功后重放原请求；失败则走重新授权 | 
 操作员被吊销 / 停用 | 401 / 403（令牌版本失效） | 清除该操作员令牌，界面提示"OMS 授权已失效，请重新连接" | 
 权限不足 | 403（明确权限提示文案） | 原样展示权限提示（OMS 返回友好文案），引导联系 OMS 管理员 | 
 参数校验失败 | 参数错误（含字段级说明） | 交给 Agent 自我修正参数后重试（通常一次即成） | 
 确认凭证问题 | 需确认 / 已过期 / 已重放 / 不匹配 | 重新发起 prepare 获取新凭证；界面同步更新确认卡片 | 
 服务暂不可用 | 暂时不可用（网关 / 密钥服务抖动） | 指数退避重试（建议 1s/2s/4s，最多 3 次），仍失败则友好提示 | 
 4.2 重试与幂等策略
 操作类型 | 失败重试 | 说明 | 
 读操作 | 可安全重试 | 天然幂等，网络抖动可直接重放 | 
 写操作（prepare 阶段） | 可安全重试 | 只是试算，不产生副作用 | 
 写操作（apply 阶段） | 谨慎 | 确认凭证一次性，重放会被拒绝；失败后应重新走 prepare→确认→apply | 
 授权 / 换票 | 谨慎 | 授权码一次性；失败重新发起授权跳转 | 
 ✦ 设计哲学：OMS 侧的一次性凭证（授权码、确认凭证、刷新令牌）都带防重放语义，接入方不需要自行设计防重逻辑，遵循"失败就重新走一遍流程"即可，简单可靠。
 伍上线检查清单
 接入开发自检 · 上线前安全检查 · 运行期监控建议
 5.1 接入开发自检（DoD）
 类别 | 检查项 | 
 授权 | ☐ 授权跳转、回调接收、换票三件套走通（PKCE 校验值服务端生成） | 
 ☐ 刷新令牌按操作员加密持久化，服务重启后免重新授权 | 
 ☐ 续期调度：到期前 2 分钟主动续，401 兜底续一次 | 
 多操作员 | ☐ 令牌池 / 会话池按操作员隔离，无任何共享路径 | 
 ☐ 单个操作员令牌失效不影响其他操作员（实测验证） | 
 ☐ 操作员在 OMS 侧改密 / 停用后，接入方下次调用正确感知并提示 | 
 工具调用 | ☐ 读操作直接返回；写操作三步确认流在接入方界面正确渲染 | 
 ☐ 确认卡片倒计时 + 超时重新发起逻辑就绪 | 
 安全 | ☐ 应用密钥仅存服务端密钥管理服务；日志中无令牌 / 密钥明文 | 
 ☐ 回调地址仅 HTTPS；state 参数校验（防跨站请求伪造） | 
 后台服务
（Agent 型） | ☐ 密钥换令牌走通（客户端凭证模式），令牌到期前自动重换 | 
 ☐ 服务账号角色最小化（只读对账就只给读权限），写操作确认由服务程序按策略自动确认并留痕 | 
 ☐ 密钥仅后台 worker 进程持有，与助手服务的密钥分开保管 | 
 5.2 上线前安全检查
 检查项 | 通过标准 | 
 密钥保管 | 应用密钥与刷新令牌全部在服务端加密存储，代码仓库 / 配置文件 / 日志零明文 | 
 传输安全 | 接入方服务与 OMS 之间全程 HTTPS；回调地址 HTTPS 且已登记 | 
 浏览器侧 | 浏览器不持有任何 OMS 令牌（只持有接入方自身会话） | 
 错误信息 | 面向操作员的错误提示不含令牌、内部地址等敏感信息 | 
 授权范围 | 申请的授权域与实际使用的工具匹配，未申请多余范围 | 
 5.3 运行期监控建议
 监控项 | 建议 | 
 续期成功率 | 低于 95% 告警（通常意味着操作员批量被吊销或 OMS 侧变更） | 
 401 / 403 比例 | 突增告警（令牌管理 bug 或权限配置变更） | 
 工具调用成功率与耗时 | 按工具维度统计，异常工具及时排查 | 
 确认流完成率 | 大量"prepare 后未确认"属正常用户行为；大量"apply 被拒"需检查实现 | 
 对账 | 接入方调用日志与 OMS 调用日志页按审计编号定期抽样对账 | 
 附附录：关键概念速查
 概念 | 一句话解释 | 
 三种授权形态 | 公开型（应用自助注册 + 用户浏览器同意）、操作员型机密（管理端注册 + 每操作员授权）、Agent 型机密（管理端注册 + 绑定服务账号，注册即授权）—— 三者令牌结构一致，仅授权与身份来源不同 | 
 服务账号 | 专为后台服务创建的账号类型：不能登录控制台、不出现在操作员列表，但可配角色、可被 Agent 型应用绑定 —— 后台服务的权限边界与审计主体 | 
 客户端凭证模式 | Agent 型应用凭密钥直接换取令牌的方式（无浏览器、无授权码），令牌身份 = 绑定的服务账号，30 分钟短效、到期重换 | 
 一个程序一个客户端 | 助手服务与后台服务即使同属一家，也分开注册两个应用：分开配权限、分开保管密钥、分开止损，互不牵连 | 
 机密客户端 | 有独立服务端、能安全保管密钥的应用类型（接入方 AI Agent 服务即此类），换票时需证明身份 | 
 授权码换票 | 浏览器完成同意后拿到一次性授权码，由接入方服务端凭密钥换取令牌 —— 授权码模式的核心两步 | 
 PKCE | 换票时附带的动态校验值，防止授权码在传输中被截获冒用 | 
 刷新令牌 | 长期凭证，用于不断换取新的 30 分钟访问令牌；一次性轮换，被重放会触发整账号会话吊销 | 
 确认凭证 | 写操作二次提交的一次性凭证，300 秒有效，绑定操作员 / 会话 / 操作对象 | 
 授权域 | 应用可申请的权限范围（6 个），映射到 OMS 权限点；实际权限仍按操作员角色实时计算 | 
 MCP 会话 | MCP 服务端与接入方服务端之间按操作员隔离的连接上下文，身份绑定、不可混用 | 
 审计编号 | 每次调用的唯一追溯标识，双方日志可据此对账 | 
 ✦ 本指南与《Shopex OMS · MCP 授权 / 安全 / 审计日志 技术架构》配套使用：架构文档说明 OMS 侧的安全设计，本指南说明接入方侧的接入实现。两份文档均不包含内部接口路径，具体对接参数（授权地址、回调地址、工具清单等）在联调时由 OMS 实施团队提供。
 企业 AI Agent 服务接入 Shopex OMS MCP · 多操作员集成指南（含后台无人值守服务） · V1.1 · 2026 年 10 月