---
title: 双智能体架构与 MCP 安全接入
description: 嵌入式智能体与工作台智能体的分工，商派 MCP 服务架构、调用链、安全边界与部署方式
updated: 2026-09-22
tags: [AI, 架构, MCP, 安全, 智能体]
related: [ai/evolution.md, ai/scenarios.md, products/ai/index.md]
sources: [sources/ai-seminar/04-ecshopx-agent-initialization.md, sources/ai-seminar/04-mcp-service-security.md, sources/ai-seminar/04-oms-agent-initialization.md, sources/ai-seminar/05-embedded-vs-workspace-agents.md, sources/ai-seminar/enterprise-ai-security-concerns.md, sources/ai-seminar/index.md]
---

# 双智能体架构与 MCP 安全接入

## 两种智能体，为什么都需要

| | 嵌入式智能体 | 工作台智能体 |
|---|---|---|
| 服务对象 | 正在使用某个业务页面的人 | 坐在电脑前推进一项完整任务的人 |
| 上下文 | 当前身份、页面、业务上下文 | 跨页面、跨系统的任务目标 |
| 适合动作 | 导购、问答、推荐、下单、订单操作、结果呈现 | 经营分析、初始化设置、跨系统协同、批量作业 |
| 连接方式 | 产品内嵌 | 通过 MCP + Skill 调用业务能力底座 |

两者**共用业务能力底座**，服务不同使用现场，不是互相替代。

## MCP 服务架构（五层受控链路）

核心立场：**MCP 不是把后台账号、数据库连接或超管权限交给模型，而是让智能体只通过已登记、可审计的业务工具进入系统。**

```
L1 Agent Host      工作台智能体（Cursor / Hermes / OpenCode / Claude Desktop 等）
                   理解目标、选择工具、展示结果；不持有业务数据库连接
L2 MCP Server      商派 MCP 服务（如 shopex-oms-mcp-server）
                   登记工具、严格校验参数、管理批准令牌，按工具面暴露能力
L3 MCP API         固定接口门 /mcp-api/v1/*
                   验证专用凭证，实时解析员工工牌与部门范围；禁止任意 SQL / 控制器穿透
L4 Business        既有业务能力（Capability / Model / Service）
                   写行为落在原有业务契约与事务边界中
L5 Data            业务数据库——仅由既有业务能力访问，模型/工作台/MCP 均不直连
```

### 四层 Skill 文档（帮智能体发现正确的工作）

1. **角色入口**：客服台、运营塔、治理、开箱、经营与排障
2. **场景编排**：组织连续工作流（不复制领域真相）
3. **领域事实**：订单、发货、售后、主数据等原子能力
4. **诊断层**：日志、队列等（默认不进入 HTTP 公共面）

### 两层运行时工具面

- **public（56 个工具）**：HTTP 默认可发现，面向业务角色
- **full（89 个工具）**：仅 stdio / internal profile，含排障与底层治理原语
- 文档分类 ≠ 权限；真正拦权由 MCP API 按员工当前工牌执行

## 安全边界（核心原则）

1. **只走开好的门**：智能体只能调用登记过的工具，不能触达数据库
2. **权限跟人走**：实时解析操作者工牌与部门数据范围，越权即拒
3. **写操作先演习再批准**：写入前先演习说明影响 → 获得一次批准 → 执行后回读核对 → 留下回执
4. **公共工具面与完整工具面分离**：排障与治理原语不进入 HTTP 公共面
5. **最小授权 + 人工确认 + 调用审计 + 异常回退**：进入真实业务环境的前提

## 部署与配套

- 支持客户私有化部署智能体工作台
- 工作台选型参考（不同市场的工作台形态均可基于 MCP 接入）
- AI 大模型中转站服务
- 企业 AI 安全顾虑的客户原话汇总：[`sources/ai-seminar/enterprise-ai-security-concerns.md`](/sources/ai-seminar/enterprise-ai-security-concerns.md)

## 已验证的接管示例

- 用工作台智能体完成 **OMS 初始化与设置**（[`sources/ai-seminar/04-oms-agent-initialization.md`](/sources/ai-seminar/04-oms-agent-initialization.md)）
- 用工作台智能体完成 **ECShopX 初始化与设置**（[`sources/ai-seminar/04-ecshopx-agent-initialization.md`](/sources/ai-seminar/04-ecshopx-agent-initialization.md)）

---

**信息来源**：[`sources/ai-seminar/04-mcp-service-security.md`](/sources/ai-seminar/04-mcp-service-security.md)（MCP 服务与安全接入全文）、[`sources/ai-seminar/05-embedded-vs-workspace-agents.md`](/sources/ai-seminar/05-embedded-vs-workspace-agents.md)（双智能体辨析）、[`sources/ai-seminar/index.md`](/sources/ai-seminar/index.md)