Telerivet MCP

npx add-mcp 'https://api.telerivet.com/mcp'

Telerivet มีเซิร์ฟเวอร์ Model Context Protocol (MCP) ที่ช่วยให้เอเจนต์ AI และเครื่องมือที่ใช้ LLM เช่น Claude และ ChatGPT โต้ตอบกับ Telerivet REST API ผ่านอินเทอร์เฟซ MCP มาตรฐานได้

เซิร์ฟเวอร์ MCP ของ Telerivet ช่วยให้เอเจนต์ AI ดำเนินการต่าง ๆ ได้หลากหลายภายใน Telerivet รวมถึงส่งและตั้งเวลาส่งข้อความ ดึงข้อมูลและสถิติการใช้งาน นำเข้ารายชื่อติดต่อ และกำหนดค่าโปรเจ็กต์ เส้นทาง และบริการอัตโนมัติ

MCP endpoint พร้อมใช้งานที่:

https://api.telerivet.com/mcp

ไคลเอ็นต์ MCP เชื่อมต่อผ่านการขนส่ง Streamable HTTP โดยใช้ข้อความ JSON-RPC 2.0 ผ่านคำขอ HTTP POST

การกำหนดค่าไคลเอ็นต์

MCP endpoint ต้องมีการยืนยันตัวตนผ่าน OAuth 2.0

ไคลเอ็นต์ MCP ที่รองรับ OAuth Client ID Metadata Documents (CIMD) สามารถเชื่อมต่อได้โดยไม่ต้องกำหนดค่าด้วยตนเอง: Telerivet จะลงทะเบียนไคลเอ็นต์โดยอัตโนมัติเมื่อผู้ใช้อนุญาตเป็นครั้งแรก Telerivet ไม่รองรับ Dynamic Client Registration

มีคำแนะนำการตั้งค่าสำหรับไคลเอ็นต์ MCP ต่อไปนี้:

• Claude (claude.ai และ Claude Desktop)
• Claude Code
• ChatGPT
• Codex
• Antigravity CLI
• Hermes Agent

สำหรับไคลเอ็นต์ MCP ที่ไม่รองรับ Client ID Metadata Documents ต้องกำหนดค่า OAuth Client ด้วยตนเอง หากต้องการใช้ไคลเอ็นต์ MCP อื่นที่ไม่รองรับ CIMD คุณสามารถ เพิ่ม OAuth Client ใหม่ ในองค์กร Telerivet ของคุณ และกำหนดค่า URL เรียกกลับ OAuth ที่ไคลเอ็นต์ MCP ต้องการ (บริการที่ให้บริการไคลเอ็นต์ MCP อาจระบุ URL เรียกกลับ OAuth ไว้ในเอกสารประกอบ) เมื่อกำหนดค่า OAuth Client ด้วยตนเองในลักษณะนี้ จะมีเพียงผู้ใช้ภายในองค์กร Telerivet ของคุณเท่านั้นที่เข้าถึงได้

การอนุญาตไคลเอ็นต์ MCP

เมื่อคุณเชื่อมต่อไคลเอ็นต์ MCP ระบบจะเปลี่ยนเส้นทางคุณไปยัง Telerivet เพื่ออนุญาตการเข้าถึง ในหน้านี้ คุณจะเลือก:

• สิทธิ์ – ประเภทข้อมูลและการดำเนินการที่แอปพลิเคชันเข้าถึงได้ (เช่น ดูข้อความ, ส่งข้อความ หรือ แก้ไขบริการอัตโนมัติ) ยกเลิกการเลือกสิทธิ์ที่คุณไม่ต้องการให้แอปพลิเคชันมี แอปพลิเคชันไม่สามารถทำสิ่งใดเกินกว่าที่บัญชีผู้ใช้ของคุณได้รับอนุญาต และเมธอด API ที่ต้องใช้สิทธิ์ซึ่งคุณไม่ได้ให้จะถูกซ่อนจากไคลเอ็นต์ MCP
• องค์กร – องค์กรที่แอปพลิเคชันเข้าถึงได้ การอนุญาตแต่ละครั้งครอบคลุมเพียงองค์กรเดียว หากต้องการใช้แอปพลิเคชันกับองค์กรอื่น ให้เชื่อมต่ออีกครั้ง

