Come collegare Ringostat a Cursor via MCP

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

Ringostat + Cursor

Call tracking e centralino virtuale Ringostat: registro chiamate con sorgenti di traffico, durata, stato, dipendenti e link alle registrazioni, chi è online o in chiamata, dipendenti con reparti, report SIP online giornaliero e stati di Smart Phone. La richiamata è disattivata all'installazione.

Prerequisiti

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

RINGOSTAT_AUTH_KEY, RINGOSTAT_PROJECT_ID

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti e serve un amministratore del progetto in Ringostat.

1. In Ringostat apri Settings, Integrations, Ringostat API e copia l'Auth-key in RINGOSTAT_AUTH_KEY. Appartiene a un solo progetto e viene inviata nell'header Auth-key.
2. Imposta RINGOSTAT_PROJECT_ID sul numero di quel progetto: il valore dopo project_id= o projectId= nella barra degli indirizzi della web app di Ringostat, ad esempio 39071. Lo usano solo gli strumenti per dipendenti, report SIP e stati personalizzati.
3. Installa il connettore; la verifica esegue ringostat_list_online_sip.

Cosa legge: il registro chiamate di un periodo, una riga per chiamata con le colonne che chiedi: data, numero chiamante e chiamato, tipo di chiamata, stato (disposition), durata della conversazione, durata totale e tempo di attesa, nome e reparto del dipendente, pool di numeri e schema di inoltro, flag di chiamata target e ripetuta, UTM source, medium, campaign, content e term, landing page e referrer, il motivo di una chiamata persa, valutazione CSAT, id della chiamata e link alla registrazione; gli account SIP online in questo momento e quelli in chiamata in questo momento; i dipendenti con stato SIP, nome completo, e-mail, interno, staffId, reparti e instradamenti (account SIP o numeri principali e di riserva); il tempo online e offline per dipendente e per giorno; e gli stati personalizzati di Smart Phone come Pranzo o Riunione.

Registro chiamate: ringostat_list_calls accetta from e to come YYYY-MM-DD HH:MM:SS; senza di essi restituisce le ultime 24 ore. La risposta è un unico array con tutte le chiamate del periodo, senza paginazione, quindi sui progetti molto attivi l'AI tiene i periodi brevi (un giorno o una settimana) e chiede solo i fields che servono. La durata della conversazione è billsec in secondi; call_type è in, out, callback, transitin o transitout; proper_flag e repeated_flag segnano le chiamate target e ripetute. Per le statistiche per dipendente l'AI raggruppa le righe per employee_fio e somma billsec.

Filtri e ordinamento: i filtri sono espressioni Ringostat separate da virgole, ad esempio call_type=in,billsec>=30, con =, <>, >, <, >=, <= o ~ (un'espressione regolare, codificata in base64). order ordina, ad esempio calldate desc; merge raggruppa le chiamate per numero chiamante per giorno (1) o sull'intero periodo (2).

Dati personali: i numeri di telefono e i link alle registrazioni sono dati personali. I link in recording e recording_wav restano disponibili per un anno.

Disattivato all'installazione: ringostat_start_callback avvia una vera chiamata che collega un numero del progetto a un numero di telefono o al login SIP di un dipendente. Compone subito e consuma minuti, quindi un amministratore lo attiva deliberatamente. Anche allora l'AI ti mostra entrambi i numeri e aspetta il tuo sì. I numeri sono in formato internazionale senza +.

Chiamate POST in sola lettura: elenco dei dipendenti, report SIP e stati personalizzati sono richieste POST nell'API di Ringostat, ma leggono soltanto.

Errori comuni: 401 o 403 indicano un'Auth-key mancante o errata, oppure chiave e id progetto di progetti diversi. Un errore JSON-RPC dagli strumenti per dipendenti, report o stati di solito indica un RINGOSTAT_PROJECT_ID errato; "User does not exist" significa che il filtro sui dipendenti non ha trovato nessuno.

Il connettore non modifica le impostazioni del centralino, i dipendenti, i pool di numeri o gli schemi di inoltro, e restituisce i link alle registrazioni, non l'audio.

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 Ringostat.

Tool disponibili

Esempi di prompt

• "Quante chiamate in entrata abbiamo ricevuto ieri, quante sono state perse e qual è stata la durata media della conversazione?"
• "Raggruppa le chiamate della settimana scorsa per dipendente con numero di chiamate e durata totale."
• "Quali sorgenti e campagne UTM hanno portato chiamate target questo mese?"
• "Chi è online in questo momento, e chi di loro è in chiamata?"
• "Per quanto tempo è stato online ogni dipendente, giorno per giorno, la settimana scorsa?"

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
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot