Collega Ringhum a Claude e altri strumenti IA (MCP)

Ringhum ha un server MCP. MCP (Model Context Protocol) è un modo standard con cui le app IA usano strumenti esterni. Una volta collegato Ringhum a un'app IA come Claude o ChatGPT, puoi farle domande sul tuo spazio di lavoro in linguaggio naturale. Ad esempio: "Riassumi le chiamate perse di ieri", "Quali persone hanno chiesto una richiamata questa settimana?" oppure "Aggiungi i nostri nuovi orari di apertura alle FAQ". L'app IA opera secondo le stesse regole e permessi della API di Ringhum.

Cosa ti serve

• URL del server: https://ringhum.com/mcp. È mostrato anche nella scheda Server MCP nella pagina Sviluppatori, con un pulsante Copia.
• Un'app IA che supporta server MCP remoti, come Claude, ChatGPT, Claude Code, Cursor, Windsurf o VS Code.
• Ruolo di Proprietario o Admin nello spazio di lavoro. Solo proprietari e admin possono collegare un'app o creare una chiave API.

Ci sono due modi per collegarsi. L'accesso è il più semplice e si adatta ad app di chat come Claude e ChatGPT. Una chiave API si adatta a strumenti per sviluppatori che accettano un URL e un header.

Accesso di sola lettura o lettura e modifica

Scegli tu quanto può fare l'app IA.

Con l'accesso di sola lettura, gli strumenti che modificano le cose non vengono nemmeno offerti all'app.

Importante: con l'accesso alle modifiche, l'app IA può inviare messaggi reali ed effettuare chiamate reali ai tuoi clienti. Ringhum contrassegna questi strumenti come strumenti che raggiungono l'esterno del tuo spazio di lavoro, e le eliminazioni come distruttive, così la maggior parte delle app IA ti chiede conferma prima di eseguirle. Leggi cosa sta per fare l'app prima di approvarla.

Collega Claude accedendo

1. In Claude (sul web, desktop o mobile), apri Impostazioni → Connettori e scegli Aggiungi connettore personalizzato.
2. Incolla https://ringhum.com/mcp come URL e salva.
3. Clicca su Connetti. Si apre una pagina Ringhum. Accedi se ti viene richiesto.
4. Nella pagina Collega, scegli lo Spazio di lavoro che l'app può usare.
5. In Cosa può fare, scegli Consultare oppure Consultare e apportare modifiche.
6. Clicca su Consenti. Verrai rimandato a Claude.

L'app non vede mai la tua password. I nomi esatti dei menu in Claude possono cambiare nel tempo; cerca connettori o integrazioni nelle sue impostazioni.

ChatGPT: aggiungi l'URL come connettore personalizzato (server MCP) in Impostazioni → App e connettori, poi clicca su Connetti e segui i passaggi da 3 a 6.

Claude Code: esegui il comando sotto, poi esegui /mcp e scegli Autentica.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Dopo che consenti l'accesso, il collegamento si rinnova da solo finché continui a usarlo. Se l'app non viene usata per 90 giorni, dovrai collegarla di nuovo.

Collegati con una chiave API

Usa questo metodo per gli strumenti che ti permettono di impostare un header di richiesta, oppure quando non vuoi accedere.

1. Su Sviluppatori, crea una chiave API. Seleziona solo read per un collegamento di sola lettura, oppure read e write per consentire le modifiche. Vedi Chiavi API e ambiti.
2. Aggiungi il server alla tua app con la chiave nell'header Authorization.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf e Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Un'app che può eseguire solo server locali può collegarsi tramite npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Cosa coprono gli strumenti

Ogni operazione della API di Ringhum è disponibile come strumento: il tuo account e utilizzo, assistenti, numeri di telefono, chiamate e trascrizioni, contatti, appuntamenti e disponibilità, ordini e prodotti, prenotazioni di camere, posta in arrivo, messaggi di testo e WhatsApp, campagne, webhook, profilo aziendale, servizi, FAQ e base di conoscenza, domande senza risposta, link di pagamento, richieste di recensione, ricavi e protezione dallo spam. Le registrazioni delle chiamate sono l'unica eccezione: non sono disponibili come strumento.

Ogni strumento esegue la richiesta API corrispondente, quindi si applicano gli stessi limiti del piano, la stessa validazione e gli stessi limiti di frequenza. Le chiamate agli strumenti contano ai fini del limite della API di 120 richieste al minuto. L'elenco completo degli strumenti si trova nella sezione MCP del riferimento API su /docs.

Vedere e scollegare le app collegate

Le app che hai collegato accedendo sono elencate su Sviluppatori in App di IA collegate, con chi le ha collegate, il loro Accesso (Sola lettura o Lettura e modifica) e quando sono state usate l'ultima volta.

Per rimuovere un'app, clicca su Scollega e conferma. Perde immediatamente l'accesso e deve essere approvata di nuovo. Per cambiare l'accesso di un'app, scollegala e collegala di nuovo con l'altra scelta.

Per un collegamento effettuato con una chiave API, revoca la chiave in Chiavi API.

Risoluzione dei problemi

"Solo i proprietari e gli admin di uno spazio di lavoro possono collegare app." Chiedi al proprietario dello spazio di lavoro di collegare l'app, oppure di renderti Admin. Vedi Invita il tuo team.

"La richiesta di accesso è scaduta. Ricomincia il collegamento dalla tua app IA." La pagina di approvazione è rimasta aperta troppo a lungo. Ricomincia dall'app IA.

L'app dice di non essere autorizzata, oppure ti chiede di accedere di nuovo. L'app è stata scollegata, la chiave è stata revocata, oppure non sei più membro dello spazio di lavoro. Collegala di nuovo.

L'app non riesce ad apportare modifiche. È stata collegata con accesso di sola lettura, oppure la sua chiave API non ha l'ambito write.

L'app sta guardando lo spazio di lavoro sbagliato. Chiedile di chiamare who_am_i per verificare. Ogni collegamento usa uno spazio di lavoro. Scollegala e collegala di nuovo per sceglierne un altro.