重新整理 MCP 工具列表

支援重新拉取指定 MCP Server 的 tools 並更新 actions。

可以透過該 API，重新拉取指定 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	伺服器錯誤