Skip to main content
POST
创建 MCP 服务器

限制说明

使用说明

  • command/args/env 用于 stdiourl/headers 用于 sse/streamable-http
  • 服务器名称必须以字母开头,且只能包含字母、数字、-_,在账户内不区分大小写唯一;不满足则返回 InvalidParameter。
  • environment_kind 仅支持 byoc(需同时提供 environment_id)或留空表示自动选择——MCP 服务器不支持直接绑定 cloud
  • per_user_secret 认证模式要求 secret_schema 为合法 JSON 且包含非空的 header_name
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

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.

请求体

application/json

新建 MCP 服务器的配置。

server_name
string
必填

MCP 服务器名称,在账户内唯一。

Required string length: 1 - 255
description
string
必填

服务器描述。

Required string length: 1 - 1024
transport
enum<string>
必填

传输协议。

可用选项:
stdio,
sse,
streamable-http
command
string

可执行命令(stdio 传输)。

args
string[]

命令参数(stdio 传输)。

env
object

环境变量(stdio 传输)。

url
string

服务器 URL(sse / streamable-http 传输)。

headers
object

HTTP 头(sse / streamable-http)。

connect_timeout
integer

连接超时,单位秒。0 表示默认(10 秒)。

call_timeout
integer

工具调用超时,单位秒。0 表示默认(60 秒)。

auth_mode
string

认证模式:shared(默认)、per_user_secret 或 per_user_oauth。

secret_schema
string

JSON 密钥 schema;auth_mode=per_user_secret 时必填。

oauth_metadata
string

JSON OAuth 元数据;为 per_user_oauth 预留。

status
enum<string>
默认值:enabled

初始状态。

可用选项:
enabled,
disabled
team_id
integer<int64>

团队范围:0 表示账户级;>0 表示团队。

environment_kind
enum<string>

绑定到指定 BYOC 运行器(需同时提供 environment_id)。省略或留空表示自动选择;MCP 服务器不支持 cloud。

可用选项:
byoc
environment_id
string

运行器 ID;environment_kind 为 byoc 时必填。

allow_insecure_oauth_http
boolean

允许该服务器的 OAuth 令牌交换使用明文 HTTP,仅用于测试,默认 false。

allow_insecure_tls_skip_verify
boolean

连接该服务器时跳过 TLS 证书校验,仅用于测试,默认 false。

source_template_name
string

从连接器模板创建时的市场模板名称。

响应

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.

request_id
string
必填

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
object

账户下注册的 MCP 服务器(连接器)。