การอนุมัติแอปพลิเคชันสำหรับองค์กรของคุณ ไคลเอ็นต์ MCP แต่ละรายการ (เช่น Claude หรือ ChatGPT) ต้องได้รับการอนุมัติจากผู้ดูแลระบบองค์กรก่อนจึงจะใช้งานในองค์กรได้ หากคุณเป็นผู้ดูแลระบบองค์กร หน้าการอนุญาตจะให้คุณอนุมัติแอปพลิเคชันสำหรับองค์กรของคุณ และเลือก ใครใช้แอปพลิเคชันนี้ได้บ้าง?: ผู้ใช้ทุกคนในองค์กร เฉพาะผู้ดูแลระบบองค์กร หรือเฉพาะผู้ดูแลระบบองค์กรและผู้ดูแลระบบโปรเจ็กต์ ผู้ใช้อื่นจะเห็นข้อความแจ้งให้ติดต่อผู้ดูแลระบบองค์กรเพื่ออนุมัติแอปพลิเคชัน

การเพิกถอนการเข้าถึง คุณสามารถเพิกถอนการเข้าถึงบัญชีของคุณเองของแอปพลิเคชันได้ทุกเมื่อจากส่วน Authorized Applications ในการตั้งค่า Account Security ผู้ดูแลระบบองค์กรสามารถตรวจสอบและเพิกถอนโทเค็นการเข้าถึงของผู้ใช้ทุกคนได้จากหน้า OAuth Access Tokens หรือเพิกถอนแอปพลิเคชันทั้งหมดได้จากหน้า Connected Applications

การควบคุมระดับองค์กร

ผู้ดูแลระบบองค์กรสามารถควบคุมสิ่งที่ไคลเอ็นต์ MCP ที่ได้รับอนุมัติแต่ละรายการทำได้ภายในองค์กรได้จากหน้า Connected Applications (ซึ่งมีลิงก์จากหน้า Developer API ขององค์กรด้วย) คลิกแอปพลิเคชันเพื่อดูหรือเปลี่ยนการตั้งค่า การตั้งค่าเหล่านี้มีผลกับการเข้าถึงแอปพลิเคชันของผู้ใช้ทุกคนภายในองค์กร โดยไม่ขึ้นกับสิทธิ์ที่ผู้ใช้ให้ไว้เมื่อตอนเชื่อมต่อ

สิทธิ์ที่จำเป็น – ผู้ใช้กลุ่มใดในองค์กรที่สามารถอนุญาตแอปพลิเคชันได้ (ผู้ใช้ทุกคน เฉพาะผู้ดูแลระบบองค์กร หรือเฉพาะผู้ดูแลระบบองค์กรและผู้ดูแลระบบโปรเจ็กต์)

การดำเนินการที่อนุญาต – สำหรับการดำเนินการแต่ละประเภท แอปพลิเคชันสามารถดำเนินการเองได้หรือไม่ ผู้ใช้ต้อง อนุมัติแต่ละการดำเนินการ หรือไม่ หรือไม่อนุญาตเลย:

การดำเนินการ	คำอธิบาย	ตัวเลือก	ค่าเริ่มต้น
การอ่านข้อมูล	ค้นหารายชื่อติดต่อ ข้อความ สถิติ และข้อมูลโปรเจ็กต์อื่น ๆ	อนุญาต, ไม่อนุญาต	อนุญาต
การสร้างและอัปเดตข้อมูล	สร้างและแก้ไขรายชื่อติดต่อ กลุ่ม บริการ แคมเปญฉบับร่าง เส้นทาง และข้อมูลโปรเจ็กต์อื่น ๆ	อนุญาต, ต้องได้รับอนุมัติ, ไม่อนุญาต	อนุญาต
การส่งข้อความและเรียกใช้บริการ	ส่งหรือตั้งเวลาส่งข้อความและโทรไปยังรายชื่อติดต่อ เรียกใช้บริการอัตโนมัติ และเรียกใช้สคริปต์	อนุญาต, ต้องได้รับอนุมัติ, ไม่อนุญาต	ต้องได้รับอนุมัติ
การลบข้อมูล	ลบรายชื่อติดต่อ ข้อความ บริการ และข้อมูลโปรเจ็กต์อื่น ๆ	อนุญาต, ต้องได้รับอนุมัติ, ไม่อนุญาต	ต้องได้รับอนุมัติ
การส่งคำขอเว็บภายนอก	ส่งคำขอไปยังเว็บไซต์ภายนอกและ API ของบุคคลที่สามจากสคริปต์ที่แอปพลิเคชันนี้เรียกใช้	อนุญาต, ไม่อนุญาต	อนุญาต

