Koppel Ringhum aan Claude en andere AI-tools (MCP)

Ringhum heeft een MCP-server. MCP (Model Context Protocol) is een standaardmanier waarop AI-apps externe tools kunnen gebruiken. Zodra je Ringhum koppelt aan een AI-app zoals Claude of ChatGPT, kun je er in gewone taal vragen aan stellen over je werkruimte. Bijvoorbeeld: "Vat de gemiste gesprekken van gisteren samen", "Welke bellers vroegen deze week om een terugbelverzoek?" of "Voeg onze nieuwe openingstijden toe aan de FAQ's". De AI-app werkt volgens dezelfde regels en rechten als de Ringhum API.

Wat je nodig hebt

• Server-URL: https://ringhum.com/mcp. Deze staat ook in het kaartje MCP-server op de pagina Ontwikkelaars, met een knop Kopiëren.
• Een AI-app die externe MCP-servers ondersteunt, zoals Claude, ChatGPT, Claude Code, Cursor, Windsurf of VS Code.
• De rol Eigenaar of Beheerder in de werkruimte. Alleen eigenaren en beheerders kunnen een app koppelen of een API-sleutel aanmaken.

Er zijn twee manieren om te koppelen. Inloggen is het makkelijkst en past bij chatapps zoals Claude en ChatGPT. Een API-sleutel past bij ontwikkelaarstools die een URL en een header accepteren.

Alleen-lezen of lezen-en-wijzigen toegang

Je bepaalt hoeveel de AI-app mag doen.

Bij alleen-lezen toegang worden de tools die dingen wijzigen helemaal niet aan de app aangeboden.

Belangrijk: Met wijzigingstoegang kan de AI-app echte berichten versturen en echte gesprekken plaatsen naar je klanten. Ringhum markeert deze tools als reikend buiten je werkruimte, en verwijderingen als destructief, dus de meeste AI-apps vragen je om toestemming voordat ze deze uitvoeren. Lees wat de app op het punt staat te doen voordat je goedkeurt.

Claude koppelen door in te loggen

1. Open in Claude (op het web, desktop of mobiel) Instellingen → Connectors en kies Aangepaste connector toevoegen.
2. Plak https://ringhum.com/mcp als URL en sla op.
3. Klik op Connect. Er opent een Ringhum-pagina. Log in als daarom wordt gevraagd.
4. Kies op de pagina Connect de Werkruimte die de app mag gebruiken.
5. Kies onder Wat de app mag doen voor Opzoeken of Opzoeken en wijzigen.
6. Klik op Toestaan. Je wordt teruggestuurd naar Claude.

De app ziet je wachtwoord nooit. De exacte menunamen in Claude kunnen na verloop van tijd veranderen; zoek naar connectors of integraties in de instellingen.

ChatGPT: voeg de URL toe als aangepaste connector (MCP-server) onder Instellingen → Apps & Connectors, klik daarna op Connect en volg stap 3 tot en met 6.

Claude Code: voer onderstaande opdracht uit, voer daarna /mcp uit en kies Authenticate.

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

Nadat je toegang hebt toegestaan, vernieuwt de verbinding zichzelf zolang je hem blijft gebruiken. Wordt de app 90 dagen niet gebruikt, dan moet je hem opnieuw koppelen.

Koppelen met een API-sleutel

Gebruik dit voor tools waarmee je een requestheader kunt instellen, of wanneer je niet wilt inloggen.

1. Maak op Ontwikkelaars een API-sleutel aan. Vink alleen read aan voor een alleen-lezen koppeling, of read en write om wijzigingen toe te staan. Zie API-sleutels en scopes.
2. Voeg de server toe aan je app met de sleutel in de header Authorization.

Claude Code:

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

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

Een app die alleen lokale servers kan uitvoeren, kan koppelen via npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Wat de tools dekken

Elke bewerking in de Ringhum API is beschikbaar als tool: je account en gebruik, assistenten, telefoonnummers, gesprekken en transcripten, contacten, afspraken en beschikbaarheid, bestellingen en producten, kamerreserveringen, de inbox, sms- en WhatsApp-berichten, campagnes, webhooks, het bedrijfsprofiel, diensten, FAQ's en kennisbank, onbeantwoorde vragen, betaallinks, reviewverzoeken, omzet en spambescherming. Gespreksopnames zijn de enige uitzondering: deze zijn niet beschikbaar als tool.

Elke tool voert het bijbehorende API-verzoek uit, dus dezelfde abonnementslimieten, validatie en snelheidslimieten gelden. Tool-aanroepen tellen mee voor de limiet van de API van 120 verzoeken per minuut. De volledige lijst met tools staat in het MCP-gedeelte van de API-referentie op /docs.

Gekoppelde apps bekijken en ontkoppelen

Apps die je door in te loggen hebt gekoppeld, staan op Ontwikkelaars onder Gekoppelde AI-apps, met wie ze koppelde, hun Toegang (Alleen lezen of Lezen en wijzigen) en wanneer ze voor het laatst zijn gebruikt.

Klik op Ontkoppelen en bevestig om een app te verwijderen. Deze verliest meteen de toegang en moet opnieuw worden goedgekeurd. Om de toegang van een app te wijzigen, ontkoppel je deze en koppel je hem opnieuw met de andere keuze.

Trek voor een koppeling die met een API-sleutel is gemaakt de sleutel in onder API-sleutels.

Problemen oplossen

"Alleen eigenaren en beheerders van een werkruimte kunnen apps koppelen." Vraag de eigenaar van de werkruimte om de app te koppelen, of om jou Beheerder te maken. Zie Nodig je team uit.

"De inlogaanvraag is verlopen. Begin opnieuw met koppelen vanuit je AI-app." De goedkeuringspagina stond te lang open. Begin opnieuw vanuit de AI-app.

De app zegt dat hij niet is geautoriseerd, of vraagt je opnieuw in te loggen. De app is ontkoppeld, de sleutel is ingetrokken, of je bent geen lid meer van de werkruimte. Koppel de app opnieuw.

De app kan geen wijzigingen aanbrengen. Deze is gekoppeld met alleen-lezen toegang, of de API-sleutel mist de scope write.

De app kijkt naar de verkeerde werkruimte. Vraag de app om who_am_i aan te roepen om dit te controleren. Elke koppeling gebruikt één werkruimte. Ontkoppel de app en koppel opnieuw om een andere te kiezen.