Kösse össze a Ringhumot a Claude-dal és más AI-eszközökkel (MCP)

A Ringhumnak van egy MCP szervere. Az MCP (Model Context Protocol) egy szabványos módja annak, hogy az AI-alkalmazások külső eszközöket használjanak. Amint a Ringhumot egy AI-alkalmazáshoz csatlakoztatja, mint a Claude vagy a ChatGPT, hétköznapi nyelven kérdezheti a munkaterületéről. Például: „Foglald össze a tegnapi nem fogadott hívásokat”, „Mely hívók kértek visszahívást ezen a héten?” vagy „Add hozzá az új nyitvatartásunkat a GYIK-ekhez”. Az AI-alkalmazás ugyanazokon a szabályokon és jogosultságokon keresztül működik, mint a Ringhum API.

Mire van szüksége

• Szerver URL: https://ringhum.com/mcp. Ez a Fejlesztők oldal MCP szerver kártyáján is megjelenik, egy Másolás gombbal.
• Egy AI-alkalmazásra, amely támogatja a távoli MCP szervereket, mint a Claude, a ChatGPT, a Claude Code, a Cursor, a Windsurf vagy a VS Code.
• Tulajdonos vagy Admin szerepkörre a munkaterületen. Csak tulajdonosok és adminok csatlakoztathatnak alkalmazást, vagy hozhatnak létre API-kulcsot.

Kétféleképpen csatlakozhat. A Bejelentkezés a legegyszerűbb, és olyan csevegőalkalmazásoknak felel meg, mint a Claude és a ChatGPT. Egy API-kulcs olyan fejlesztői eszközöknek felel meg, amelyek egy URL-t és egy fejlécet fogadnak.

Csak olvasási vagy olvasási és módosítási hozzáférés

Ön dönti el, mennyit tehet az AI-alkalmazás.

Csak olvasási hozzáféréssel a módosító eszközök egyáltalán nem kerülnek felkínálásra az alkalmazásnak.

Fontos: Módosítási hozzáféréssel az AI-alkalmazás valódi üzeneteket küldhet és valódi hívásokat kezdeményezhet az ügyfeleinek. A Ringhum ezeket az eszközöket a munkaterületén kívülre irányulóként jelöli, a törléseket pedig romboló hatásúként, így a legtöbb AI-alkalmazás megkérdezi Önt, mielőtt futtatná őket. Olvassa el, mit készül tenni az alkalmazás, mielőtt jóváhagyja.

Claude csatlakoztatása bejelentkezéssel

1. A Claude-ban (weben, asztali vagy mobil alkalmazásban) nyissa meg a Settings → Connectors menüpontot, és válassza az Add custom connector lehetőséget.
2. Illessze be a https://ringhum.com/mcp címet URL-ként, és mentse el.
3. Kattintson a Csatlakoztatás gombra. Egy Ringhum-oldal nyílik meg. Jelentkezzen be, ha kéri.
4. A Csatlakoztatás oldalon válassza ki a Munkaterületet, amelyet az alkalmazás használhat.
5. A Mit tehet alatt válassza az Adatok lekérdezése vagy az Adatok lekérdezése és módosítások végrehajtása lehetőséget.
6. Kattintson az Engedélyezés gombra. Visszairányítjuk a Claude-ba.

Az alkalmazás sosem látja a jelszavát. A pontos menünevek a Claude-ban idővel változhatnak; keresse az összekötőket vagy integrációkat a beállításaiban.

ChatGPT: adja hozzá az URL-t egyéni összekötőként (MCP szerverként) a Settings → Apps & Connectors alatt, majd kattintson a Connect gombra, és kövesse a 3-6. lépéseket.

Claude Code: futtassa az alábbi parancsot, majd futtassa a /mcp parancsot, és válassza az Authenticate lehetőséget.

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

Miután engedélyezte a hozzáférést, a kapcsolat magától megújul, amíg tovább használja. Ha az alkalmazást 90 napig nem használja, újra csatlakoztatnia kell.

Csatlakozás API-kulccsal

Ezt olyan eszközökhöz használja, amelyek engedik egy kérésfejléc beállítását, vagy amikor nem szeretne bejelentkezni.

1. A Fejlesztők oldalon hozzon létre egy API-kulcsot. Jelölje be csak a read lehetőséget csak olvasási kapcsolathoz, vagy a read és write lehetőséget a módosítások engedélyezéséhez. Lásd: API-kulcsok és jogkörök.
2. Adja hozzá a szervert az alkalmazásához, a kulccsal az Authorization fejlécben.

Claude Code:

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

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

Egy alkalmazás, amely csak helyi szervereket tud futtatni, az npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…" paranccsal csatlakozhat.

Mit fednek le az eszközök

A Ringhum API minden művelete elérhető eszközként: a fiókja és használata, asszisztensek, telefonszámok, hívások és átiratok, kapcsolatok, időpontok és elérhetőség, rendelések és termékek, szobafoglalások, a postaláda, szöveges és WhatsApp-üzenetek, kampányok, webhookok, a cégprofil, szolgáltatások, GYIK-ek és tudásbázis, megválaszolatlan kérdések, fizetési linkek, értékeléskérések, bevétel és spamvédelem. A hívásfelvételek az egyetlen kivétel: azok nem érhetők el eszközként.

Minden eszköz a megfelelő API-kérést futtatja, így ugyanazok a csomaglimitek, validációk és sebességkorlátok érvényesek. Az eszközhívások beleszámítanak az API percenkénti 120 kérésből álló limitjébe. Az eszközök teljes listája a /docs API-referencia MCP részében található.

Csatlakoztatott alkalmazások megtekintése és leválasztása

A bejelentkezéssel csatlakoztatott alkalmazások a Fejlesztők oldalon, a Csatlakoztatott AI-alkalmazások alatt vannak felsorolva, azzal, hogy ki csatlakoztatta őket, a Hozzáférésükkel (Csak olvasás vagy Olvasás és módosítás), és mikor használták őket utoljára.

Egy alkalmazás eltávolításához kattintson a Leválasztás gombra, és erősítse meg. Azonnal elveszíti a hozzáférést, és újra jóvá kell hagyni. Egy alkalmazás hozzáférésének módosításához válassza le, majd csatlakoztassa újra a másik választással.

Egy API-kulccsal létrehozott kapcsolatnál vonja vissza a kulcsot az API-kulcsok alatt.

Hibaelhárítás

„Only owners and admins of a workspace can connect apps.” Kérje meg a munkaterület tulajdonosát, hogy csatlakoztassa az alkalmazást, vagy tegye Önt adminná. Lásd: Hívja meg csapatát.

„The sign-in request expired. Start connecting again from your AI app.” A jóváhagyó oldal túl sokáig volt nyitva. Kezdje újra az AI-alkalmazásból.

Az alkalmazás azt mondja, nincs felhatalmazva, vagy újra kéri, hogy jelentkezzen be. Az alkalmazást leválasztották, a kulcsot visszavonták, vagy Ön már nem tagja a munkaterületnek. Csatlakoztassa újra.

Az alkalmazás nem tud módosítani. Csak olvasási hozzáféréssel csatlakozott, vagy az API-kulcsából hiányzik a write jogkör.

Az alkalmazás rossz munkaterületet néz. Kérje meg, hogy hívja meg a who_am_i eszközt az ellenőrzéshez. Minden kapcsolat egy munkaterületet használ. Válassza le, és csatlakoztassa újra, hogy másikat válasszon.