Conectați Ringhum la Claude și alte instrumente AI (MCP)

Ringhum are un server MCP. MCP (Model Context Protocol) este un mod standard prin care aplicațiile AI folosesc instrumente externe. Odată ce conectați Ringhum la o aplicație AI precum Claude sau ChatGPT, îi puteți pune întrebări despre spațiul dumneavoastră de lucru în limbaj natural. De exemplu: „Rezumă apelurile pierdute de ieri”, „Care apelanți au cerut un apel de revenire săptămâna aceasta?” sau „Adaugă noul nostru program de lucru la întrebările frecvente”. Aplicația AI funcționează prin aceleași reguli și permisiuni ca API-ul Ringhum.

De ce aveți nevoie

• URL-ul serverului: https://ringhum.com/mcp. Este afișat și în cardul Server MCP din pagina Dezvoltatori, cu un buton Copiază.
• O aplicație AI care suportă servere MCP la distanță, precum Claude, ChatGPT, Claude Code, Cursor, Windsurf sau VS Code.
• Rolul de Proprietar sau Admin în spațiul de lucru. Doar proprietarii și administratorii pot conecta o aplicație sau crea o cheie API.

Există două moduri de conectare. Autentificarea este cea mai simplă și se potrivește aplicațiilor de chat precum Claude și ChatGPT. O cheie API se potrivește instrumentelor de dezvoltator care folosesc un URL și un antet.

Acces doar-citire sau citire-și-modificare

Alegeți cât de mult poate face aplicația AI.

Cu acces doar-citire, instrumentele care schimbă lucruri nu sunt oferite deloc aplicației.

Important: Cu acces de modificare, aplicația AI poate trimite mesaje reale și efectua apeluri reale către clienții dumneavoastră. Ringhum marchează aceste instrumente ca depășind spațiul dumneavoastră de lucru, iar ștergerile ca distructive, astfel încât majoritatea aplicațiilor AI vă cer aprobarea înainte de a le rula. Citiți ce urmează să facă aplicația înainte de a aproba.

Conectați Claude prin autentificare

1. În Claude (pe web, desktop sau mobil), deschideți Setări → Conectori și alegeți Adaugă conector personalizat.
2. Lipiți https://ringhum.com/mcp ca URL și salvați.
3. Faceți clic pe Conectează. Se deschide o pagină Ringhum. Autentificați-vă dacă vi se cere.
4. Pe pagina Conectează, alegeți Spațiul de lucru pe care aplicația îl poate folosi.
5. La Ce poate face, alegeți Caută informații sau Caută informații și face modificări.
6. Faceți clic pe Permite. Sunteți trimis înapoi la Claude.

Aplicația nu vă vede niciodată parola. Numele exacte ale meniurilor din Claude se pot schimba în timp; căutați conectori sau integrări în setările sale.

ChatGPT: adăugați URL-ul ca un conector personalizat (server MCP) la Setări → Aplicații și conectori, apoi faceți clic pe Conectează și urmați pașii 3-6.

Claude Code: rulați comanda de mai jos, apoi rulați /mcp și alegeți Authenticate.

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

După ce permiteți accesul, conexiunea se reînnoiește singură cât timp continuați să o folosiți. Dacă aplicația nu este folosită timp de 90 de zile, va trebui să o conectați din nou.

Conectați cu o cheie API

Folosiți acest lucru pentru instrumente care vă permit să setați un antet de cerere, sau când nu doriți să vă autentificați.

1. La Dezvoltatori, creați o cheie API. Bifați doar read pentru o conexiune doar-citire, sau read și write pentru a permite modificări. Consultați Chei API și domenii de acces.
2. Adăugați serverul în aplicația dumneavoastră cu cheia în antetul Authorization.

Claude Code:

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

Cursor (~/.cursor/mcp.json), Windsurf și 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_…" }
    }
  }
}

O aplicație care poate rula doar servere locale se poate conecta prin npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Ce acoperă instrumentele

Fiecare operațiune din API-ul Ringhum este disponibilă ca instrument: contul și utilizarea dumneavoastră, asistenți, numere de telefon, apeluri și transcrieri, contacte, programări și disponibilitate, comenzi și produse, rezervări de camere, inbox-ul, mesaje text și WhatsApp, campanii, webhook-uri, profilul companiei, servicii, întrebări frecvente și baza de cunoștințe, întrebări fără răspuns, linkuri de plată, cereri de recenzie, venituri și protecție anti-spam. Înregistrările apelurilor sunt singura excepție: nu sunt disponibile ca instrument.

Fiecare instrument rulează solicitarea API corespunzătoare, așa că se aplică aceleași limite de plan, validare și limite de rată. Apelurile de instrumente contează în limita API-ului de 120 de solicitări pe minut. Lista completă a instrumentelor se află în secțiunea MCP a referinței API de la /docs.

Vedeți și deconectați aplicațiile conectate

Aplicațiile pe care le-ați conectat prin autentificare sunt listate la Dezvoltatori, sub Aplicații AI conectate, cu cine le-a conectat, Accesul lor (Doar-citire sau Citire și modificare) și când au fost folosite ultima dată.

Pentru a elimina o aplicație, faceți clic pe Deconectează și confirmați. Aceasta pierde accesul imediat și trebuie aprobată din nou. Pentru a schimba accesul unei aplicații, deconectați-o și conectați-o din nou cu cealaltă alegere.

Pentru o conexiune realizată cu o cheie API, revocați cheia la Chei API.

Depanare

„Doar proprietarii și administratorii unui spațiu de lucru pot conecta aplicații.” Cereți proprietarului spațiului de lucru să conecteze aplicația, sau să vă facă Admin. Consultați Invitați echipa dumneavoastră.

„Solicitarea de autentificare a expirat. Începeți din nou conectarea din aplicația dumneavoastră AI.” Pagina de aprobare a rămas deschisă prea mult timp. Începeți din nou din aplicația AI.

Aplicația spune că nu este autorizată, sau vă cere să vă autentificați din nou. Aplicația a fost deconectată, cheia a fost revocată, sau nu mai sunteți membru al spațiului de lucru. Conectați-o din nou.

Aplicația nu poate face modificări. A fost conectată cu acces doar-citire, sau cheii ei API îi lipsește domeniul write.

Aplicația se uită la spațiul de lucru greșit. Cereți-i să apeleze who_am_i pentru a verifica. Fiecare conexiune folosește un singur spațiu de lucru. Deconectați-o și conectați-o din nou pentru a alege altul.