跳转到主要内容
POST
创建 MCP 服务器

限制说明

使用说明

  • command/args/env 用于 stdio;url/headers 用于 sse/streamable-http。
  • server_name 必须以字母开头,只能包含字母、数字、- 或 _,且在其作用域(账户级或单个团队)内唯一;违反时返回 InvalidParameter。
  • 未传 source_template_name 时,创建到团队(team_id > 0)要求调用者属于该团队,只有账户 owner 或管理员可以在账户级(team_id=0)创建。
  • 传入 source_template_name 表示安装市场模板:模板必须存在(否则返回 ResourceNotFound),team_id 被忽略、服务器一律建在账户级,且连接字段必须与模板一致,只能填写模板声明的参数值。若模板为按人认证、且其参数允许安装者决定目标主机,则仅账户 owner 或管理员可安装。
  • environments 的每一项必须是 cloud,或某个账户级 BYOC Runner、调用者所属团队的 BYOC Runner 的环境 ID;重复项会被去除,空字符串会被拒绝。省略或为空表示所有环境。
  • per_user_secret 认证模式要求 secret_schema 为合法 JSON 且包含非空的 header_name。
  • env 与 headers 中,键名包含 KEY、SECRET、TOKEN、PASSWORD、PASSWD、CREDENTIAL 或 AUTHORIZATION(不区分大小写)、或含 PWD / PASS 分段的值,以及已加密存储的值,会加密存储并在响应中脱敏。
  • 响应为已保存的服务器。之后服务端会通过已在线的执行环境在后台拉取其工具列表,调用不会等待该过程。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

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 传输)。键名疑似凭据(包含 KEY、SECRET、TOKEN、PASSWORD 等)的值加密存储,响应中脱敏。

url
string

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

headers
object

HTTP 请求头(sse / streamable-http 传输)。键名疑似凭据(包含 KEY、TOKEN、AUTHORIZATION 等)的值加密存储,响应中脱敏。

connect_timeout
integer

连接超时(秒)。省略或为 0 时存为 0,使用默认 10 秒。

call_timeout
integer

工具调用超时(秒)。省略或为 0 时存为 0,使用默认 60 秒。

auth_mode
enum<string>
默认值:shared

凭据由谁提供:

  • shared(默认,空值等同):使用保存在服务器上的一份凭据(env / headers),所有调用者共用。
  • per_user_secret:每位用户各自保存密钥,放在 secret_schema.header_name 指定的请求头中发送。
  • per_user_oauth:每位用户各自完成 OAuth 授权,首次使用时完成发现与客户端注册。

per_user_secret 要求 secret_schema 带非空的 header_name;其他取值返回 InvalidParameter。

可用选项:
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 = 账户级(仅账户 owner 或管理员);>0 = 调用者所属的团队。传入 source_template_name 时忽略,市场安装一律为账户级。

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

要安装的市场模板名称。传入时模板必须存在,服务器建在账户级,且连接字段必须与模板一致,只能填写模板声明的参数值。创建后不可修改。

响应

成功

所有 Flashduty 公开 API 共用的标准响应结构。成功时 data 为接口专属载荷且不含 error;失败时 error 存在而 data 缺失。request_id 始终存在,并会同步写入 Flashcat-Request-Id 响应头。

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

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

data
object

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