刷新 MCP 工具列表

支持重新拉取指定 MCP Server 的 tools 并更新 actions。

可以通过该接口，重新拉取指定 MCP Server 的 tools 并更新 actions。

请求方式

POST

调用地址

https://api.${endpoint}/v1/org/mcp/refresh

调用验证

使用账号级 DevKey / DevSecret 的 Basic 鉴权，并要求调用账号具备组织 MCP 管理权限。

请求

请求示例

curl -X POST 'https://api.${endpoint}/v1/org/mcp/refresh' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "id": "mcp-xxxx" }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/mcp/refresh' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "id": "mcp-xxxx"
  }'

此代码块在浮窗中显示

请求头

字段	类型	说明
Authorization	Basic ${BASIC_TOKEN}	使用 `DevKey:DevSecret` Base64 后的 Basic Token。
Content-Type	application/json	请求体格式。

请求参数（Body Parameters）

参数	类型	说明	required
org_id	String	组织 ID。	true
id	String	MCP ID。	true

响应

响应示例

{ "code": 0, "message": "OK", "data": { "mcp_id": "mcp-xxxx", "action_count": 3, "available": true } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "mcp_id": "mcp-xxxx",
    "action_count": 3,
    "available": true
  }
}

此代码块在浮窗中显示

成功响应

字段	类型	说明
mcp_id	String	MCP ID。
action_count	Integer	刷新后的 Action 数量。
available	Boolean	MCP 是否可用。

失败响应

字段	类型	说明
code	Integer	错误码。
message	String	错误详情。

状态码

状态码	说明
200	成功
400	参数错误
401	未授权
403	权限不足
429	请求过于频繁
500	服务器错误