Anslut Ringhum till Claude och andra AI-verktyg (MCP)

Ringhum har en MCP-server. MCP (Model Context Protocol) är ett standardsätt för AI-appar att använda externa verktyg. När du väl anslutit Ringhum till en AI-app som Claude eller ChatGPT kan du fråga den om din arbetsyta på vanligt språk. Till exempel: "Sammanfatta gårdagens missade samtal", "Vilka uppringare bad om en återuppringning den här veckan?" eller "Lägg till våra nya öppettider i de vanliga frågorna". AI-appen arbetar genom samma regler och behörigheter som Ringhums API.

Vad du behöver

• Server-URL: https://ringhum.com/mcp. Den visas också i kortet MCP-server på sidan Utvecklare, med en Kopiera-knapp.
• En AI-app som stöder fjärranslutna MCP-servrar, till exempel Claude, ChatGPT, Claude Code, Cursor, Windsurf eller VS Code.
• Rollen Ägare eller Admin i arbetsytan. Bara ägare och administratörer kan ansluta en app eller skapa en API-nyckel.

Det finns två sätt att ansluta. Att logga in är enklast och passar chattappar som Claude och ChatGPT. En API-nyckel passar utvecklarverktyg som tar en URL och en header.

Skrivskyddad eller läs-och-ändra-åtkomst

Du väljer hur mycket AI-appen får göra.

Med skrivskyddad åtkomst erbjuds inte verktygen som ändrar saker till appen alls.

Viktigt: Med ändringsåtkomst kan AI-appen skicka riktiga meddelanden och ringa riktiga samtal till dina kunder. Ringhum märker dessa verktyg som att de når utanför din arbetsyta, och raderingar som destruktiva, så de flesta AI-appar frågar dig innan de körs. Läs vad appen är på väg att göra innan du godkänner det.

Anslut Claude genom att logga in

1. Öppna i Claude (på webben, skrivbordet eller mobilen) Inställningar → Anslutningar och välj Lägg till anpassad anslutning.
2. Klistra in https://ringhum.com/mcp som URL och spara.
3. Klicka på Anslut. En Ringhum-sida öppnas. Logga in om du blir tillfrågad.
4. På sidan Anslut väljer du Arbetsytan appen får använda.
5. Under Vad den får göra väljer du Slå upp saker eller Slå upp saker och göra ändringar.
6. Klicka på Tillåt. Du skickas tillbaka till Claude.

Appen ser aldrig ditt lösenord. De exakta menynamnen i Claude kan ändras över tid; leta efter anslutningar eller integrationer i dess inställningar.

ChatGPT: lägg till URL:en som en anpassad anslutning (MCP-server) under Inställningar → Appar och anslutningar, klicka sedan på Anslut och följ steg 3 till 6.

Claude Code: kör kommandot nedan, kör sedan /mcp och välj Autentisera.

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

Efter att du tillåtit åtkomst förnyar anslutningen sig själv så länge du fortsätter använda den. Om appen inte används på 90 dagar behöver du ansluta den igen.

Anslut med en API-nyckel

Använd detta för verktyg som låter dig ställa in en request-header, eller när du inte vill logga in.

1. Skapa på Utvecklare en API-nyckel. Kryssa bara i read för en skrivskyddad anslutning, eller read och write för att tillåta ändringar. Se API-nycklar och behörigheter.
2. Lägg till servern i din app med nyckeln i headern Authorization.

Claude Code:

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

Cursor (~/.cursor/mcp.json), Windsurf och 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 bara kan köra lokala servrar kan ansluta genom npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Vad verktygen täcker

Varje operation i Ringhums API är tillgänglig som ett verktyg: ditt konto och din användning, assistenter, telefonnummer, samtal och transkriberingar, kontakter, bokade tider och tillgänglighet, beställningar och produkter, rumsbokningar, inkorgen, sms- och WhatsApp-meddelanden, kampanjer, webhooks, företagsprofilen, tjänster, vanliga frågor och kunskapsbanken, obesvarade frågor, betallänkar, begäranden om recensioner, intäkter och skräppostskydd. Samtalsinspelningar är det enda undantaget: de är inte tillgängliga som ett verktyg.

Varje verktyg kör den matchande API-förfrågan, så samma plangränser, validering och hastighetsgränser gäller. Verktygsanrop räknas mot API:ets gräns på 120 förfrågningar i minuten. Den fullständiga listan över verktyg finns i MCP-avsnittet av API-referensen på /docs.

Se och koppla från anslutna appar

Appar du anslutit genom att logga in listas på Utvecklare under Anslutna AI-appar, med vem som anslöt dem, deras Åtkomst (Skrivskyddad eller Läsa och ändra) och när de senast användes.

För att ta bort en app, klicka på Koppla från och bekräfta. Den förlorar åtkomst omedelbart och måste godkännas igen. För att ändra en apps åtkomst, koppla från den och anslut den igen med det andra alternativet.

För en anslutning gjord med en API-nyckel, återkalla nyckeln under API-nycklar.

Felsökning

"Bara ägare och administratörer av en arbetsyta kan ansluta appar." Be arbetsytans ägare ansluta appen, eller göra dig till Admin. Se Bjud in ditt team.

"Inloggningsförfrågan gick ut. Börja ansluta igen från din AI-app." Godkännandesidan var öppen för länge. Börja om från AI-appen.

Appen säger att den inte är auktoriserad, eller ber dig logga in igen. Appen kopplades från, nyckeln återkallades, eller du är inte längre medlem i arbetsytan. Anslut den igen.

Appen kan inte göra ändringar. Den anslöts med skrivskyddad åtkomst, eller dess API-nyckel saknar behörigheten write.

Appen tittar på fel arbetsyta. Be den anropa who_am_i för att kontrollera. Varje anslutning använder en arbetsyta. Koppla från den och anslut igen för att välja en annan.