เอกสารอ้างอิง API: MCP

เซิร์ฟเวอร์ MCP ช่วยให้ผู้ช่วย AI โต้ตอบกับ ProcessMind ผ่าน Model Context Protocol โดยใช้ JSON-RPC 2.0 ผ่าน Streamable HTTP: ส่ง initialize แล้วส่ง tools/list เพื่อดูรายการเครื่องมือ เครื่องมืออ่าน เช่น list_processes จะแสดงเฉพาะเมื่อคีย์ API มี scope สำหรับอ่าน ส่วนเครื่องมือเขียนต้องใช้ scope สำหรับเขียน ใช้ tools/call เพื่อเรียกใช้เครื่องมือพร้อมอาร์กิวเมนต์ เครื่องมือหน่วยความจำ (remember, recall, forget) ใช้จัดเก็บข้อมูลข้ามเซสชันได้ ส่วนการสร้างด้วย AI ที่ใช้เวลานานจะติดตามแยกตามการเรียกใช้เครื่องมือ โดยแนบการอ้างอิงงานใน _meta["io.modelcontextprotocol/related-task"] แล้ว ProcessMind จะแจ้งสถานะของงานนั้นกลับมาพร้อมผลการเรียกใช้ ส่วนเมธอดส่วนขยาย tasks/list, tasks/get และ tasks/cancel ไม่รองรับ.

ปลายทางเซิร์ฟเวอร์ Model Context Protocol (JSON-RPC ผ่าน Streamable HTTP)

JSON-RPC 2.0 ผ่าน Streamable HTTP: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list เครื่องมืออ่านต้องใช้ scope read ของคีย์ ส่วนเครื่องมือเขียนต้องใช้ scope write รายการเครื่องมือมีอธิบายไว้ในคู่มือ MCP ยืนยันตัวตนด้วย x-api-key หรือ Authorization: Bearer <token> (โทเค็นจาก OAuth token endpoint).

ปลายทาง: POST /v1/mcp/{tenantId}

การยืนยันตัวตน: API key ที่กำหนดขอบเขตตาม tenant · scope read · จำกัดอัตรา 20 req/s (สูงสุดชั่วขณะ 40)

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: uuid

เนื้อหาคำขอ:

คำขอ MCP JSON-RPC

{}

การตอบกลับ (200):

การตอบกลับ MCP JSON-RPC

{
	"message": "string"
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
message	string	ใช่

ข้อผิดพลาด:

• 401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้งาน หรือหมดอายุ
• 403 API key ไม่มี scope หรือสิทธิ์เข้าถึงองค์กรตามที่กำหนด, tenant ไม่ได้เปิดใช้งาน หรือแพ็กเกจไม่รองรับไฟล์ประเภทนี้

endpoint การอนุญาต OAuth 2.1 (PKCE) เปลี่ยนเส้นทางกลับไปยัง redirect_uri ด้วยรหัส 302 พร้อม ?code=…

ปลายทาง: GET /v1/mcp/{tenantId}/oauth/authorize

การยืนยันตัวตน: สาธารณะ ไม่ต้องใช้ API key · จำกัดอัตรา 10 req/s (สูงสุดชั่วขณะ 20)

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: uuid
client_id	string	query	ใช่
redirect_uri	string	query	ใช่	รูปแบบ: uri
code_challenge	string	query	ใช่
code_challenge_method	S256	query	ไม่	ค่าที่อนุญาต: S256
state	string	query	ไม่

ข้อผิดพลาด:

• 302 เปลี่ยนเส้นทางไปยัง redirect_uri พร้อม code และ state
• 400 คำขอไม่ถูกต้อง เช่น นิพจน์ตัวกรองไม่ถูกต้อง, กระบวนการไม่มีโมเดล, ประเภทไฟล์ที่อัปโหลดไม่รองรับ หรือไม่มีฟิลด์ที่จำเป็น
• 401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้งาน หรือหมดอายุ

OAuth 2.0 token endpoint (client_credentials หรือ authorization_code + PKCE)

ปลายทาง: POST /v1/mcp/{tenantId}/oauth/token

การยืนยันตัวตน: สาธารณะ ไม่ต้องใช้ API key · จำกัดอัตรา 5 req/s (สูงสุดชั่วขณะ 10)

พารามิเตอร์:

ชื่อ	ประเภท	ตำแหน่ง	จำเป็น	คำอธิบาย
tenantId	string	path	ใช่	รูปแบบ: uuid

การตอบกลับ (200):

Access token

{
	"access_token": "string",
	"token_type": "Bearer",
	"expires_in": 0
}

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
access_token	string	ใช่	Bearer JWT อายุสั้นสำหรับ POST /v1/mcp/{tenantId}
token_type	Bearer	ใช่	ค่าที่อนุญาต: Bearer
expires_in	number	ใช่

ข้อผิดพลาด:

• 400 คำขอไม่ถูกต้อง เช่น นิพจน์ตัวกรองไม่ถูกต้อง, กระบวนการไม่มีโมเดล, ประเภทไฟล์ที่อัปโหลดไม่รองรับ หรือไม่มีฟิลด์ที่จำเป็น
• 401 ไม่มี API key, key ไม่ถูกต้อง ถูกปิดใช้งาน หรือหมดอายุ
• 403 API key ไม่มี scope หรือสิทธิ์เข้าถึงองค์กรตามที่กำหนด, tenant ไม่ได้เปิดใช้งาน หรือแพ็กเกจไม่รองรับไฟล์ประเภทนี้