In breve
Fai lavorare la tua AI con Telnyx: controlla saldo e consumi, elenca e cerca numeri di telefono, invia SMS e MMS, fai chiamate che leggono un messaggio, consulta registrazioni delle chiamate e record di dettaglio, verifica numeri, invia e controlla codici monouso con Verify e consulta i tuoi assistenti AI.
Configurazione guidata
Collega Telnyx a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Telnyx con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Telnyx
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Telnyx, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Telnyx + Microsoft Copilot
Fai lavorare la tua AI con Telnyx: controlla saldo e consumi, elenca e cerca numeri di telefono, invia SMS e MMS, fai chiamate che leggono un messaggio, consulta registrazioni delle chiamate e record di dettaglio, verifica numeri, invia e controlla codici monouso con Verify e consulta i tuoi assistenti AI.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
TELNYX_API_KEY
Step 1 — Ottieni le credenziali
- Accedi al Mission Control Portal su
https://portal.telnyx.com. - Apri Account settings → Keys & Credentials → API Keys e fai clic su Create API Key. La chiave inizia con
KEYe Telnyx la mostra una sola volta. - Incollala in
TELNYX_API_KEYcosì come la mostra Telnyx, senza la parola Bearer, e installa il connettore. La chiave viene inviata solo ad api.telnyx.com. - Verifica la configurazione con
telnyx_get_balance: è gratuito e mostra saldo, limite di credito e valuta.
Chi vede cosa: la chiave agisce per l'intero account Telnyx, saldo compreso. Condividi il server MCP solo con persone autorizzate a spendere su quell'account.
Costa denaro e raggiunge persone reali, quindi l'AI chiede prima: Telnyx addebita telnyx_send_message (SMS e MMS), telnyx_dial_call (al minuto), telnyx_speak_text (sintesi vocale) e telnyx_send_verification (per verifica). Prima di ognuno l'AI ti mostra destinatario, mittente e contenuto e aspetta il tuo sì. telnyx_lookup_number è a pagamento per ogni ricerca, quindi l'AI ti avvisa prima di verificare molti numeri. Inviare, chiamare e acquistare richiedono un account con credito.
Disattivato all'installazione: telnyx_order_phone_numbers, che acquista numeri con un costo iniziale e un canone mensile per numero. Un amministratore lo attiva consapevolmente; l'AI mostra poi ogni numero con i suoi costi e acquista solo dopo la tua conferma. La ricerca di numeri con telnyx_search_available_numbers è gratuita.
SMS: un numero invia SMS solo se è assegnato a un messaging profile (telnyx_list_messaging_profiles mostra i profili e i paesi verso cui ognuno può inviare). Un nuovo messaggio parte come queued; telnyx_get_message mostra in seguito lo stato di consegna per destinatario. Con link a contenuti multimediali il messaggio diventa un MMS (Stati Uniti e Canada).
Le chiamate richiedono una Call Control application: creane una nel Mission Control Portal e assegnale il numero da cui chiami. telnyx_list_call_control_applications fornisce il connection_id che serve a telnyx_dial_call. L'AI compone il numero, controlla con telnyx_get_call_status finché la chiamata non riceve risposta, legge il tuo messaggio con telnyx_speak_text e chiude con telnyx_hangup_call. Un limite di durata sulla chiamata tiene sotto controllo il costo. Gli eventi della chiamata vanno all'URL webhook dell'application, che questo connettore non riceve. Registrazioni: telnyx_list_recordings e telnyx_get_recording (i link di download scadono dopo pochi minuti).
Verify: crea una volta un Verify profile nel portale, in Verify; telnyx_list_verify_profiles lo elenca. telnyx_send_verification invia un codice via SMS, chiamata vocale o WhatsApp, e telnyx_check_verification_code controlla il codice inserito dalla persona.
Consumi e costi: telnyx_search_detail_records elenca singoli messaggi e chiamate con il loro costo; telnyx_get_usage_report_options e telnyx_get_usage_report danno i totali per prodotto fino a 31 giorni. Gli assistenti AI sono in sola lettura: telnyx_list_ai_assistants e telnyx_get_ai_assistant.
Numeri: sempre in formato E.164, cioè +, prefisso internazionale e numero senza spazi (+393471234567).
Errori comuni: 401 (10009): la chiave è errata, eliminata o è stata incollata con un prefisso; creane una nuova nel portale. 403: l'account non può ancora usare questa funzione (per esempio inviare verso un paese o acquistare numeri prima della verifica dell'account), oppure alla chiave manca il permesso. 404 (10005): la risorsa non esiste su questo account. 422: un parametro non è valido, per esempio il mittente non ha un messaging profile, la chiamata non ha ancora risposto o un numero non è in E.164. 429: troppe richieste; attendi e riprova.
Il connettore non copre portabilità dei numeri, configurazione e rilascio dei numeri, SIP trunking, TeXML, conferenze, fax, template WhatsApp, registrazione 10DLC di brand e campagne, creazione o modifica di assistenti AI e webhook.
Step 2 — Installa l'adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Telnyx. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Tool disponibili
| Tool | What it does |
|---|---|
telnyx_get_balance | Read the account balance: balance, pending, credit_limit, available_credit and currency |
telnyx_list_phone_numbers | List the phone numbers the account owns, newest first: id, phone_number (E.164), status, phone_number_type, country, the voice connection… |
telnyx_get_phone_number | Read one owned phone number by its id (from telnyx_list_phone_numbers): status, type, country, voice connection, messaging profile… |
telnyx_search_available_numbers | Search phone numbers that can be bought, by country, area, digits, type and features |
telnyx_order_phone_numbers | Buy phone numbers found with telnyx_search_available_numbers |
telnyx_get_number_order | Read a number order by its id: status (pending, success, failure), the numbers with their own status and whether the regulatory… |
telnyx_send_message | Send an SMS or MMS from a Telnyx number |
telnyx_get_message | Read one message by its id: direction, from, to with per-recipient delivery status (queued, sending, sent, delivered, sending_failed… |
telnyx_list_messaging_profiles | List the messaging profiles: id, name, enabled, webhook_url, whitelisted_destinations (countries the profile may send to), daily spend… |
telnyx_list_call_control_applications | List the Call Control applications (voice connections): id, application_name, active, webhook_event_url and outbound settings.… |
telnyx_dial_call | Place an outbound phone call through a Call Control application |
telnyx_get_call_status | Read the status of a call by its call_control_id: is_alive (false once it ended), call_duration in seconds, start_time and end_time |
telnyx_speak_text | Speak text to the other party on an answered call |
telnyx_hangup_call | Hang up a call that is still in progress |
telnyx_search_detail_records | Search detail records (CDRs and MDRs): one record per message, call leg, verification, recording and so on, with direction, numbers… |
telnyx_get_usage_report_options | List the products of the usage report and, for each, the dimensions and metrics telnyx_get_usage_report accepts (for example product… |
telnyx_get_usage_report | Get aggregated usage and cost for one product over at most 31 days, broken out by dimensions (e.g. date, direction, country) with metrics… |
telnyx_list_recordings | List call recordings, newest first: id, from, to, duration_millis, channels, status, start and end time and download_urls (mp3 and wav… |
telnyx_get_recording | Read one call recording by its id with fresh download_urls (mp3, wav), duration, channels and the call it belongs to |
telnyx_lookup_number | Look up a phone number: country, national format, E.164 form, and with type carrier the carrier name, line type (mobile, landline, voip)… |
telnyx_list_verify_profiles | List the Verify profiles: id, name, language and the settings per channel (sms, call, whatsapp, flashcall) such as code length and… |
telnyx_send_verification | Send a one-time code to a phone number by SMS, voice call or WhatsApp through a Verify profile |
telnyx_check_verification_code | Check the code a person entered against the latest verification sent to that number |
telnyx_get_verification | Read a verification by its id: phone_number, channel type, status (pending, accepted, invalid, expired, error) and when it was created |
telnyx_list_ai_assistants | List the account's Telnyx AI assistants (voice and chat agents): id, name, description, model, greeting, enabled features and creation date |
telnyx_get_ai_assistant | Read one AI assistant by its id: name, model, instructions (system prompt), greeting, tools, voice and transcription settings, telephony… |
Esempi di prompt
- "Qual è il nostro saldo Telnyx e quanto abbiamo speso in messaggi questo mese, suddiviso per paese?"
- "Invia un SMS dal nostro numero di Milano al +393471234567 per dire che l'ordine è pronto per il ritiro. Mostrami prima mittente, destinatario e testo."
- "Chiama il +393471234567 dalla nostra linea di assistenza, di' che il tecnico arriva alle 15 e poi riaggancia. Resta sotto il minuto."
- "Trova tre numeri mobili in Italia abilitati agli SMS e mostrami per ciascuno il costo iniziale e quello mensile."
- "Quali messaggi di ieri non sono stati consegnati? Controlla i record di dettaglio e mostrami stato e costo."
FAQ
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?