השתמשו ב-ThunderPhone כשרת MCP

חברו כל לקוח MCP מסוג HTTP ניתן להזרמה ל-ThunderPhone כדי להציג סוכנים, לבדוק שיחות ותמלולים, ולבצע שיחות יוצאות באמצעות מפתח API של הארגון.

ThunderPhone חושפת שרת Model Context Protocol בכתובת:

https://api.thunderphone.com/v1/mcp

הגדירו לקוח MCP כך שיפנה לנקודת הקצה הזו של HTTP הניתן להזרמה, כדי להפוך את הסוכנים והשיחות של הארגון שלכם לכלים זמינים. זהו הכיוון ההפוך מ- חיבור שרת MCP מרוחק לסוכן קולי:

כיוון	תוצאה
שרת MCP מרוחק → סוכן ThunderPhone	הסוכן הקולי שלכם יכול לקרוא לכלים של השרת המרוחק.
ThunderPhone → לקוח ה-MCP שלכם	לקוח ה-MCP שלכם יכול לקרוא לכלי ThunderPhone עבור סוכנים ושיחות.

אימות

צרו מפתח sk_live_ תחת ארגון → מפתחות ושלחו אותו כאסימון נושא. נקודת הקצה של MCP מקבלת מפתחות API של ארגון, ולא עוגיות הפעלה של לוח הבקרה או מפתחות וידג'ט הניתנים לפרסום.

Generic client configuration

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

כלים זמינים

כלי	ארגומנטים	מה הוא עושה
`list_agents`	ללא	מציג את סוכני הארגון עם מזהה, שם, מוצר וקול.
`get_agent`	`agent_id`	מאחזר סוכן אחד.
`place_call`	`agent_id`, `from_number`, `to_number`	מבצע שיחה יוצאת עם אותן בדיקות אימות ותנאי חיוב כמו נקודת הקצה של שיחת REST.
`get_call`	`call_id`	מאחזר את סטטוס השיחה, הסיכום והדירוג.
`list_calls`	`limit` אופציונלי (1–100), `status` אופציונלי	מציג שיחות אחרונות.
`get_call_transcript`	`call_id`	מאחזר את התמליל המלא של שיחה.

כל הכלים מוגבלים לארגון המקושר למפתח ה-API. מזהה מארגון אחר מתנהג כאילו אינו זמין.

שיטות פרוטוקול

נקודת הקצה מממשת את שיטות MCP JSON-RPC הנדרשות עבור לקוחות HTTP הניתן להזרמה:

initialize
notifications/initialized
tools/list
tools/call

אפשר לבדוק את קטלוג הכלים ישירות:

curl -X POST https://api.thunderphone.com/v1/mcp \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

קראו לכלי באמצעות שמו והארגומנטים שלו:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_calls",
    "arguments": { "limit": 20, "status": "completed" }
  }
}

תוצאות הכלים הן פריטי תוכן טקסט של MCP. כשלים בכלים מוחזרים בתוצאה עם isError: true; שיטות JSON-RPC לא מוכרות מחזירות שגיאת פרוטוקול.

place_call פועל לפי אותם הכללים כמו POST /v1/call: הסוכן והמספר חייבים להשתייך לארגון של המפתח, המספר חייב להיות זכאי לביצוע שיחות יוצאות, לארגון חייבת להיות יתרה מספקת, וכל אישור נדרש לביצוע שיחות יוצאות חייב להיות הושלם.

התייחסו ללקוח עם גישה אל place_call כאל גורם המבצע שיחות בייצור. הגבילו את האנשים שיכולים להשתמש בלקוח, הבהירו בהנחיה שלו את הסוכן והמספר המיועדים, ובדקו שיחות בהיסטוריית השיחות.

הפניית פרוטוקול מלאה

עיינו ב-API של שרתי MCP לדוגמאות תגובה, שגיאות JSON-RPC ו-API לניהול שרתים מרוחקים.

השתמשו ב-ThunderPhone כשרת MCP

אימות#

כלים זמינים#

שיטות פרוטוקול#

ביצוע שיחות בבטחה#

הפניית פרוטוקול מלאה#

אימות

כלים זמינים

שיטות פרוטוקול

ביצוע שיחות בבטחה

הפניית פרוטוקול מלאה