Platfone - Receive SMS & Virtual Numbers MCP

Platfone MCP Server

Platfone ให้บริการหมายเลขโทรศัพท์เสมือนสำหรับการยืนยันบัญชี การทดสอบ และกระบวนการทำงานอัตโนมัติ Platfone MCP server ช่วยให้เอเจนต์ AI สามารถขอหมายเลขชั่วคราวและรับข้อความ SMS จากไคลเอนต์ที่รองรับ MCP เช่น Claude, VS Code Copilot, Codex และอื่นๆ

📖 เอกสาร · 🔧 คู่มือการติดตั้ง · 🔑 รับ API Key · 📦 npm

ทำไมต้อง MCP?

แทนที่จะต้องเชื่อมต่อ API ด้วยตนเอง เอเจนต์ AI สามารถ:

• สั่งซื้อหมายเลขได้เองตามประเทศและชื่อบริการ
• รอรับรหัส SMS
• ลองใหม่หรือยกเลิกการเปิดใช้งาน

ทั้งหมดนี้ผ่านการเรียกใช้เครื่องมือที่มีโครงสร้าง — ไม่ต้องมีแบ็กเอนด์ที่กำหนดเอง

คุณสมบัติ

• วงจรการเปิดใช้งานเต็มรูปแบบ — ตั้งแต่การสั่งซื้อหมายเลขไปจนถึงการรับ SMS
• แค็ตตาล็อกแบบ ETag-cached — ประเทศและบริการถูกแคชในหน่วยความจำด้วย TTL 5 นาทีและการรีเฟรชตามเงื่อนไขด้วย ETag — ไม่ถูกส่งไปยังเอเจนต์
• อินพุตที่มนุษย์อ่านง่าย — ใช้ "Israel" หรือ "Telegram" แทน ID; ชื่อจะถูกแปลงเป็น ID โดยอัตโนมัติฝั่งเซิร์ฟเวอร์
• การขนส่งสองรูปแบบ — stdio และ http จากโค้ดเบสเดียว
• การยืนยันตัวตนด้วย API key — ใช้งานได้กับ Platfone API key ที่คุณมีอยู่

การติดตั้ง

ดู คู่มือการติดตั้ง ฉบับเต็มสำหรับคำแนะนำโดยละเอียด

เริ่มต้นอย่างรวดเร็ว

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

แนวทางสำหรับเอเจนต์

• เรียก check_price ก่อนเสมอเพื่อตรวจสอบค่าใช้จ่ายและความพร้อมใช้งาน
• จากนั้นเรียก order_number เพื่อเช่าหมายเลข
• เรียก check_sms จนกว่าจะได้รับ SMS หรือหมดอายุ
• ใช้ retry_activation หากไม่มี SMS มาถึง
• ใช้ cancel_activation เพื่อปล่อยเงินคืนหากไม่ต้องการอีกต่อไป

เครื่องมือ

เครื่องมือ	คำอธิบาย
get_balance	ตรวจสอบยอดเงินในบัญชี: เงินทั้งหมด, เงินที่ถูกจองไว้ และเงินที่ใช้ได้
check_price	ตรวจสอบราคาและความพร้อมใช้งานสำหรับคู่ประเทศ + บริการก่อนสั่งซื้อ
order_number	สั่งซื้อหมายเลขโทรศัพท์เสมือน ยอมรับชื่อ ("Israel") หรือ ID ("il") ส่งคืน activation_id + phone
check_sms	ตรวจสอบสถานะการเปิดใช้งาน ส่งคืนรหัส SMS เมื่อได้รับ หรือสถานะปัจจุบันพร้อมคำแนะนำในการตรวจสอบซ้ำ
retry_activation	ขอ SMS อีกครั้งบนหมายเลขเดิม ไม่มีค่าใช้จ่าย
cancel_activation	ยกเลิกการเปิดใช้งานที่กำลังดำเนินอยู่ก่อนได้รับ SMS คืนเงินที่ถูกจองไว้

หมายเหตุ: แค็ตตาล็อกประเทศและบริการถูกแคชฝั่งเซิร์ฟเวอร์และแปลงจากชื่อที่มนุษย์อ่านได้โดยอัตโนมัติ เอเจนต์จะไม่ได้รับแค็ตตาล็อกทั้งหมด — จะได้รับเฉพาะ ID ที่แปลงแล้วหรือคำแนะนำในการแก้ความกำกวม

ขั้นตอนการทำงานทั่วไปของเอเจนต์ AI

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

ขั้นตอนเพิ่มเติม:

• retry_activation — ขอ SMS อีกครั้งบนหมายเลขเดิม (ฟรี)
• cancel_activation — ยกเลิกก่อนที่ SMS จะมาถึง (คืนยอดเงิน)

การพัฒนา

อ่าน คู่มือการพัฒนา ฉบับเต็มสำหรับคำแนะนำในการติดตั้งและเคล็ดลับการทดสอบ

การแก้ไขปัญหา

ข้อผิดพลาด	วิธีแก้ไข
UnauthorizedException	ตรวจสอบว่า PLATFONE_API_KEY ของคุณถูกต้อง
PaymentRequiredException	เติมเงินในบัญชี Platfone ของคุณ
NoNumbersAvailableException	ลองเปลี่ยนประเทศหรือบริการ
TooManyRequestsException	ถูกจำกัดอัตราการเรียก — รอสักครู่แล้วลองใหม่
MaxPriceExceededException	ลอง order_number อีกครั้งด้วย max_price ที่แนะนำและ order_id ที่ส่งคืน
TooManyActivationsException	ถึงจำนวนการเปิดใช้งานพร้อมกันสูงสุดแล้ว — ยกเลิกหรือรอให้หมดอายุ

ใบอนุญาต

ดู LICENSE.md ภายใต้ใบอนุญาต MIT

การใช้ Platfone API อยู่ภายใต้ ข้อกำหนดในการให้บริการ และ นโยบายความเป็นส่วนตัว