การเชื่อมต่อปลั๊กอิน·MCP เซิร์ฟเวอร์
วิธีเชื่อม MCP เซิร์ฟเวอร์ที่คุณสร้างเองเข้ากับ Keural และสร้างแพ็กเกจปลั๊กอินสำหรับแอปเดสก์ท็อป
ปลั๊กอิน ของ Keural คือ MCP (Model Context Protocol) เซิร์ฟเวอร์ เอกสารนี้เป็นข้อกำหนดสำหรับการเชื่อม MCP เซิร์ฟเวอร์เข้ากับ Keural หรือการสร้างแพ็กเกจปลั๊กอินสำหรับแอปเดสก์ท็อป
การส่งข้อมูล (transport)
| แพลตฟอร์ม | การส่งข้อมูลที่เลือกได้ | ใช้ทำอะไร |
|---|---|---|
| เว็บ·มือถือ | HTTP(Streamable HTTP) · SSE | MCP เซิร์ฟเวอร์ระยะไกลที่เข้าถึงได้จากอินเทอร์เน็ต |
| แอปเดสก์ท็อป | STDIO · HTTP | เซิร์ฟเวอร์ที่รันบนเครื่องนี้ และเซิร์ฟเวอร์ HTTP ในเครือข่ายภายใน |
- ในบทสนทนาบนเว็บใช้ได้เฉพาะเซิร์ฟเวอร์ HTTP·SSE ระยะไกล เซิร์ฟเวอร์ STDIO จะรันบนแอปเดสก์ท็อป
- หากที่อยู่เซิร์ฟเวอร์ลงท้ายด้วย
/mcpมักเป็นเซิร์ฟเวอร์ Streamable HTTP จึงเลือกการส่งข้อมูลเป็น HTTP - HTTP บนเดสก์ท็อปใช้กับที่อยู่ในเครือข่ายภายใน ที่อยู่อินเทอร์เน็ตสาธารณะให้ลงทะเบียนด้วย HTTP บนเว็บ
ค่าที่ต้องกรอกเมื่อเพิ่มเอง
ช่องป้อนข้อมูลของ การตั้งค่า → ปลั๊กอิน → ＋ เพิ่ม MCP แบบกำหนดเอง มีดังนี้
| ช่อง | เนื้อหา |
|---|---|
| ชื่อ | จำเป็น |
| คำอธิบาย | ไม่บังคับ |
| การส่งข้อมูล | ดูตารางด้านบน |
| หมวดหมู่ | การจัดกลุ่มในรายการ |
| URL ของเซิร์ฟเวอร์ | จำเป็นเมื่อเป็น HTTP·SSE ตัวอย่าง: https://example.com/mcp |
| คำสั่ง | จำเป็นเมื่อเป็น STDIO ตัวอย่าง: npx |
| อาร์กิวเมนต์ | อาร์กิวเมนต์ STDIO (JSON array) ตัวอย่าง: ["-y", "@scope/server"] |
| ใช้ปลั๊กอินนี้ค้นหาเว็บ | เมื่อเปิด ปลั๊กอินนี้จะถูกใช้แทนการค้นหาเว็บ |
| การยืนยันตัวตน | ไม่ยืนยันตัวตน · API key |
| ชื่อ Header · ค่า API key | เมื่อใช้ API key ตัวอย่าง: ชื่อ Header Authorization ค่า Bearer … |
เมื่อเลือก API key ระบบจะแนบ <ชื่อ header>: <ค่า> เป็นเฮดเดอร์ในทุกคำขอ
เซิร์ฟเวอร์ยืนยันตัวตนด้วย OAuth
ปลั๊กอินที่ผู้ดูแลองค์กรลงทะเบียนด้วยวิธี OAuth ผู้ใช้จะเข้าสู่ระบบโดยกด เชื่อมต่อ
| รายการ | ค่า |
|---|---|
| การค้นหาเซิร์ฟเวอร์ | /.well-known/oauth-protected-resource (มีพาธ → ราก) จากนั้น /.well-known/oauth-authorization-server |
| การลงทะเบียนไคลเอนต์ | Dynamic Client Registration (DCR) |
| Redirect URI | https://api.keural.ai/api/user-connectors/oauth/callback |
| Header ของคำขอ | Authorization: Bearer <access token> |
หน้าต่างเข้าสู่ระบบจะเปิดเป็นป๊อปอัป และรายการปลั๊กอินจะรีเฟรชเมื่อเข้าสู่ระบบเสร็จ
สิทธิ์ของเครื่องมือ
กำหนดวิธีการทำงานของเครื่องมือแต่ละตัวในปลั๊กอิน
| สิทธิ์ | การทำงาน |
|---|---|
| อนุญาตเสมอ | ทำงานโดยไม่ต้องยืนยัน |
| ถามทุกครั้ง | แสดงการ์ดอนุมัติก่อนทำงาน การ์ดจะแสดงอาร์กิวเมนต์ของเครื่องมือด้วย |
| บล็อก | เอเจนต์จะไม่ใช้เครื่องมือนี้ |
แพ็กเกจปลั๊กอินสำหรับเดสก์ท็อป
แอปเดสก์ท็อปติดตั้งปลั๊กอินผ่าน ไฟล์ ZIP ของปลั๊กอิน… หรือ โฟลเดอร์ปลั๊กอิน… แพ็กเกจต้องมีไฟล์ manifest ชื่อ plugin.json
{
"id": "my-plugin",
"name": "My Plugin",
"version": "1.0.0",
"description": "ค้นหาข้อมูลในระบบภายในองค์กร",
"mcpServers": {
"my-server": {
"command": "node",
"args": ["server.js"],
"env": { "API_BASE": "https://intranet.example.com" }
}
}
}| ฟิลด์ | จำเป็น | เนื้อหา |
|---|---|---|
id | ใช่ | ตัวอักษรภาษาอังกฤษตัวพิมพ์เล็ก ตัวเลข และขีดกลาง |
name | ไม่ | ชื่อที่แสดง หากไม่มีจะใช้ id |
version | ไม่ | ค่าเริ่มต้น 1.0.0 |
description | ไม่ | คำอธิบาย |
minAppVersion | ไม่ | เวอร์ชันแอปขั้นต่ำที่ต้องใช้ |
mcpServers | ไม่ | นิยาม MCP เซิร์ฟเวอร์ แต่ละเซิร์ฟเวอร์มี command, args, env |
requests | ไม่ | สิทธิ์ที่ขอ (capabilities, commands, connectors, secrets, permissions) เป็นอาร์เรย์ของสตริง |
ปลั๊กอิน STDIO ที่ลงทะเบียนบนเว็บ ให้ติดตั้งในแอปเดสก์ท็อปด้วย ติดตั้งบนเครื่องนี้ หลังติดตั้งแล้ว ให้กรอกโทเคนการยืนยันตัวตนและตัวแปรสภาพแวดล้อมเอง