เมื่อหมวดหมู่ใดเป็น ไม่อนุญาต เครื่องมือ MCP ที่เกี่ยวข้อง (เช่น send_api หรือ delete_api) จะถูกซ่อนจากไคลเอ็นต์ MCP และคำขอ API ใด ๆ ในหมวดหมู่นั้นจะถูกปฏิเสธ เครื่องมือ run_script จะใช้การตั้งค่าที่เข้มงวดที่สุดในบรรดาการส่ง การสร้าง/อัปเดต และการลบข้อมูล

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

สิทธิ์ที่อนุญาต – ประเภทข้อมูลและการดำเนินการที่แอปพลิเคชันเข้าถึงได้ในองค์กรนี้ การยกเลิกการเลือกสิทธิ์จะบล็อกการดำเนินการ API ที่เกี่ยวข้องสำหรับผู้ใช้แอปพลิเคชันทุกคนในองค์กร แม้ว่าผู้ใช้จะให้สิทธิ์นั้นไว้เมื่อตอนเชื่อมต่อก็ตาม

เพิกถอนการเข้าถึง – นำแอปพลิเคชันออกจากรายการแอปพลิเคชันที่องค์กรของคุณอนุมัติ และเพิกถอนโทเค็นการเข้าถึงที่มีอยู่ทั้งหมดของแอปพลิเคชันนั้นในองค์กรของคุณ

แอปพลิเคชันที่องค์กรของคุณเป็นเจ้าของเอง (เพิ่มผ่าน Add OAuth Client) ไม่จำเป็นต้องได้รับการอนุมัติ และกำหนดค่าการดำเนินการที่อนุญาตได้จากหน้าการตั้งค่าของแอปพลิเคชันนั้นโดยตรง

การยืนยันโดยมนุษย์ในวงจร

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

การดำเนินการในหมวดหมู่การส่ง ได้แก่ การส่งหรือตั้งเวลาส่งข้อความและโทร การส่งข้อความซ้ำ การเรียกใช้บริการอัตโนมัติ การสร้างงานแบบกลุ่ม การจำลองข้อความขาเข้า การแก้ไขข้อความหรือแคมเปญที่ตั้งเวลาไว้ การเปิดใช้งานบริการอัตโนมัติหรือเปลี่ยนการกำหนดค่าของบริการที่กำลังทำงาน การสร้าง webhook หรือเปลี่ยน URL ของ webhook การเปลี่ยนหมายเลขโทรศัพท์หรือการตั้งค่าผู้ให้บริการของเส้นทาง การเปลี่ยนเส้นทางเริ่มต้นของโปรเจ็กต์ และการเรียกใช้สคริปต์ด้วยเครื่องมือ run_script หมวดหมู่การลบรวมถึงเมธอดการลบทั้งหมด ตลอดจนการลดระยะเวลาเก็บรักษาข้อความของโปรเจ็กต์

คุณสามารถอนุมัติการดำเนินการได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้ ทั้งนี้ขึ้นอยู่กับไคลเอ็นต์ MCP:

ข้อความแจ้งอนุมัติในไคลเอ็นต์ MCP

หากไคลเอ็นต์ MCP รองรับ MCP elicitation (โดยใช้ MCP protocol version 2026-07-28 หรือใหม่กว่า) ไคลเอ็นต์ MCP จะแจ้งให้คุณอนุมัติการดำเนินการได้โดยตรง พร้อมคำอธิบายภาษาทั่วไปว่าการดำเนินการนั้นจะทำอะไรและส่งผลต่อโปรเจ็กต์ใด หากคุณอนุมัติ ระบบจะดำเนินการทันที หากคุณปฏิเสธ ระบบจะไม่ดำเนินการ และโมเดล AI จะได้รับแจ้งว่าไม่ควรลองอีกครั้ง

ฉบับร่างข้อความ

หากไคลเอ็นต์ MCP รองรับส่วนขยาย MCP Apps โมเดล AI สามารถใช้เครื่องมือ draft_message เพื่อแสดงฉบับร่างข้อความที่แก้ไขได้ พร้อมรายชื่อผู้รับ การคลิก Send จะอนุมัติการส่งข้อความนั้นตามเนื้อหาที่ระบุไปยังผู้รับเหล่านั้น

ลิงก์อนุมัติ

