创建一个模型上下文协议（MCP）服务器。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
apig:CreateMcpServer |
none |
*全部资源
|
无 | 无 |
请求语法
POST /v1/mcp-servers HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求参数。 |
|
| gatewayId |
string |
是 |
网关 ID。 |
gw-cq7l5s5lhtgi6qac0 |
| name |
string |
是 |
|
fetch-time |
| description |
string |
否 |
MCP Server 描述信息 |
mcp tool fetch time |
| type |
string |
是 |
类型。 RealMCP: 普通 MCP 服务 枚举值：
|
RealMCP |
| domainIds |
array |
否 |
域名 ID。 |
|
|
string |
否 |
域名 ID。 |
d-cr62ts5lhtglnu*** |
|
| match | HttpRouteMatch |
否 |
路由 Match 规则。 |
|
| backendConfig |
object |
否 |
路由的后端服务配置。 |
|
| scene |
string |
否 |
后端服务场景。 |
SingleService |
| services |
array<object> |
否 |
后端服务。 |
|
|
object |
否 |
后端服务。 |
||
| protocol |
string |
否 |
服务协议：
|
HTTP |
| port |
integer |
否 |
服务的后端节点端口。 |
8080 |
| weight |
integer |
否 |
权重 |
49 |
| serviceId |
string |
否 |
服务 ID。 |
svc-crbgq0dlhtgr*** |
| version |
string |
否 |
服务版本。 |
2.1.6 |
| protocol |
string |
否 |
协议类型，可选值：HTTP、HTTPS、SSE、StreamableHTTP 枚举值：
|
HTTP |
| exposedUriPath |
string |
否 |
暴露的 URI 路径，当 protocol 为 SSE 或 StreamableHTTP 且 type 为 RealMCP 时必填 |
/sse |
| assembledSources |
array<object> |
否 |
组装源列表，当 type 为 AssemblyMCP 时必填 |
|
|
object |
否 |
参数 |
||
| mcpServerName |
string |
否 |
MCP Server 名称 |
test-mcp |
| mcpServerId |
string |
否 |
MCP Server ID |
mcp-sdfa3qgavz |
| tools |
array |
否 |
MCP 工具列表 |
|
|
string |
否 |
MCP 工具信息 |
tool1 |
|
| mcpStatisticsEnable |
boolean |
否 |
是否启用 MCP 可观测，默认 false |
false |
| createFromType |
string |
否 |
创建来源类型 ApiGatewayHttpToMCP 网关托管 HTTP 转 MCP ApiGatewayProxyMcpHosting 网关托管 MCP 直接代理 ApiGatewayAssembly 网关 MCP 组装 NacosHttpToMCP 网关托管 NACOS 同步 HTTP 转 MCP NacosMcpHosting 网关托管 NACOS 同步 MCP 直接代理 枚举值：
|
ApiGatewayMcpHosting |
| grayMcpServerConfigs |
array<object> |
否 |
灰度路由配置 |
|
|
array<object> |
否 |
参数 |
||
| routeId |
string |
否 |
路由 ID |
gray-route-123 |
| match | HttpRouteMatch |
否 |
路由匹配规则 |
|
| backendConfig |
object |
否 |
后端配置 |
|
| scene |
string |
否 |
后端场景 枚举值：
|
SingleService |
| services |
array<object> |
否 |
后端服务 |
|
|
object |
否 |
参数 |
||
| protocol |
string |
否 |
服务协议 |
HTTP |
| port |
integer |
否 |
服务端口 |
8080 |
| weight |
integer |
否 |
服务权重 |
100 |
| serviceId |
string |
否 |
服务 ID |
svc-gray |
| version |
string |
否 |
服务版本 |
v2.0.0 |
| mcpServerConfig |
object |
否 |
HTTP 转 MCP Config |
|
| swaggerConfig |
string |
否 |
HTTP 转 MCP 的 swagger 文档，需符合 3.0 规范 |
swagger.yaml |
| mcpServerSpec |
string |
否 |
MCP Server Config 配置，与 swaggerConfig 配置互斥 |
mcp-spec.yaml |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
Id of the request |
464F9EA0-1052-51BD-8187-D292AA2D8D24 |
| code |
string |
响应状态码。 |
Ok |
| message |
string |
响应消息。 |
success |
| data |
object |
响应数据。 |
|
| mcpServerId |
string |
MCP Server ID |
mcp-afegaijoijaoji24a |
| name |
string |
MCP Server 名称 |
test-mcp |
示例
正常返回示例
JSON格式
{
"requestId": "464F9EA0-1052-51BD-8187-D292AA2D8D24",
"code": "Ok",
"message": "success",
"data": {
"mcpServerId": "mcp-afegaijoijaoji24a",
"name": "test-mcp"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。