Πώς να δώσετε στο Claude Code τηλεφωνικό αριθμό μέσω MCP

Θέλετε το Claude Code (ή το Cursor, το Windsurf, το VS Code) να μπορεί να τηλεφωνεί και να στέλνει SMS απευθείας από ένα prompt, χωρίς να γράψετε κώδικα; Αρκεί μία εντολή στο τερματικό που συνδέει το volai ως διακομιστή MCP, και μετά γράφετε στον επεξεργαστή με απλά λόγια τι θέλετε - «κάλεσέ με στο...», «στείλε SMS...». Ο επεξεργαστής διαλέγει μόνος του το σωστό εργαλείο από τα 110 που προσφέρει το volai μέσω MCP και το καλεί. Χωρίς ανάγνωση τεκμηρίωσης API, χωρίς δικό σας κώδικα τηλεφωνίας.

Τι είναι το MCP και γιατί λειτουργεί χωρίς κώδικα;

Το MCP (Model Context Protocol) είναι ο τρόπος με τον οποίο ένας επεξεργαστής με τεχνητή νοημοσύνη ζητά εν λειτουργία ένα εργαλείο από εξωτερική υπηρεσία και το χρησιμοποιεί αμέσως - αντί να απλώς μιλά γι' αυτό. Μόλις συνδεθεί το volai, ο επεξεργαστής βλέπει και τα 110 εργαλεία (κλήση, αποστολή SMS, αγορά αριθμού, δημιουργία πράκτορα και άλλα) και από την περιγραφή του καθενός καταλαβαίνει μόνος του ποιο ταιριάζει σε όσα μόλις γράψατε. Όποιος θέλει αναλυτική εξήγηση της αρχής θα τη βρει στο άρθρο Τι είναι ο διακομιστής MCP και πώς σχετίζεται με την τηλεφωνία· εδώ μας απασχολεί κυρίως πώς θα δώσετε τηλεφωνικό αριθμό στο Claude Code και θα το δοκιμάσετε αμέσως.

Εγκατάσταση στο Claude Code

Μία εντολή στο τερματικό και τελειώσατε:

claude mcp add --transport http volai https://volai.eu/mcp \
  --header "Authorization: Bearer vk_TO_KLEIDI_SAS"

Το κλειδί API (vk_TO_KLEIDI_SAS) θα το βρείτε στην πύλη του volai, στην ενότητα API και MCP, αφού εγγραφείτε. Χωρίς έγκυρο κλειδί ο διακομιστής απορρίπτει το αίτημα - ο επεξεργαστής θα σας το πει με το πρώτο μήνυμα.

Cursor και άλλοι επεξεργαστές

Ο ίδιος διακομιστής, διαφορετική σύνταξη. Στο ~/.cursor/mcp.json (ή στο .cursor/mcp.json μόνο για ένα έργο) προσθέστε:

{
  "mcpServers": {
    "volai": {
      "url": "https://volai.eu/mcp",
      "headers": {
        "Authorization": "Bearer vk_TO_KLEIDI_SAS"
      }
    }
  }
}

Το Windsurf, το VS Code (Copilot) και το Claude Desktop συνδέονται με την ίδια αρχή, μόνο με ελαφρώς διαφορετική μορφή του αρχείου ρυθμίσεων - την ακριβή σύνταξη για καθένα θα βρείτε στη σελίδα Διακομιστής MCP.

Αν ο επεξεργαστής δεν προσφέρει κανένα εργαλείο μετά τη σύνδεση: συνήθως ευθύνεται ένα από τρία πράγματα. Ο επεξεργαστής διαβάζει συνήθως τις ρυθμίσεις των διακομιστών MCP μόνο κατά την εκκίνηση, οπότε μετά την πρώτη αποθήκευση χρειάζεται επανεκκίνηση (ή τουλάχιστον επαναφόρτωση του παραθύρου ή του έργου). Ελέγξτε το κλειδί που αντιγράψατε για περιττό κενό στην αρχή ή στο τέλος - στο τερματικό και στο αρχείο JSON είναι αόρατο, αλλά χαλά την κεφαλίδα Authorization. Και το αν ο διακομιστής απαντά το επιβεβαιώνετε πιο γρήγορα με το ακριβές prompt λίγο πιο κάτω - μόλις ο επεξεργαστής καλέσει μόνος του ένα εργαλείο, η σύνδεση λειτουργεί.

Η πρώτη σας κλήση με ένα prompt

Μετά τη σύνδεση αρκεί να γράψετε στον επεξεργαστή με δικά σας λόγια τι θέλετε - για παράδειγμα ακριβώς αυτό:

