SimplyBoost MCP

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

คืออะไร

เซิร์ฟเวอร์ MCP อยู่ที่ https://get-api.simplyboost.io/api/v1/mcp ใช้การขนส่งแบบ Streamable HTTP และใช้โทเค็น API เดียวกับ REST API (Authorization: Bearer sb_live_…) รวมถึงแพ็กเกจเดียวกัน (Growth, Pro และ Enterprise) สิทธิ์เดียวกัน และขีดจำกัดเดียวกัน เครื่องมือแต่ละรายการทำงานเหมือนกับ REST endpoint ที่ตรงกันและต้องใช้ scope เดียวกัน ผู้ช่วยจะเห็นเครื่องมือที่ตนไม่มีสิทธิ์ใช้เป็นการปฏิเสธอย่างชัดเจน ไม่ใช่ข้อผิดพลาด

เซิร์ฟเวอร์นี้ไม่มีสถานะ: การเรียกแต่ละครั้งเป็นคำขอหนึ่งรายการและคำตอบหนึ่งรายการ โดยไม่ต้องเก็บเซสชันไว้ คุณจึงเชื่อมต่อจากเครื่องใดก็ได้ เซิร์ฟเวอร์จะไม่เริ่มสตรีมเอง

เชื่อมต่อไคลเอนต์

มีสองวิธี ลงชื่อเข้าใช้ (OAuth): เพิ่มที่อยู่ของเซิร์ฟเวอร์ แล้วเมื่อไคลเอนต์แจ้ง ให้ยืนยันในแท็บ SimplyBoost ในฐานะเจ้าของทีม โดยเลือกทีม สิทธิ์ และแชตบอต วิธีนี้ใช้เชื่อมต่อกับตัวเชื่อมต่อของ claude.ai และ ChatGPT, Cursor, Codex และ Claude Code โดยไม่ต้องวางอะไรเลย ใช้โทเค็น: สำหรับไคลเอนต์ที่คุณกำหนดค่าด้วยตนเองหรือสคริปต์ของคุณ ให้สร้างโทเค็นใน Settings → API โดยกำหนดเฉพาะสิทธิ์ที่ผู้ช่วยต้องใช้ แล้วส่งโทเค็นเป็นส่วนหัว

Claude Code (ลงชื่อเข้าใช้เมื่อระบบถาม)

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor, Windsurf, VS Code และไคลเอนต์อื่นที่ใช้ mcp.json (ลงชื่อเข้าใช้เมื่อระบบถาม)

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

แบบเดียวกัน แต่ใช้โทเค็นแทนการลงชื่อเข้าใช้

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

การเชื่อมต่อที่ลงชื่อเข้าใช้จะใช้งานได้นาน 90 วัน ได้รับเฉพาะสิทธิ์ที่เจ้าของเลือกไว้ (การลบจะปิดไว้ เว้นแต่จะเลือกเปิด) และแสดงอยู่ใน Settings → API → Connected apps ซึ่งเจ้าของสามารถยกเลิกการเชื่อมต่อได้ทุกเมื่อ เฉพาะเจ้าของทีมเท่านั้นที่ยืนยันการเชื่อมต่อได้ เช่นเดียวกับกฎการสร้างโทเค็น ชื่อแอปบนหน้าจอยืนยันเป็นชื่อที่แอปแจ้งไว้เอง SimplyBoost ไม่ได้ตรวจสอบชื่อนี้

โทเค็นในไฟล์กำหนดค่าของไคลเอนต์เปรียบเสมือนรหัสผ่านเข้าบัญชีของคุณ เก็บไว้ในคอมพิวเตอร์ของคุณเอง กำหนดวันหมดอายุ และเปลี่ยนโทเค็นหากมีการแชร์ไฟล์กำหนดค่า การลงชื่อเข้าใช้ช่วยหลีกเลี่ยงปัญหานี้ เพราะไม่มีการเขียนข้อมูลลับลงในไฟล์

