Χρησιμοποιήστε το ThunderPhone ως διακομιστή MCP

Το ThunderPhone εκθέτει έναν διακομιστή Model Context Protocol στη διεύθυνση:

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

Ρυθμίστε έναν πελάτη MCP να χρησιμοποιεί αυτό το τελικό σημείο Streamable HTTP, ώστε να καταστήσετε τους πράκτορες και τις κλήσεις του οργανισμού σας διαθέσιμα ως εργαλεία. Αυτή είναι η αντίθετη κατεύθυνση από τη σύνδεση ενός απομακρυσμένου διακομιστή MCP με έναν φωνητικό πράκτορα:

Κατεύθυνση	Αποτέλεσμα
Απομακρυσμένος διακομιστής MCP → πράκτορας ThunderPhone	Ο φωνητικός πράκτοράς σας μπορεί να καλεί τα εργαλεία του απομακρυσμένου διακομιστή.
ThunderPhone → ο πελάτης MCP σας	Ο πελάτης MCP σας μπορεί να καλεί εργαλεία ThunderPhone για πράκτορες και κλήσεις.

Πιστοποίηση ταυτότητας

Δημιουργήστε ένα κλειδί sk_live_ στην ενότητα Οργανισμός → Κλειδιά και στείλτε το ως διακριτικό Bearer. Το τελικό σημείο MCP δέχεται κλειδιά API οργανισμού, όχι cookie συνεδρίας πίνακα ελέγχου ή δημοσιεύσιμα κλειδιά widget.

{
  "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 που απαιτούνται για πελάτες Streamable 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 ως παραγωγικό καλούντα. Περιορίστε ποιοι μπορούν να χρησιμοποιούν τον πελάτη, καταστήστε σαφή τον προβλεπόμενο πράκτορα και αριθμό στο δικό του prompt, και ελέγχετε τις κλήσεις στο Ιστορικό κλήσεων.

Πλήρης αναφορά wire

Δείτε το API διακομιστών MCP για παραδείγματα αποκρίσεων, σφάλματα JSON-RPC και το API διαχείρισης απομακρυσμένων διακομιστών.