หากไคลเอ็นต์ MCP ไม่รองรับวิธีข้างต้น หรือไม่สามารถอนุมัติการดำเนินการด้วยวิธีดังกล่าวได้ โมเดล AI จะได้รับลิงก์ไปยังหน้า Approve Action ในเว็บแอป Telerivet และควรขอให้คุณเปิดลิงก์นั้น หน้านี้จะแสดงแอปพลิเคชัน โปรเจ็กต์ คำอธิบายการดำเนินการ และรายละเอียดคำขอทั้งหมด หลังจากคลิก Approve แล้ว ให้กลับไปที่ไคลเอ็นต์ MCP และขอให้ลองอีกครั้ง

คุณต้องมีสิทธิ์ที่การดำเนินการนั้นต้องใช้จึงจะอนุมัติได้ (เช่น สิทธิ์ส่งข้อความในโปรเจ็กต์) การอนุมัติการดำเนินการไม่ได้ให้สิทธิ์เพิ่มเติมแก่แอปพลิเคชัน

วิธีการทำงานของการอนุมัติ

• การอนุมัติแต่ละครั้งใช้ได้กับคำขอที่ตรงกันทุกประการเพียงรายการเดียว – เมธอด API เดียวกันและพารามิเตอร์เดียวกัน – และใช้ได้เพียงครั้งเดียว หากโมเดล AI เปลี่ยนแปลงส่วนใดของคำขอ จะต้องขออนุมัติอีกครั้ง
• การอนุมัติจะหมดอายุหลังจาก 1 ชั่วโมง
• คำขอ API ที่สคริปต์ส่งหลังจากคุณอนุมัติผ่าน run_script ไม่จำเป็นต้องได้รับการอนุมัติแยกต่างหาก
• หากแอปพลิเคชันเรียก REST API โดยตรงด้วยโทเค็นการเข้าถึงของตน (แทนที่จะเรียกผ่าน MCP) คำขอที่ต้องได้รับอนุมัติจะล้มเหลวด้วยรหัสข้อผิดพลาด confirmation_required และข้อความแสดงข้อผิดพลาดจะมีลิงก์อนุมัติ แอปพลิเคชันที่ต้องดำเนินการเหล่านี้ได้โดยไม่มีผู้ใช้อยู่ด้วย (เช่น การผสานรวมฝั่งเซิร์ฟเวอร์หรือเอเจนต์อัตโนมัติ) ต้องให้ผู้ดูแลระบบองค์กรตั้งค่าหมวดหมู่นั้นเป็น อนุญาต

การตรวจสอบข้อความ นอกเหนือจากที่กล่าวมาข้างต้น หากโปรเจ็กต์เปิดใช้ Message Review ใน Messaging Settings ข้อความที่ส่งผ่าน API (รวมถึงผ่าน MCP) และเกินขีดจำกัดที่กำหนดไว้จะถูกพักไว้เป็นข้อความรออนุมัติจนกว่าผู้ตรวจสอบจะอนุมัติ เช่นเดียวกับข้อความที่ส่งจากเว็บแอป

เครื่องมือ

ขณะนี้เซิร์ฟเวอร์ MCP เปิดให้ใช้เครื่องมือต่อไปนี้:

