Skip to main content
POST
创建 MCP 服务器

限制说明

使用说明

  • command/args/env 用于 stdiourl/headers 用于 sse/streamable-http
  • 服务器名称必须以字母开头,且只能包含字母、数字、-_,在其作用域(账户范围或单个团队)内不区分大小写唯一;不满足则返回 InvalidParameter。
  • environments 限定服务器可运行的环境:cloud 和/或 BYOC Runner 的环境 ID 列表;省略或为空表示所有环境。
  • 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 通过 command/args/env 启动本地进程,sse / streamable-http 通过 url/headers 连接远程服务。

可用选项:
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 创建后保持停用。

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

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

environments
string[]

该服务器可运行的执行环境:cloud 和/或 BYOC Runner 的环境 ID 列表。省略或为空表示所有环境。

allow_insecure_oauth_http
boolean

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

allow_insecure_tls_skip_verify
boolean

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

source_template_name
string

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

响应

成功

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
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
object

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