สร้าง 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 | ข้อผิดพลาดของเซิร์ฟเวอร์ |
