CreateMcpService - 创建MCP服务
创建 MCP 服务
接口说明
创建 MCP 服务
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /digitalEmployee/{name}/mcpService HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| name |
string |
是 |
数字员工名称。 |
test-agent |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求体参数。 |
|
| mcpServiceName |
string |
是 |
MCP 服务名称。 |
log-query |
| displayName |
string |
否 |
MCP 服务显示名称。 |
日志查询 |
| description |
string |
否 |
MCP 服务描述信息。 |
通过 MCP 调用日志查询工具。 |
| enable |
boolean |
是 |
是否启用 MCP 服务。 |
true |
| network |
object |
是 |
请求体参数。 |
|
| mode |
string |
是 |
MCP 服务网络访问模式，支持 public 和 vpc。 |
public |
| vpcId |
string |
否 |
专有网络 VPC ID。 |
vpc-xxx |
| vswId |
string |
否 |
交换机 ID。 |
vsw-xxx |
| accessIp |
string |
否 |
VPC 网络下访问 MCP 服务的 IP 地址。 |
10.0.0.12 |
| accessPort |
integer |
否 |
VPC 网络下访问 MCP 服务的端口，取值范围为 1 到 65535。 |
8080 |
| securityGroupId |
string |
否 |
安全组 ID。 |
sg-xxx |
| gatewayId |
string |
否 |
网关 ID。 |
gw-xxx |
| mcpServerId |
string |
否 |
MCP Server 实例 ID。 |
mcp-xxx |
| region |
string |
否 |
VPC 网络所在地域。 |
cn-hangzhou |
| connection |
object |
是 |
请求体参数。 |
|
| platform |
string |
是 |
MCP 服务平台类型，支持 AIGateway 和 Custom。 枚举值：
|
Custom |
| transport |
string |
是 |
MCP 服务传输协议，支持 http 和 sse。 |
http |
| endpoint |
string |
是 |
MCP 服务访问地址。 |
https://example.com/mcp |
| timeout |
integer |
否 |
请求 MCP 服务的超时时间，单位为毫秒。 |
5000 |
| auth |
object |
否 |
请求体参数。 |
|
| type |
string |
否 |
认证类型，目前支持 bearer。 |
bearer |
| keyInfo |
object |
否 |
请求体参数。 |
{"token":"example-token"} |
|
string |
否 |
认证键值信息。 |
example-token |
|
| tools |
array<object> |
是 |
MCP 工具列表。 |
[{"name":"query_logs"}] |
|
array<object> |
否 |
请求体参数。 |
[{"name":"query_logs"}] |
|
| name |
string |
是 |
MCP 工具名称。 |
query_logs |
| title |
string |
否 |
MCP 工具标题。 |
查询日志 |
| displayName |
string |
否 |
MCP 工具显示名称。 |
日志查询工具 |
| description |
string |
否 |
MCP 工具描述信息。 |
查询指定日志库中的日志。 |
| inputSchema |
object |
是 |
请求体参数。 |
{"type":"object","properties":{"query":{"type":"string"}},"required":["query"]} |
|
any |
否 |
MCP 工具输入 Schema 扩展字段。 |
{"type":"string"} |
|
| outputSchema |
object |
否 |
请求体参数。 |
{"type":"object"} |
|
any |
否 |
MCP 工具输出 Schema 扩展字段。 |
{"type":"string"} |
|
| icons |
array<object> |
否 |
MCP 工具图标列表。 |
[] |
|
object |
否 |
请求体参数。 |
[] |
|
|
any |
否 |
工具图标扩展字段。 |
https://example.com/icon.png |
|
| execution |
object |
否 |
请求体参数。 |
{} |
|
any |
否 |
工具执行配置扩展字段。 |
{} |
|
| annotations |
object |
否 |
请求体参数。 |
{} |
|
any |
否 |
工具注解扩展字段。 |
{} |
|
| enable |
boolean |
否 |
是否启用该 MCP 工具。 |
true |
| confirm |
boolean |
否 |
调用该 MCP 工具前是否需要用户确认。 |
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
接口返回数据。 |
||
| requestId |
string |
请求 ID。 |
0B9377D9-C56B-5C2E-A8A4-************ |
| mcpServiceName |
string |
MCP 服务名称。 |
log-query |
示例
正常返回示例
JSON格式
{
"requestId": "0B9377D9-C56B-5C2E-A8A4-************",
"mcpServiceName": "log-query"
}