• list_api_methods – แสดงรายการเมธอด API ที่พร้อมใช้งาน พร้อมชื่อ คำอธิบาย และสรุปพารามิเตอร์ รองรับการกรองตามหมวดหมู่
• get_method_schema – ส่งคืนสคีมาพารามิเตอร์ฉบับเต็มและคำอธิบายฟิลด์การตอบกลับสำหรับเมธอด API ที่ระบุ
• read_api – เรียกใช้เมธอด API แบบอ่านอย่างเดียวเพื่อดึงข้อมูล
• modify_api – เรียกใช้เมธอด API เพื่อสร้างหรืออัปเดตข้อมูล
• delete_api – เรียกใช้เมธอด API เพื่อลบข้อมูล
• send_api – เรียกใช้เมธอด API เพื่อส่ง กำหนดเวลาส่ง หรือรับข้อความ เรียกใช้บริการอัตโนมัติ หรือดำเนินงานแบบกลุ่ม
• run_analysis_script – เรียกใช้ JavaScript แบบอ่านอย่างเดียวในแซนด์บ็อกซ์ Cloud Script API ของ Telerivet เพื่อวิเคราะห์ข้อมูลโปรเจ็กต์ ซึ่งมีประโยชน์สำหรับการรวมข้อมูล การเชื่อมข้อมูลข้ามประเภทเอนทิตี หรือการสแกนระเบียนจำนวนมากโดยไม่ต้องแบ่งหน้าเพื่อส่งผ่านโมเดลทั้งหมด การเข้าถึง API เป็นแบบอ่านอย่างเดียว และปิดใช้งาน HTTP ขาออก
• run_script – เรียกใช้ JavaScript ที่เข้าถึง Cloud Script API ได้ (อ่าน เขียน ส่ง และส่งคำขอ HTTP) สำหรับการดำเนินการแบบกลุ่มที่มิฉะนั้นจะต้องเรียก API แยกกันหลายครั้ง คำขอ API ที่สคริปต์ส่งจะได้รับการตรวจสอบตามขอบเขตสิทธิ์ของโทเค็น OAuth ดังนั้นสคริปต์จึงไม่สามารถทำสิ่งใดเกินกว่าที่โทเค็นซึ่งใช้เรียกสคริปต์นั้นอนุญาต
• get_web_app_urls – ส่งคืนข้อมูลเกี่ยวกับฟังก์ชันการทำงานของเว็บแอปและรูปแบบ URL ช่วยให้เอเจนต์ AI สร้างลิงก์ไปยังฟังก์ชันการทำงานที่ไม่สามารถเข้าถึงได้โดยตรงผ่าน API หากไม่มีคำค้นหา จะส่งคืนดัชนีแบบย่อของทุกหน้า การค้นหาด้วยคำสำคัญหรือพาธ URL จะส่งคืนรายละเอียดทั้งหมดของหน้าที่ตรงกัน
• draft_message – ร่างข้อความตัวอักษรธรรมดาเพื่อส่งไปยังหมายเลขโทรศัพท์หนึ่งหมายเลขขึ้นไป (หรือกลุ่มผู้ติดต่อ) และขออนุมัติจากผู้ใช้ก่อนส่ง (ดู ฉบับร่างข้อความ) ใช้ได้เฉพาะเมื่อไคลเอ็นต์ MCP รองรับส่วนขยาย MCP Apps
• get_route_options – ส่งคืนข้อมูลเกี่ยวกับตัวเลือกเส้นทาง/ช่องทางการส่งข้อความที่พร้อมใช้งาน การกรองตามประเทศ ประเภทช่องทาง หรือกรณีการใช้งาน (หรือค้นหาประเภทเส้นทางที่ระบุ) จะส่งคืนรายละเอียดทั้งหมด รวมถึงพื้นที่ให้บริการ ข้อกำหนดด้านการปฏิบัติตามกฎระเบียบ ขั้นตอนการลงทะเบียน รูปแบบการเรียกเก็บเงิน (จัดการภายใน/โดย Telerivet เทียบกับภายนอก/BYOC) ระยะเวลาการตั้งค่า และราคา
• skillbook_search / skillbook_get – ส่งคืนข้อมูลเกี่ยวกับรูปแบบโซลูชัน บริการ ประเภทแคมเปญ ฟีเจอร์แพลตฟอร์ม และเทมเพลตข้อความที่พบบ่อย ซึ่งตรงกับเจตนาหรือกรณีการใช้งาน
• search_documentation / get_documentation – ค้นหาและดึงรายการจากคลังเอกสารของ Telerivet ซึ่งรวมถึงบทความช่วยเหลือในคู่มือผู้ใช้ หน้ากฎหมาย/นโยบาย เอกสาร API สำหรับนักพัฒนา และเนื้อหาด้านการตลาด/บริษัทบน www.telerivet.com

เครื่องมือและเมธอด API ที่เซิร์ฟเวอร์ MCP เปิดให้ใช้งานอาจเปลี่ยนแปลงได้เมื่อเวลาผ่านไป

ลิงก์ด้านล่างแสดง JSON ที่เซิร์ฟเวอร์ MCP ส่งคืน ซึ่งอาจช่วยให้เข้าใจเครื่องมือและเมธอด API ที่พร้อมใช้งาน:

• คำจำกัดความของเครื่องมือ
• ผลลัพธ์จากเครื่องมือ list_api_methods
• ผลลัพธ์จากเครื่องมือ get_method_schema สำหรับเมธอด Project_queryContacts (เปลี่ยนส่วนสุดท้ายของ URL เพื่อดูสคีมาของเมธอด API อื่น)
• ผลลัพธ์จากเครื่องมือ get_documentation สำหรับเอกสารอ้างอิง Cloud Script API (เปลี่ยนส่วนสุดท้ายของ URL เพื่อดูรายการเอกสารอื่น)

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