创建 MCP 服务器
在账户下注册新的 MCP 服务器(连接器)。
限制说明
使用说明
command/args/env用于stdio;url/headers用于sse/streamable-http。- 服务器名称必须以字母开头,且只能包含字母、数字、
-或_,在账户内不区分大小写唯一;不满足则返回 InvalidParameter。 environment_kind仅支持byoc(需同时提供environment_id)或留空表示自动选择——MCP 服务器不支持直接绑定cloud。per_user_secret认证模式要求secret_schema为合法 JSON 且包含非空的header_name。- 每次调用都会记录到账户审计日志。
授权
App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.
请求体
新建 MCP 服务器的配置。
MCP 服务器名称,在账户内唯一。
1 - 255服务器描述。
1 - 1024传输协议。
stdio, sse, streamable-http 可执行命令(stdio 传输)。
命令参数(stdio 传输)。
环境变量(stdio 传输)。
服务器 URL(sse / streamable-http 传输)。
HTTP 头(sse / streamable-http)。
连接超时,单位秒。0 表示默认(10 秒)。
工具调用超时,单位秒。0 表示默认(60 秒)。
认证模式:shared(默认)、per_user_secret 或 per_user_oauth。
JSON 密钥 schema;auth_mode=per_user_secret 时必填。
JSON OAuth 元数据;为 per_user_oauth 预留。
初始状态。
enabled, disabled 团队范围:0 表示账户级;>0 表示团队。
绑定到指定 BYOC 运行器(需同时提供 environment_id)。省略或留空表示自动选择;MCP 服务器不支持 cloud。
byoc 运行器 ID;environment_kind 为 byoc 时必填。
允许该服务器的 OAuth 令牌交换使用明文 HTTP,仅用于测试,默认 false。
连接该服务器时跳过 TLS 证书校验,仅用于测试,默认 false。
从连接器模板创建时的市场模板名称。
响应
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.