MCP 接入

Model Context Protocol

让 AI,连上真实业务。

将工具、数据与业务系统,连接到智能体的工作现场。

通过统一的能力描述与消息协议,让已有系统成为 AI 可以发现、理解与使用的能力。壹典围绕 ID Axis,构建从模型推理到业务执行的接入方式。

看一次协议往返
你的 AI 应用ID Axis

任务与上下文

客户端 A
客户端 B
业务服务端设计工具 · 数据服务 · 业务操作
知识服务端项目资料 · 企业知识 · 工作模板

连接架构

各司其职,才能真正协同。

模型需要知道能做什么,系统需要知道谁在调用。MCP 在两者之间建立协议层,应用与服务各自保留责任。

01

宿主应用

承载用户交互与模型推理,决定上下文如何汇集、哪些调用需要确认。ID Axis 的工作流可在这一层组织任务。

Host
02

协议客户端

由宿主管理,与具体服务端建立连接,处理版本协商、能力发现与消息路由。连接边界与业务职责保持清晰。

Client
03

能力服务端

将现有系统适配为边界明确的工具、资源与提示模板。业务逻辑与权限校验仍留在服务侧。

Server

MCP 统一连接方式;权限决策、任务规划与业务事务,仍由应用及服务实现。架构规范

协议里的三种能力

动作、上下文、方法。各有自己的表达。

同一个设计项目,可以需要调用工具、读取依据,也可以复用评审方法。选择一种能力,查看它如何进入应用。

协议过程示例 · 非实时调用

“找到这个项目已经确认的设计资产。”

工具先声明输入结构,再由客户端提交参数。服务端在授权范围内执行检索,返回可继续处理的结果。

客户端请求tools/call
{
  "jsonrpc": "2.0",
  "id": 21,
  "method": "tools/call",
  "params": {
    "name": "search_design_assets",
    "arguments": {
      "project": "GT-CONCEPT",
      "status": "approved"
    }
  }
}
tools/listtools/call
返回应用的内容

设计资产已找到

两个结果,带着版本与来源返回。

GT 外观设计方案

图像资产 · v03

design://gt/concept/v03
设计需求确认书

项目文档 · v02

design://gt/brief/v02

模型决定何时提出工具调用;应用决定它是否可以执行。

查看对应的响应结构
{
  "jsonrpc": "2.0",
  "id": 21,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "2 approved design assets found."
      }
    ],
    "structuredContent": {
      "assets": [
        {
          "uri": "design://gt/concept/v03",
          "version": "03"
        },
        {
          "uri": "design://gt/brief/v02",
          "version": "02"
        }
      ]
    }
  }
}
示例采用 MCP 2025-11-25,假定连接已完成初始化。工具、资源与项目内容均为接入设计示意。对应协议规范

从连接到执行

先明确能做什么,再发起具体调用。

一次可靠的接入,需要对齐协议版本、可用能力和业务边界。下面以 2025-11-25 版本的会话流程说明。

  1. 01

    协商

    交换支持的版本与能力,完成就绪通知。

    initialize
  2. 02

    发现

    读取能力描述、输入结构与使用条件。

    tools/list
  3. 03

    校验

    检查身份、参数与数据范围,必要时请求确认。

    应用策略
  4. 04

    执行

    调用服务,返回结果或可解释的错误。

    tools/call

协议负责消息往返,宿主负责行动边界。服务端仍须执行自己的访问控制与业务校验。

生命周期规范

连接方式

从本机工具,连接到远端服务。

协议层描述能力,传输层承载消息。依据部署位置、身份体系与运维方式,选择适合的连接路径。

本地进程

stdio

客户端启动服务进程,通过标准输入与输出交换 JSON-RPC 消息。适合桌面应用、本机文件工具与开发环境集成。

  • 工具运行在本机进程边界内
  • 凭据通过受控环境提供
  • 日志与协议输出分开处理

网络服务

Streamable HTTP

服务作为独立进程运行,通过 HTTP 承载请求与响应,并可使用 SSE 传递流式消息。适合企业服务、共享能力与受控网络中的集中接入。

  • 按资源与身份控制访问
  • 处理连接、超时与消息恢复
  • 按目标客户端核对协议版本

远程受保护服务可采用 MCP 授权规范定义的 OAuth 流程;具体身份提供方、作用域与部署方案在接入设计中确定。

传输规范

壹典的企业接入思路

连得上,也要用得稳。

从企业 AI 到工业设计工具,接入工作不止是包一层协议。我们将能力建模、权限映射与运行治理放在同一份实施设计中。

01

把业务接口,整理成能力契约。

从一个边界清楚的场景开始,说明工具何时使用、参数是什么、结果如何返回。为输入与结构化输出建立 Schema,让模型可理解,也让程序可校验。

  • inputSchema
  • outputSchema
  • 工具语义
02

让身份、权限与数据范围相互对应。

把调用者身份映射到租户、项目与资源范围。读取资料与修改业务数据采用不同策略;原系统的授权约束继续生效,工具描述不充当权限证明。

  • 身份映射
  • 最小权限
  • 读写分离
03

为真正的运行环境,设计失败路径。

区分协议错误、业务拒绝与执行失败。为调用设置超时和取消边界;涉及写入的动作结合幂等设计,避免把重试变成重复执行。

  • 超时与取消
  • 幂等设计
  • isError
04

让一次调用,能够被解释和复查。

记录调用来源、参数摘要、所用版本与结果状态。敏感信息采用脱敏与保留策略,让排查、业务审计与后续优化拥有同一条可追踪的依据。

  • 调用关联
  • 版本记录
  • 敏感信息处理

企业权限不会因为接入 AI 而消失。访问令牌的受众校验、最小权限与服务端授权,是连接设计的一部分。

授权规范

在壹典能力体系中

模型负责推理。连接让行动有据。

下一步

从一个真实场景,开始连接。

带上要接入的应用、系统边界与目标动作,一起定义第一份可实施的能力契约。

鲁ICP备2024109755号-2
可拖动移动。右键、长按或按 Shift+F10 可选择停靠位置。