Koble Ringhum til Claude og andre AI-verktøy (MCP)

Ringhum har en MCP-server. MCP (Model Context Protocol) er en standardisert måte for AI-apper å bruke eksterne verktøy på. Når du har koblet Ringhum til en AI-app som Claude eller ChatGPT, kan du stille den spørsmål om arbeidsområdet ditt på vanlig språk. For eksempel: «Oppsummer gårsdagens tapte samtaler», «Hvilke innringere ba om en tilbakeringing denne uken?» eller «Legg til de nye åpningstidene våre i de ofte stilte spørsmålene». AI-appen jobber gjennom de samme reglene og tillatelsene som Ringhum-API-et.

Hva du trenger

• Server-URL: https://ringhum.com/mcp. Den vises også i kortet MCP-server på Utviklere-siden, med en Kopier-knapp.
• En AI-app som støtter eksterne MCP-servere, som Claude, ChatGPT, Claude Code, Cursor, Windsurf eller VS Code.
• Rollen Eier eller Admin i arbeidsområdet. Bare eiere og administratorer kan koble til en app eller opprette en API-nøkkel.

Det finnes to måter å koble til på. Å logge inn er enklest og passer for chat-apper som Claude og ChatGPT. En API-nøkkel passer for utviklerverktøy som tar en URL og en header.

Skrivebeskyttet eller les-og-endre-tilgang

Du bestemmer hvor mye AI-appen kan gjøre.

Med skrivebeskyttet tilgang tilbys ikke verktøyene som endrer ting, til appen i det hele tatt.

Viktig: Med endringstilgang kan AI-appen sende ekte meldinger og ringe ekte samtaler til kundene dine. Ringhum merker disse verktøyene som at de når utenfor arbeidsområdet ditt, og slettinger som destruktive, så de fleste AI-apper spør deg før de kjører dem. Les hva appen er i ferd med å gjøre, før du godkjenner det.

Koble til Claude ved å logge inn

1. I Claude (på nett, desktop eller mobil) åpner du Settings → Connectors og velger Add custom connector.
2. Lim inn https://ringhum.com/mcp som URL-en og lagre.
3. Klikk på Connect. En Ringhum-side åpnes. Logg inn hvis du blir bedt om det.
4. På Koble til-siden velger du Arbeidsområde appen kan bruke.
5. Under Hva den kan gjøre velger du Slå opp ting eller Slå opp ting og gjøre endringer.
6. Klikk på Tillat. Du sendes tilbake til Claude.

Appen ser aldri passordet ditt. De eksakte menynavnene i Claude kan endre seg over tid; se etter connectors eller integrasjoner i innstillingene der.

ChatGPT: legg til URL-en som en tilpasset connector (MCP-server) under Settings → Apps & Connectors, klikk deretter på Connect og følg steg 3 til 6.

Claude Code: kjør kommandoen under, kjør deretter /mcp og velg Authenticate.

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

Etter at du har tillatt tilgangen, fornyer tilkoblingen seg selv så lenge du fortsetter å bruke den. Hvis appen ikke brukes på 90 dager, må du koble den til på nytt.

Koble til med en API-nøkkel

Bruk dette for verktøy som lar deg sette en forespørselheader, eller når du ikke vil logge inn.

1. På Utviklere oppretter du en API-nøkkel. Kryss av bare for read for en skrivebeskyttet tilkobling, eller read og write for å tillate endringer. Se API-nøkler og tilganger.
2. Legg til serveren i appen din med nøkkelen 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 som bare kan kjøre lokale servere, kan koble til via npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Hva verktøyene dekker

Hver operasjon i Ringhum-API-et er tilgjengelig som et verktøy: kontoen og forbruket ditt, assistenter, telefonnumre, samtaler og transkripsjoner, kontakter, avtaler og tilgjengelighet, bestillinger og produkter, romreservasjoner, innboksen, tekst- og WhatsApp-meldinger, kampanjer, webhooker, bedriftsprofilen, tjenester, ofte stilte spørsmål og kunnskapsbasen, ubesvarte spørsmål, betalingslenker, anmeldelsesforespørsler, inntekter og spambeskyttelse. Samtaleopptak er det ene unntaket: de er ikke tilgjengelige som et verktøy.

Hvert verktøy kjører den tilhørende API-forespørselen, så de samme plangrensene, valideringene og hastighetsgrensene gjelder. Verktøykall telles med i API-ets grense på 120 forespørsler i minuttet. Den fullstendige listen over verktøy finnes i MCP-delen av API-referansen på /docs.

Se og koble fra tilkoblede apper

Apper du koblet til ved å logge inn, listes på Utviklere under Tilkoblede AI-apper, med hvem som koblet dem til, deres Tilgang (Bare les eller Les og endre) og når de sist ble brukt.

For å fjerne en app klikker du på Koble fra og bekrefter. Den mister tilgangen med en gang og må godkjennes på nytt. For å endre en apps tilgang kobler du den fra og kobler den til igjen med det andre valget.

For en tilkobling gjort med en API-nøkkel, tilbakekaller du nøkkelen under API-nøkler.

Feilsøking

«Bare eiere og administratorer av et arbeidsområde kan koble til apper.» Be arbeidsområdets eier om å koble til appen, eller om å gjøre deg til administrator. Se Inviter teamet ditt.

«Innloggingsforespørselen utløp. Start tilkoblingen på nytt fra AI-appen din.» Godkjenningssiden var åpen for lenge. Start på nytt fra AI-appen.

Appen sier at den ikke er autorisert, eller ber deg logge inn på nytt. Appen ble koblet fra, nøkkelen ble tilbakekalt, eller du er ikke lenger medlem av arbeidsområdet. Koble den til på nytt.

Appen kan ikke gjøre endringer. Den ble koblet til med skrivebeskyttet tilgang, eller API-nøkkelen dens mangler tilgangen write.

Appen ser på feil arbeidsområde. Be den kalle who_am_i for å sjekke. Hver tilkobling bruker ett arbeidsområde. Koble den fra og koble til igjen for å velge et annet.