建立 MCP

支援在指定組織下建立 MCP，並拉取 MCP Server 公開的 tools。

可以透過該 API，在指定組織下建立 MCP，並拉取 MCP Server 公開的 tools。

請求方式

POST

調用地址

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

調用驗證

使用帳號級 DevKey / DevSecret 的 Basic 驗證，並要求調用帳號具備組織 MCP 建立權限。

請求

請求範例

curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -H 'Content-Type: application/json' \ -d '{ "org_id": "p-xxxx", "name": "crm-mcp", "display_name": "CRM MCP", "description": "CRM MCP server", "logo": "https://cdn.example.com/mcp.png", "url": "https://mcp.example.com/sse", "show_request": true, "mcp_transport_type": "SSE", "headers": [{"key": "Authorization", "value": "Bearer token"}], "queries": [{"key": "tenant", "value": "demo"}] }'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/mcp/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{
    "org_id": "p-xxxx",
    "name": "crm-mcp",
    "display_name": "CRM MCP",
    "description": "CRM MCP server",
    "logo": "https://cdn.example.com/mcp.png",
    "url": "https://mcp.example.com/sse",
    "show_request": true,
    "mcp_transport_type": "SSE",
    "headers": [{"key": "Authorization", "value": "Bearer token"}],
    "queries": [{"key": "tenant", "value": "demo"}]
  }'

此代碼塊在浮窗中顯示

請求標頭

欄位	類型	說明
Authorization	Basic ${BASIC_TOKEN}	使用 `DevKey:DevSecret` Base64 後的 Basic Token。
Content-Type	application/json	請求內容格式。

請求參數（Body Parameters）

參數	類型	說明	required
org_id	String	組織 ID。	true
name	String	MCP 名稱，最多 20 個字元。	true
display_name	String	MCP 顯示名稱，最多 50 個字元。	false
description	String	MCP 描述，最多 100 個字元。	true
logo	String	MCP 圖示 URL。	true
url	String	MCP Server URL，必須為公網 `http/https` 地址。	true
show_request	Boolean	是否在調用過程中顯示請求內容。	true
mcp_transport_type	String	MCP 傳輸類型，支援 `SSE`、`STREAMABLE_HTTP`。	true
headers	Object[]	MCP 請求標頭，最多 10 筆；每項包含 `key`、`value`。	false
queries	Object[]	MCP 查詢參數，最多 30 筆；每項包含 `key`、`value`。	false

回應

回應範例

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

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

此代碼塊在浮窗中顯示

成功回應

欄位	類型	說明
mcp_id	String	新建立的 MCP ID。
available	Boolean	MCP 是否可用。
action_count	Integer	拉取到的 Action 數量。

失敗回應

欄位	類型	說明
code	Integer	錯誤碼。
message	String	錯誤詳情。

狀態碼

狀態碼	說明
200	成功
400	參數錯誤
401	未授權
403	權限不足
429	請求過於頻繁
500	伺服器錯誤