跳转到主要内容
POST
更新 MCP 服务器

限制说明

使用说明

  • 需要对服务器当前所属团队有编辑权限:账户级服务器(team_id=0)仅账户 owner 或管理员可改;团队服务器仅该团队成员可改(owner/管理员也必须是该团队成员)。
  • server_name、description、transport、command、url、auth_mode 仅在非空时修改,connect_timeout / call_timeout 仅在非零时修改,因此无法通过本接口清空这些字段。
  • args、env、headers 传入即整体替换:env/headers 中未传入的键会被删除。对受保护的 env/headers 键,回传脱敏值或空字符串会保留已存储的密钥。
  • 传入 auth_mode 时,secret_schema 会被同一请求中的值覆盖(未传则置空)。auth_mode 或 url 实际发生变化时会清空 oauth_metadata,除非同时传入非空的 oauth_metadata。
  • 改到其他团队(team_id > 0)要求调用者属于目标团队,且从市场安装的服务器不允许改到团队;改为账户级(team_id=0)仅限账户 owner 或管理员。变更团队但未同时传 environments 时,现有 Runner 条目必须对调用者仍可选,否则更新被拒绝。
  • environments:省略(或传 null)表示不变;传入列表即整体替换——空列表表示清除限制、恢复为所有环境。
  • 响应为更新后的服务器。若修改了连接相关字段,会清除工具列表缓存并在后台重新拉取。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

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

请求体

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>

传输协议;切换时应一并提供对应字段(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 传输),省略或为空表示不变。实际变更时,若未传新的 oauth_metadata,会将其清空。

headers
object

HTTP 头(sse / streamable-http 传输);整体替换,掩码/空值保留规则同 env;省略则不修改。

connect_timeout
integer

新的连接超时(秒),省略或为 0 表示不变(存储值为 0 时使用默认 10 秒)。

call_timeout
integer

新的工具调用超时(秒),省略或为 0 表示不变(存储值为 0 时使用默认 60 秒)。

auth_mode
enum<string>

新的认证模式,省略或为空表示不变。凭据由谁提供:

  • 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,例如 {"header_name":"X-Api-Key"}。仅在同时传入非空 auth_mode 时生效,单独传入会被忽略。

oauth_metadata
string

新的 JSON OAuth 元数据。非空值按原样保存。省略或为空时保留原值;若 auth_mode 或 url 发生变化,则清空。

team_id
integer<int64> | null

重新分配团队范围:0 = 账户级(仅账户 owner 或管理员);>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 证书校验。省略表示不变。

响应

成功

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