สำหรับนักพัฒนาไคลเอนต์: เซิร์ฟเวอร์ทำตามข้อกำหนดการให้สิทธิ์ของ MCP คำขอที่ไม่มีข้อมูลรับรองจะตอบกลับเป็น 401 พร้อมส่วนหัว WWW-Authenticate ที่ระบุข้อมูลเมตาของทรัพยากรที่ได้รับการปกป้อง (https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp) ซึ่งระบุเซิร์ฟเวอร์การให้สิทธิ์ (https://get-api.simplyboost.io/.well-known/oauth-authorization-server) ไคลเอนต์ลงทะเบียนด้วยตนเอง (Dynamic Client Registration) ใช้ขั้นตอนการให้สิทธิ์แบบ authorization code พร้อม PKCE (รองรับเฉพาะ S256) ระบุทรัพยากรได้ และได้รับ refresh token ที่หมุนเวียนได้ Access token มีอายุหนึ่งชั่วโมงและใช้ได้เฉพาะกับ MCP endpoint เท่านั้น ส่วน REST endpoint ต้องใช้ API token

เครื่องมือ

อาร์กิวเมนต์และผลลัพธ์ใช้ชื่อเดียวกับ REST API (chatbotId, threadId, ฟิลด์ camelCase) ดังนั้นหน้า endpoint จึงอธิบายทั้งสองแบบ เริ่มด้วย list_chatbots เพื่อค้นหา ID ของแชตบอต

เครื่องมือ	ต้องใช้	ทำอะไร
get_account	ไม่มี	บัญชี แพ็กเกจ และสิทธิ์ของโทเค็นเอง
get_usage	account:read	จำนวนข้อความที่ใช้ไปในรอบบิลนี้
list_chatbots, get_chatbot	chatbots:read	แชตบอตที่โทเค็นนี้ใช้ได้
send_message	conversations:write	ถามแชตบอตในฐานะผู้เข้าชม โดยนับรวมในจำนวนข้อความของแพ็กเกจ ส่ง threadId เพื่อดำเนินการต่อ
list_conversations, get_conversation, list_messages	conversations:read	บทสนทนาจากทุกช่องทางและข้อความในบทสนทนา
take_over_conversation, reply_to_conversation, hand_back_to_chatbot, resolve_conversation	conversations:write	จัดการบทสนทนาในฐานะบุคคล: รับช่วง ตอบกลับ ส่งคืน ปิดเรื่อง หรือเปิดอีกครั้ง
list_leads, get_lead	leads:read	ลีดที่แชตบอตรวบรวมไว้
update_lead	leads:write	เปลี่ยนรายละเอียดของลีดหรือทำเครื่องหมายว่าเปลี่ยนเป็นลูกค้าแล้ว
delete_lead	leads:delete	ลบลีด
list_knowledge_sources, get_knowledge_source	knowledge:read	ข้อมูลที่แชตบอตรู้ พร้อมสถานะและข้อความของแต่ละแหล่งข้อมูล
add_text_knowledge, add_website_knowledge, update_knowledge_source, refresh_knowledge_source	knowledge:write	สอนแชตบอตด้วยข้อความหรือเว็บไซต์ แก้ไขแหล่งข้อมูล และอ่านเว็บไซต์อีกครั้ง
delete_knowledge_source	knowledge:delete	นำแหล่งข้อมูลออก

ไม่มีเครื่องมือสำหรับอัปโหลดไฟล์และเว็บฮุก ให้ใช้ REST endpoint สำหรับงานเหล่านั้น เครื่องมือที่ลบข้อมูลจะถูกระบุว่าเป็นการทำลายข้อมูล และคำแนะนำของเซิร์ฟเวอร์จะบอกให้ผู้ช่วยถามคุณก่อน

ข้อผิดพลาดและขีดจำกัด

การเรียกใช้เครื่องมือที่ถูกปฏิเสธ (เนื่องจากไม่มีสิทธิ์ แชตบอตที่โทเค็นมองไม่เห็น อาร์กิวเมนต์ไม่ถูกต้อง หรือถึงขีดจำกัดของแพ็กเกจ) จะส่งกลับมาเป็นผลลัพธ์ของเครื่องมือที่ระบุว่าเป็นข้อผิดพลาด พร้อม code และข้อความเดียวกับที่ REST API จะแสดง เพื่อให้ผู้ช่วยบอกคุณได้ว่าต้องเปลี่ยนอะไร โทเค็นที่ไม่มีหรือไม่ถูกต้องจะตอบกลับเป็น 401 แพ็กเกจที่ไม่มี API หรือการสมัครสมาชิกที่หมดอายุจะตอบกลับเป็น 403 และการจำกัดอัตราต่อโทเค็นจะตอบกลับเป็น 429 เช่นเดียวกับ REST API

ข้อความที่ไม่ใช่ JSON-RPC 2.0 จะได้รับข้อผิดพลาด JSON-RPC ส่วน GET และ DELETE ที่ endpoint จะตอบกลับเป็น 405 เนื่องจากไม่มีเซสชันและไม่มีสตรีมจากเซิร์ฟเวอร์