Come collegare Plivo a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Plivo, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Plivo + Cursor

Fai lavorare la tua AI con Plivo: controlla saldo e prezzi, invia SMS e MMS, fai chiamate e consulta i record delle chiamate, chiudi chiamate in corso, elenca registrazioni e trascrizioni, trova e verifica numeri di telefono, e invia e controlla codici monouso con Verify.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

PLIVO_AUTH_ID, PLIVO_AUTH_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi alla console di Plivo su https://cx.plivo.com.
2. Copia dalla pagina di panoramica l'Auth ID (inizia con MA, o con SA per un sottoaccount) e l'Auth Token. Un sottoaccount (Account → Subaccounts) limita ciò che il connettore può raggiungere.
3. Incollali in PLIVO_AUTH_ID e PLIVO_AUTH_TOKEN e installa il connettore.
4. Verifica la configurazione con plivo_get_account: mostra l'account, la modalità di fatturazione e il credito residuo.

Un account di prova basta per leggere; per inviare e chiamare servono credito e, in prova, numeri verificati.

Chi vede cosa: l'Auth Token agisce per l'intero account Plivo e può spenderne il saldo. Condividi il server MCP solo con persone autorizzate a spendere su quell'account. Log dei messaggi, record delle chiamate, numeri di telefono, registrazioni e trascrizioni sono dati personali, e chiunque abbia un link a una registrazione può ascoltarla.

Costa denaro e raggiunge persone reali, quindi l'AI chiede prima: Plivo addebita plivo_send_message (SMS e MMS, per parte di messaggio e destinatario), plivo_make_call (al minuto) e plivo_send_verification (per verifica, più l'SMS o la chiamata). Prima di ognuno l'AI ti mostra mittente, destinatario e contenuto, con il prezzo preso da plivo_get_pricing se lo chiedi, e aspetta il tuo sì. plivo_lookup_number è a pagamento per ogni ricerca, quindi l'AI ti indica numero e costo prima di verificare più di qualche numero.

Disattivati all'installazione: plivo_buy_number, che noleggia un numero con un costo di attivazione e un canone mensile finché il numero non viene rilasciato; la ricerca con plivo_search_available_numbers è gratuita. Anche plivo_hangup_call è spento: interrompe una chiamata in corso, e Plivo chiude tutte le chiamate in corso dell'account quando manca l'id della chiamata. Un amministratore li attiva consapevolmente; l'AI ti mostra poi il numero con i suoi costi, o la chiamata con numeri e ora di inizio, e agisce solo dopo la tua conferma.

SMS: plivo_send_message restituisce un message_uuid; plivo_get_message mostra lo stato di consegna, le parti fatturate e il prezzo, e plivo_list_messages riepiloga il tuo traffico (senza il testo dei messaggi). Un mittente negli Stati Uniti o in Canada deve essere registrato per 10DLC o per i messaggi da numeri toll-free, altrimenti i messaggi non partono.

Le chiamate richiedono un answer URL: plivo_make_call chiama il numero e, quando rispondono, richiama il tuo answer_url, che deve restituire Plivo XML ospitato sul tuo server (per esempio <Response><Speak>Ciao</Speak></Response>). Un time_limit tiene sotto controllo il costo. Chiamate in corso: plivo_list_live_calls e plivo_get_live_call. Chiamate concluse: plivo_list_calls e plivo_get_call, con durata, durata fatturata, prezzo e causa di chiusura. Registrazioni: plivo_list_recordings, plivo_get_recording e plivo_get_transcription quando per la registrazione è stata richiesta una trascrizione (un'opzione a pagamento di Plivo).

Verify: plivo_send_verification invia un codice monouso via SMS o chiamata vocale, plivo_validate_verification controlla il codice inserito dalla persona (ogni tentativo conta per il limite di tentativi) e plivo_get_verification mostra stato e costi.

Numeri e orari: invia i numeri in formato E.164 (+393471234567); Plivo li elenca senza il più. I filtri temporali sono in UTC nel formato YYYY-MM-DD HH:MM:SS. Le ricerche di chiamate e registrazioni coprono gli ultimi 7 giorni se non indichi un intervallo, al massimo 30 giorni per ricerca.

Limite di richieste: 300 richieste ogni 5 secondi per account; per le chiamate in uscita valgono anche un limite di chiamate al secondo e uno di chiamate simultanee (403 Concurrency Limit Breached). Un 429 significa attendere e riprovare.

Errori comuni: 401: Auth ID o Auth Token errati, oppure un token rigenerato. 403: un sottoaccount senza accesso o una restrizione IP in API access control. 404: il messaggio, la chiamata, la registrazione o il numero non esiste su questo account. 400: un parametro manca o non è valido, per esempio il formato del numero o un mittente che non appartiene all'account. Invii o chiamate che falliscono per credito insufficiente: controlla il credito con plivo_get_account e ricarica dalla console.

Il connettore non copre template WhatsApp, conferenze e chiamate con più partecipanti, trasferimento di chiamata e controllo delle registrazioni, applications ed endpoints, sottoaccount, documenti di conformità e rilascio dei numeri.

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 Cursor

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 mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Plivo.

Tool disponibili

Esempi di prompt

• "Qual è il nostro saldo Plivo e quanto costa un SMS in uscita verso l'Italia?"
• "Invia un SMS dal nostro numero Plivo al +393471234567 per confermare l'appuntamento di venerdì alle 10. Mostrami prima mittente, destinatario, testo e prezzo."
• "Quali messaggi di ieri non sono stati consegnati o sono falliti? Mostrami i codici di errore e quanto sono costati."
• "Elenca le chiamate degli ultimi 7 giorni durate più di cinque minuti, con durata fatturata, prezzo e causa di chiusura."
• "Invia un codice di verifica via SMS al +393471234567 e chiedimi conferma prima. Poi controlla il codice che il cliente mi legge."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT