Skip to main content
POST
更新 MCP 服务器

限制说明

使用说明

  • env/headers 中的脱敏密钥会被保留——回传脱敏值不会覆盖已存储的真实密钥。
  • environments 是三态部分更新字段:省略(null)表示保持不变;传入列表即整体设置——空列表表示清除限制、恢复为所有环境。
  • 变更 team_id 需要对目标团队具有重新分配权限;若 environments 未随之修改,则当前环境列表在新团队下仍须对调用者可选,否则更新会被拒绝。
  • 每次调用都会记录到账户审计日志。

授权

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

目标 MCP 服务器 ID,取自 POST /safari/mcp/server/list 返回的列表。

server_name
string

新名称;省略或留空则不修改。

Required string length: 1 - 255
description
string

新描述;省略或留空则不修改。

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

传输协议;切换时应一并提供对应字段(stdiocommand/args/envsse / streamable-httpurl/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 传输);整体替换,掩码/空值保留规则同 env;省略则不修改。

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 预留。

team_id
integer<int64> | null

重新分配团队范围:0 表示账户级;>0 表示团队。省略则不变。

environments
string[] | null

该服务器可运行的执行环境:cloud 和/或 BYOC Runner 的环境 ID 列表。省略(null)表示保持不变;传入列表即整体设置——空列表表示清除限制、恢复为所有环境。

allow_insecure_oauth_http
boolean | null

是否允许 OAuth 令牌交换使用明文 HTTP。省略表示不变。

allow_insecure_tls_skip_verify
boolean | null

是否跳过 TLS 证书校验。省略表示不变。

响应

成功

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 服务器(连接器)。