Forbind Ringhum til Claude og andre AI-værktøjer (MCP)

Ringhum har en MCP-server. MCP (Model Context Protocol) er en standardmåde for AI-apps at bruge eksterne værktøjer på. Når du har forbundet Ringhum til en AI-app som Claude eller ChatGPT, kan du stille den spørgsmål om dit workspace i almindeligt sprog. For eksempel: "Opsummer gårsdagens mistede opkald", "Hvilke opkaldende bad om et tilbagekald denne uge?" eller "Tilføj vores nye åbningstider til FAQ'en". AI-appen arbejder efter de samme regler og tilladelser som Ringhum API'et.

Hvad du skal bruge

• Server-URL: https://ringhum.com/mcp. Den vises også i kortet MCP-server på siden Udviklere, med en Kopiér-knap.
• En AI-app, der understøtter eksterne MCP-servere, som Claude, ChatGPT, Claude Code, Cursor, Windsurf eller VS Code.
• Ejer- eller Admin-rolle i workspacet. Kun ejere og admins kan forbinde en app eller oprette en API-nøgle.

Der er to måder at forbinde på. Login er det nemmeste og passer til chat-apps som Claude og ChatGPT. En API-nøgle passer til udviklerværktøjer, der tager en URL og en header.

Skrivebeskyttet eller læse-og-ændre-adgang

Du vælger, hvor meget AI-appen må gøre.

Med skrivebeskyttet adgang tilbydes de værktøjer, der ændrer ting, slet ikke til appen.

Vigtigt: Med ændringsadgang kan AI-appen sende rigtige beskeder og foretage rigtige opkald til dine kunder. Ringhum markerer disse værktøjer som noget, der rækker ud over dit workspace, og sletninger som destruktive, så de fleste AI-apps spørger dig, før de kører dem. Læs, hvad appen er ved at gøre, før du godkender det.

Forbind Claude ved at logge ind

1. I Claude (på web, desktop eller mobil) skal du åbne Indstillinger → Connectors og vælge Tilføj tilpasset connector.
2. Indsæt https://ringhum.com/mcp som URL, og gem.
3. Klik på Forbind. En Ringhum-side åbner. Log ind, hvis du bliver bedt om det.
4. På siden Forbind skal du vælge det Workspace, appen må bruge.
5. Under Hvad den må gøre skal du vælge Slå ting op eller Slå ting op og lav ændringer.
6. Klik på Tillad. Du sendes tilbage til Claude.

Appen ser aldrig din adgangskode. De præcise menunavne i Claude kan ændre sig over tid; kig efter connectors eller integrationer i dens indstillinger.

ChatGPT: tilføj URL'en som en tilpasset connector (MCP-server) i Indstillinger → Apps & Connectors, klik derefter på Forbind, og følg trin 3 til 6.

Claude Code: kør kommandoen nedenfor, kør derefter /mcp, og vælg Autentificer.

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

Efter du tillader adgang, fornyer forbindelsen sig selv, så længe du bliver ved med at bruge den. Bruges appen ikke i 90 dage, skal du forbinde den igen.

Forbind med en API-nøgle

Brug dette til værktøjer, der lader dig indstille en request-header, eller når du ikke vil logge ind.

1. På Udviklere skal du oprette en API-nøgle. Sæt kun flueben ved read for en skrivebeskyttet forbindelse, eller read og write for at tillade ændringer. Se API-nøgler og scopes.
2. Tilføj serveren til din app med nøglen i Authorization-headeren.

Claude Code:

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

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

En app, der kun kan køre lokale servere, kan forbinde via npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Hvad værktøjerne dækker

Enhver operation i Ringhum API'et er tilgængelig som et værktøj: din konto og dit forbrug, assistenter, telefonnumre, opkald og transskriptioner, kontakter, aftaler og ledighed, ordrer og produkter, værelsesreservationer, indbakken, sms- og WhatsApp-beskeder, kampagner, webhooks, virksomhedsprofilen, ydelser, FAQ og videnbasen, ubesvarede spørgsmål, betalingslinks, anmodninger om anmeldelser, omsætning og spambeskyttelse. Opkaldsoptagelser er den ene undtagelse: de er ikke tilgængelige som et værktøj.

Hvert værktøj kører den matchende API-anmodning, så de samme plangrænser, validering og rate limits gælder. Værktøjskald tæller med i API'ets grænse på 120 anmodninger i minuttet. Den fulde liste over værktøjer findes i MCP-afsnittet af API-referencen på /docs.

Se og frakobl tilsluttede apps

Apps, du har tilsluttet ved at logge ind, er anført på Udviklere under Forbundne AI-apps, med hvem der tilsluttede dem, deres Adgang (Kun læs eller Læs og ændr) og hvornår de sidst blev brugt.

For at fjerne en app skal du klikke på Frakobl og bekræfte. Den mister adgang med det samme og skal godkendes igen. For at ændre en apps adgang skal du frakoble den og forbinde den igen med det andet valg.

For en forbindelse lavet med en API-nøgle skal du tilbagekalde nøglen under API-nøgler.

Fejlfinding

"Kun ejere og admins af et workspace kan forbinde apps." Bed workspacets ejer om at forbinde appen, eller om at gøre dig til Admin. Se Inviter dit team.

"Login-anmodningen udløb. Start forbindelsen igen fra din AI-app." Godkendelsessiden var åben for længe. Start igen fra AI-appen.

Appen siger, den ikke er godkendt, eller beder dig logge ind igen. Appen blev frakoblet, nøglen blev tilbagekaldt, eller du er ikke længere medlem af workspacet. Forbind den igen.

Appen kan ikke lave ændringer. Den blev forbundet med skrivebeskyttet adgang, eller dens API-nøgle mangler scopet write.

Appen kigger på det forkerte workspace. Bed den om at kalde who_am_i for at tjekke. Hver forbindelse bruger ét workspace. Frakobl den, og forbind igen for at vælge et andet.