• ›Κάλεσέ με τώρα στο +420777123456 και δοκίμασε τον ρόλο της γραμμής παραγγελιών μιας πιτσαρίας - δεν θέλω να στήσω δικό μου αριθμό ή πράκτορα μόνο γι' αυτό.

Ο επεξεργαστής το αναγνωρίζει ως το εργαλείο make_call με την παράμετρό του systemPrompt - δοκιμαστική κλήση χωρίς να χρειάζεται να αγοράσετε αριθμό ή να δημιουργήσετε πράκτορα εκ των προτέρων. Η κλήση γίνεται από τον κοινό δοκιμαστικό αριθμό του volai - ακριβώς αυτός εμφανίζεται στην οθόνη του καλούμενου, όχι ο δικός σας - και τρέχει με την προεπιλεγμένη φωνή του πράκτορα, επειδή σε δοκιμαστική κλήση δεν μπορεί να σταλεί δική σας voiceId. Το systemPrompt επιτρέπεται να έχει έως 1200 χαρακτήρες, η κλήση χρεώνεται απολύτως κανονικά, μαζί με την επιβάρυνση του πράκτορα (χωρίς έκπτωση), και περιορίζεται σε έως 3 δοκιμαστικές κλήσεις ανά 24 ώρες ανά λογαριασμό - απαραίτητη προϋπόθεση είναι επαληθευμένο email. Αν θέλετε να καλείτε από δικό σας αριθμό μέσω δικού σας πράκτορα, πείτε το απλώς στον επεξεργαστή - θα καλέσει το make_call με agentId αντί για systemPrompt.

Το πρώτο σας SMS με ένα prompt

Η ίδια αρχή ισχύει και για τα γραπτά μηνύματα:

• ›Στείλε SMS στο +420777123456 ότι το ραντεβού επιβεβαιώνεται για αύριο το πρωί.

Αυτή τη φορά ο επεξεργαστής καταφεύγει στο send_sms - από κάτω είναι ακριβώς η ίδια κλήση που θα γράφατε μόνοι σας απευθείας στο REST API (POST /v1/messages {"to": "+420...", "body": "..."}), μόνο που δεν γράφετε κώδικα. Χωρίς δικό σας αριθμό, το SMS φεύγει με το κοινό όνομα αποστολέα SMSinfo μόνο προς τσεχικό (+420) ή σλοβακικό (+421) αριθμό και ο παραλήπτης δεν μπορεί να απαντήσει - οι φωνητικοί αριθμοί του volai δεν λαμβάνουν SMS. Τη λήψη SMS και την αποστολή από δικό σας αριθμό (μόνο προς τσεχικούς αριθμούς) την προσφέρει το πρόσθετο αριθμού κινητού (290 kr χωρίς ΦΠΑ ανά 30 ημέρες, έως 2 ανά λογαριασμό)· ο επεξεργαστής το αγοράζει με το εργαλείο buy_sms_number μόνο αφού συμφωνήσετε ρητά με την τιμή και διαβάζει τα ληφθέντα μηνύματα με το εργαλείο list_messages· τους κωδικούς επαλήθευσης από υπηρεσίες δεν τους εγγυόμαστε. SMS λαμβάνει και από δικό σας αριθμό στέλνει και ο «αριθμός για κλήσεις και SMS»: σταθερή γραμμή Πράγας για 49 kr χωρίς ΦΠΑ ανά 30 ημέρες (η χρέωση γίνεται μόλις ενεργοποιηθεί, συνήθως εντός 1 εργάσιμης ημέρας· έως 2 ανά λογαριασμό), στην οποία οι άνθρωποι μπορούν να τηλεφωνήσουν και να στείλουν μήνυμα και από την οποία ο πράκτοράς σας καλεί και στέλνει SMS. Ο επεξεργαστής την παραγγέλνει με το εργαλείο order_voice_sms_number μόνο αφού συμφωνήσετε ρητά με την τιμή, κατευθύνει τις εισερχόμενες κλήσεις με το set_voice_sms_number_routing και στέλνει SMS από αυτήν με το send_sms και το πεδίο fromNumber (μόνο προς τσεχικούς αριθμούς, χωρίς αποδεικτικά παράδοσης). Τα μηνύματα φεύγουν μόνο μετά την πρώτη φόρτιση υπολοίπου: το υπόλοιπο καλωσορίσματος αρκεί για δοκιμαστικές κλήσεις, όχι για SMS.

Τι άλλο μπορείτε να ζητήσετε;

Με τον ίδιο τρόπο λειτουργεί οποιοδήποτε από τα 110 εργαλεία - μερικά ακόμη παραδείγματα:

• «Περίληψε μου τις τελευταίες δέκα κλήσεις - κυρίως αν ανάμεσά τους υπήρχε κάτι επείγον.» - εργαλείο list_calls.
• «Πες μου το τρέχον υπόλοιπο και στείλε προειδοποίηση αν τελειώνει.» - εργαλείο get_balance.
• «Δημιούργησε έναν νέο αριθμό για το υποκατάστημα και ανάθεσέ του αμέσως έναν πράκτορα που θα δέχεται κρατήσεις τραπεζιών.» - εργαλεία buy_number και create_agent το ένα μετά το άλλο.

Ο πλήρης πίνακας και των 110 εργαλείων, με περιγραφή του πότε τα χρησιμοποιεί ο επεξεργαστής, βρίσκεται στη σελίδα Διακομιστής MCP - και η σελίδα Ενσωματώσεις: Claude Code έχει επίσης μερικά έτοιμα prompt για τυπικές εργασίες.

Είναι ασφαλές να δώσετε στον επεξεργαστή κλειδί API;

Το MCP πιστοποιείται με το ίδιο κλειδί API όπως το REST API και μοιράζεται μαζί του το ίδιο όριο 60 αιτημάτων ανά λεπτό - όποιος έχει αυτό το κλειδί ενεργεί στον λογαριασμό σας ακριβώς όπως εσείς: αγοράζει αριθμό, σηκώνει το τηλέφωνο, στέλνει μήνυμα ή δημιουργεί πράκτορα, και όλα αυτά αφαιρούνται από το υπόλοιπό σας.

Οι επί πληρωμή ενέργειες (send_sms, make_call, buy_number, buy_sms_number) φέρουν σκόπιμα το idempotentHint: false - μια δεύτερη κλήση στέλνει δεύτερο SMS ή χρεώνει δεύτερο ποσό, γι' αυτό ένας καλός επεξεργαστής δεν τις επαναλαμβάνει μόνος του μετά από χρονική λήξη. Και ακόμη κι αν κάποιο prompt παρεκκλίνει προς αριθμό που δεν θέλετε να καλείται, υπάρχει μια τελευταία ασφαλιστική δικλίδα: η λίστα «μη καλείτε». Τα εργαλεία add_to_dnc, list_dnc και remove_from_dnc φυλάνε τους αριθμούς που κανένας πράκτορας (ενσωματωμένος ή δικός σας) δεν επιτρέπεται πλέον να καλέσει - ισχύει για κλήσεις, όχι για SMS, και δεν παρακάμπτεται με κανένα prompt ή κλήση API.

Κάθε εργαλείο επιπλέον ενημερώνει εκ των προτέρων τον επεξεργαστή πώς συμπεριφέρεται - αν μόνο διαβάζει (readOnlyHint), αν είναι μη αναστρέψιμο (destructiveHint), ή αν δεν πρέπει να επαναλαμβάνεται απερίσκεπτα (καμία ένδειξη idempotent στις επί πληρωμή ενέργειες). Γι' αυτό ένας καλός επεξεργαστής ρωτά πριν διαγράψει πράκτορα ή ακυρώσει αχρησιμοποίητο relay lease, ενώ τα εργαλεία ανάγνωσης (υπόλοιπο, ιστορικό κλήσεων, λίστα αριθμών) τα εκτελεί απευθείας χωρίς ερώτηση - δεν διακινδυνεύετε τίποτα.

Δύο πράγματα το MCP σκόπιμα δεν τα κάνει: την αποδέσμευση αγορασμένου αριθμού (DELETE /v1/numbers/{e164}) και αριθμού κινητού (DELETE /v1/sms-numbers/{e164}) γίνεται μόνο μέσω της πύλης ή του REST API, ώστε μια παρεξηγημένη πρόταση να μη σας στερήσει τον αριθμό που έχετε τυπωμένο στο φυλλάδιό σας, και το PDF του φορολογικού παραστατικού κατεβαίνει μόνο μέσω REST (τα ίδια τα τιμολόγια τα διαβάζουν τα εργαλεία list_billing_documents και get_billing_document, τα στοιχεία τιμολόγησης αλλάζει το update_billing_details). Ομοίως, η λήψη της ηχογράφησης κλήσης δεν έχει δικό της εργαλείο - είναι αρχείο ήχου, όχι JSON, και κατεβαίνει με το ίδιο κλειδί API απευθείας από το REST.

Ολόκληρη η διαδικασία, μαζί με τις ιδιότητες ασφάλειας κάθε εργαλείου (για τι ρωτά ο επεξεργαστής προτού ενεργήσει), βρίσκεται στη σελίδα Διακομιστής MCP· οι τιμές ανά λεπτό και ανά SMS στον τιμοκατάλογο.

Τι ακολουθεί