转写说明

本文基于已校验的公开原文进行结构化转写与事实梳理，非原文转载。 转写保留可核验的技术事实，并将工程建议与来源观点明确分开。

核心结论

AgentKit MCP 网关提供 HTTP 转 MCP 和导入已有 MCP 服务两种接入方式，支持将存量系统 API 零改造转为标准 MCP 服务，并通过 MCP 工具集实现多服务编排与语义检索调用。

能力机制

AgentKit 是火山引擎面向企业提供的 AI Agent 基础设施平台，涵盖运行时、身份权限、工具、记忆、知识和观测等能力模块。

MCP 网关作为其中核心组件，具备以下接入方式：

HTTP 转 MCP：将存量系统 API 转换为标准 MCP 服务，支持上传 Swagger 或 OpenAPI Schema JSON 文件完成自动转换。存量 API 文件可借助 AI 工具进行格式转化。

导入 MCP 服务：支持纳管已有的 MCP 服务，可通过固定域名、容器服务、云服务器、函数服务等方式接入。来源中以 GitHub MCP 为例演示了导入流程。

部署 MCP 服务：支持部署自研或公开的 MCP 服务，同时可将 Local MCP 转换为 Remote MCP。

MCP 工具集支持将多个 MCP 服务进行编排组合，提供三种调用模式：全量返回直接输出所有工具；语义检索基于工具描述与调用意图进行语义匹配；标签检索通过工具标签进行精准筛选。

认证方面支持 API Key 和 OAuth JWT 两种入站身份认证方式。

快速开始

前期准备

在 AgentKit 控制台开通服务；准备存量系统的 OpenAPI Schema JSON 文件和后端服务域名；导入场景需准备目标 MCP 服务的域名和 API Key。

HTTP 转 MCP 操作流程

在 AgentKit 控制台进入【网关 - MCP】页面，点击【创建 MCP】服务，选择共享网关或专属网关（生产环境需提前创建专属网关实例）。基本信息配置选择接入方式为“HTTP 转 MCP”，上传 OpenAPI Schema JSON 文件。认证信息配置选择 API Key 或 OAuth JWT 方式。OAuth 方式需提前创建用户池和客户端。配置存量服务的后端域名，支持函数服务、云服务器、固定域名等类型。完成后获取调用代码进行验证。

导入已有 MCP 服务流程

创建 MCP 服务时选择“导入 MCP 服务”，访问路径填“/mcp”。后端配置选择固定域名并输入目标服务地址。出站凭据配置选择 API Key 认证方式，设置参数位置为 Header、参数名称为 Authorization、Prefix 为 Bearer。创建完成后获取调用代码。

创建 MCP 工具集

在【网关 - MCP - MCP 工具集】点击【创建 MCP 工具集】，选择共享模式。在工具管理中配置调用模式，可选择全量返回、语义检索或标签检索。从已创建的 MCP 服务中选择需要纳入工具集的工具，确认后完成创建。通过【调用示例】可将工具集配置到 Trae 等工具中使用。工具集支持在线调试功能，可在控制台验证语义检索效果。

适用边界

共享网关适用于 POC 或低流量验证场景，专属网关适用于生产环境并需提前创建网关实例。

首次选择共享网关模式创建 MCP 服务时，系统会自动下单共享网关。

工具集语义检索模式下，实际效果受大模型能力、网络状况等因素影响可能存在波动，需以实际运行结果为准。

该方案适用于存量系统数量较多、接口改造成本高的企业场景，可快速实现存量能力的标准化接入与统一纳管。

核验清单

服务开通：确认 AgentKit 服务已开通并可访问控制台

接入方式：根据存量系统情况选择 HTTP 转 MCP 或导入已有 MCP 服务

文件准备：HTTP 转 MCP 场景需准备符合规范的 OpenAPI Schema JSON 文件

认证配置：确认入站认证方式（API Key 或 OAuth JWT），OAuth 场景需提前完成用户池和客户端创建

后端配置：确认存量服务域名或目标 MCP 服务地址可正常访问

工具集编排：根据业务需求选择合适的调用模式（建议生产环境评估语义检索模式）

调用验证：使用控制台提供的监控和调试功能验证服务可用性

配置同步：按调用示例将服务配置到实际使用的 Agent 工具中

来源与核验

  • 原始文章
  • 页面事实以原始来源及其引用的官方资料为准；版本、星标和模型能力会随时间变化。
  • AI Stack 不公开抓取到的全文快照，只发布独立转写与来源入口。

站内链接

相关文章