如何把企业存量系统接进智能体？MCP 协议接入实战教程

摘要

企业里沉淀了大量 HTTP/REST 接口，让智能体用上它们更省事的方式，不是重写接口，而是把它们转换成 MCP 工具。本文以腾讯云 Agent 网关服务为例，给出从环境准备、控制台配置、接口创建、客户端接入到鉴权与排障的完整步骤，照着做即可跑通一条“存量接口 → MCP 服务 → 智能体”的链路。

一、先明确目标与前置条件

目标很具体：把一个已经存在的 HTTP 接口，转换成一个可被智能体调用的 MCP 工具。这里说的 MCP 工具，就是智能体可以按标准协议调用的一个外部能力，一次调用通常对应后端的一个接口。

开始之前，请确认以下条件已经具备：

• 有一个可访问的后端服务地址（域名或 IP），并知道要暴露的接口路径、入参与返回值结构；
• 已在腾讯云开通 Agent 网关服务，并创建好一个处于运行状态的网关实例；
• 准备好后续用来调用工具的支持 MCP 的客户端；
• 如果后端在私有网络内，已确认网关到后端的网络与端口可达。

二、路径一：在控制台把 HTTP 接口转换为 MCP 服务

第 1 步：创建后端服务

登录腾讯云控制台，进入 Agent 网关服务的实例列表，单击目标实例的 ID 进入实例详情页，再进入“服务管理 > 服务”，按提示创建一个后端服务，填写服务协议（HTTP 或 HTTPS）、服务地址与端口。这一步是“HTTP 转 MCP 服务（域名/IP 模式）”的前置条件。

第 2 步：新建 MCP 服务

在网关实例详情页左侧导航单击“MCP 管理”，在 MCP 服务列表上方单击“新建”，先完成“基本信息”配置：

存量接口场景选择“HTTP 转 MCP 服务”。

第 3 步：配置后端服务

进入“后端服务配置”步骤，选择“域名/IP”后端类型，填写以下参数：

第 4 步：配置工具（Tools）

创建完成后，进入服务详情页的“Tools 管理”页签，为这个 MCP 服务定义工具：既可以手动逐个创建 Tool，也可以通过 OpenAPI 规范文件批量导入。每个 Tool 需要定义工具名称、描述、入参结构，以及对应的后端调用信息。

第 5 步：查看调用方式

在服务详情页可以看到供智能体使用的配置模板，可直接复制。网关的接入路径是固定的：

/mcpservers/<MCP 服务名称>/mcp

三、路径二：通过 API 创建 MCP 服务

这一节和上一节的区别只在“怎么创建”：控制台适合少量、边配边看，接口适合脚本化与重复执行；至于选哪种服务模式，仍按上一节的判断来。当需要一次创建多个 MCP 服务时，走控制台逐个点击效率不高，可以改用云 API 的 CreateCloudNativeAPIGatewayMCPServer 接口逐个创建。

下面的示例使用“虚拟 MCP Server”模式——把多个后端接口聚合为一个 MCP Server，与上一节的“域名/IP”模式不同，可按实际场景选择。示例请求：

{
    "GatewayId": "gateway-27268511",
    "Name": "test-virtual-mcp-2",
    "DisplayName": "虚拟MCP",
    "ServerType": "Rest2MCP",
    "Transport": "StreamableHttp",
    "UpstreamType": "VirtualMCPServer",
    "Timeout": 3000,
    "RetryCount": 3,
    "Description": "虚拟MCP服务",
    "EnableHealthCheck": false
}

关键参数说明：

调用成功后，返回结果中会给出新建服务的 ID，可在控制台的服务列表中查看与核对。不过接口只负责创建服务本身；如果创建的是 HTTP 转 MCP 服务，还需要回到服务详情页的“Tools 管理”页签补充工具定义，做法与上一节的第 4 步相同。

需要注意，同一个参数在控制台与接口中的取值范围或可选值表述可能不一致，落地时以控制台实际显示为准。

四、把 MCP 服务接入智能体客户端

服务创建好之后，需要把它接到智能体一侧。在服务详情页复制配置模板，粘贴到支持 MCP 的客户端配置中：

{
  "mcpServers": {
    "<MCP 服务名称>": {
      "url": "http://<网关 IP>/mcpservers/<MCP 服务名称>/mcp"
    }
  },
  "transportType": "streamable-http"
}

如果需要从公网调用，可以在网关实例的“基础信息 > 网络配置”中开启公网负载均衡，开启后调用方式区会同步展示公网接入地址。

五、为 MCP 服务加上鉴权与访问控制

服务能调通之后，不要急着上线，先把权限收口。在服务详情页的“访问控制”页签中，可以启用调用方鉴权：

需要注意的是，单个 MCP Server 仅支持配置一种鉴权方式；切换鉴权方式后，需要为调用方重新下发对应类型的凭证。

在此之上，还可以配置两级黑白名单：

• 服务级（Server）访问控制：选择全部开放、白名单或黑名单，决定哪些调用方可以访问整个 MCP Server；
• 工具级（Tool）访问控制：在服务级规则基础上进一步收敛，决定哪些调用方可以调用某个具体工具。只有当服务级设置为“全部开放”时，工具级才可以使用自定义权限。

六、验证与排障

上线前建议完成三项验证。

1. 连通性验证：用配置好的客户端发起一次工具调用，确认能正常拿到结果。更贴近真实场景的做法是，在客户端里直接用自然语言描述一个任务，观察它是否会自动选中并调用这个工具——这一步最能验证“存量系统已经接进智能体”。失败时先检查网关到后端的网络与端口是否可达。
2. 鉴权验证：确认未携带凭证的请求会被拦截，携带错误凭证时返回鉴权失败。
3. 日志核对：在网关实例的“数据观测”中选择“日志大盘 > MCP 监控”，可按时间范围与关键字检索 MCP 调用记录。MCP 访问日志包含以 aigw.mcp.* 为前缀的专用字段，涵盖工具名称、会话标识、调用结果等，便于精细化分析。

常见问题速查：

结语

把存量系统接进智能体，关键不是重写接口，而是找到一条“少改代码、可控可治理”的路径：用网关完成协议转换，用工具管理沉淀能力，用鉴权和黑白名单收口风险。

如果你希望把这套流程在自己环境里跑通，可以从腾讯云的 Agent 网关服务开始了解：https://cloud.tencent.com/product/agw