สร้าง MCP

สร้าง MCP

รองรับการสร้าง MCP ภายใต้องค์กรที่ระบุ และดึง tools ที่ MCP Server เปิดเผยออกมา

คุณสามารถใช้อินเทอร์เฟซนี้เพื่อสร้าง MCP ภายใต้องค์กรที่ระบุ และดึง tools ที่ MCP Server เปิดเผยออกมา

วิธีการร้องขอ

POST

URL สำหรับร้องขอ

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

การยืนยันตัวตนในการร้องขอ

ใช้การยืนยันตัวตนแบบ Basic ด้วย DevKey / DevSecret ระดับบัญชี และกำหนดให้บัญชีที่เรียกใช้ต้องมีสิทธิ์สร้าง 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"}]
  }'

                    
บล็อกโค้ดนี้ในหน้าต่างลอย

Header สำหรับร้องขอ

ฟิลด์ ประเภท คำอธิบาย
Authorization Basic ${BASIC_TOKEN} Basic Token ที่ได้จากการเข้ารหัส Base64 ของ DevKey:DevSecret
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 URL ไอคอนของ MCP true
url String URL ของ MCP Server ต้องเป็นที่อยู่ http/https บนอินเทอร์เน็ตสาธารณะ true
show_request Boolean จะแสดงเนื้อหาคำขอในระหว่างการเรียกใช้หรือไม่ true
mcp_transport_type String ประเภทการส่งข้อมูลของ MCP รองรับ SSE, STREAMABLE_HTTP true
headers Object[] Header ของคำขอ MCP สูงสุด 10 รายการ แต่ละรายการประกอบด้วย key, value false
queries Object[] พารามิเตอร์ query ของ 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 ID ของ MCP ที่สร้างใหม่
available Boolean MCP ใช้งานได้หรือไม่
action_count Integer จำนวน Action ที่ดึงมาได้

การตอบกลับเมื่อผิดพลาด

ฟิลด์ ประเภท คำอธิบาย
code Integer รหัสข้อผิดพลาด
message String รายละเอียดข้อผิดพลาด

รหัสสถานะ

รหัสสถานะ คำอธิบาย
200 สำเร็จ
400 พารามิเตอร์ไม่ถูกต้อง
401 ไม่ได้รับอนุญาต
403 สิทธิ์ไม่เพียงพอ
429 คำขอถี่เกินไป
500 ข้อผิดพลาดของเซิร์ฟเวอร์