Verbinden Sie Ringhum mit Claude und anderen KI-Tools (MCP)

Ringhum hat einen MCP-Server. MCP (Model Context Protocol) ist ein Standardweg für KI-Apps, externe Tools zu nutzen. Sobald Sie Ringhum mit einer KI-App wie Claude oder ChatGPT verbinden, können Sie ihr in normaler Sprache Fragen zu Ihrem Workspace stellen. Zum Beispiel: "Fasse die verpassten Anrufe von gestern zusammen", "Welche Anrufer haben diese Woche um einen Rückruf gebeten?" oder "Füge unsere neuen Öffnungszeiten zu den FAQs hinzu". Die KI-App arbeitet nach denselben Regeln und Berechtigungen wie die Ringhum-API.

Was Sie benötigen

• Server-URL: https://ringhum.com/mcp. Sie wird auch in der Karte MCP-Server auf der Seite Entwickler angezeigt, mit einer Schaltfläche Kopieren.
• Eine KI-App, die entfernte MCP-Server unterstützt, etwa Claude, ChatGPT, Claude Code, Cursor, Windsurf oder VS Code.
• Die Rolle Owner oder Admin im Workspace. Nur Owner und Admins können eine App verbinden oder einen API-Schlüssel erstellen.

Es gibt zwei Wege zu verbinden. Anmelden ist am einfachsten und eignet sich für Chat-Apps wie Claude und ChatGPT. Ein API-Schlüssel eignet sich für Entwickler-Tools, die eine URL und einen Header erwarten.

Nur-Lese- oder Lese-und-Änderungs-Zugriff

Sie legen fest, wie viel die KI-App tun darf.

Bei Nur-Lese-Zugriff werden der App die Tools, die etwas ändern, gar nicht erst angeboten.

Wichtig: Bei Änderungszugriff kann die KI-App echte Nachrichten senden und echte Anrufe bei Ihren Kunden tätigen. Ringhum kennzeichnet diese Tools als über Ihren Workspace hinausreichend und Löschungen als destruktiv, sodass die meisten KI-Apps Sie vorher um Zustimmung bitten. Lesen Sie, was die App vorhat, bevor Sie zustimmen.

Claude durch Anmelden verbinden

1. Öffnen Sie in Claude (im Web, auf dem Desktop oder mobil) Einstellungen → Connectoren und wählen Sie Benutzerdefinierten Connector hinzufügen.
2. Fügen Sie https://ringhum.com/mcp als URL ein und speichern Sie.
3. Klicken Sie auf Verbinden. Eine Ringhum-Seite öffnet sich. Melden Sie sich an, falls Sie dazu aufgefordert werden.
4. Wählen Sie auf der Seite Verbinden den Workspace, den die App nutzen darf.
5. Wählen Sie unter Was sie tun darf zwischen Nachschlagen oder Nachschlagen und Änderungen vornehmen.
6. Klicken Sie auf Erlauben. Sie werden zurück zu Claude geleitet.

Die App sieht Ihr Passwort nie. Die genauen Menübezeichnungen in Claude können sich mit der Zeit ändern; suchen Sie in dessen Einstellungen nach Connectoren oder Integrationen.

ChatGPT: Fügen Sie die URL unter Einstellungen → Apps & Connectoren als benutzerdefinierten Connector (MCP-Server) hinzu, klicken Sie dann auf Verbinden und folgen Sie den Schritten 3 bis 6.

Claude Code: Führen Sie den folgenden Befehl aus, dann führen Sie /mcp aus und wählen Sie Authenticate.

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

Nachdem Sie den Zugriff erlaubt haben, erneuert sich die Verbindung von selbst, solange Sie sie weiterhin nutzen. Wird die App 90 Tage lang nicht genutzt, müssen Sie sie erneut verbinden.

Mit einem API-Schlüssel verbinden

Verwenden Sie dies für Tools, die einen Request-Header setzen lassen, oder wenn Sie sich nicht anmelden möchten.

1. Erstellen Sie unter Entwickler einen API-Schlüssel. Haken Sie nur read für eine Nur-Lese-Verbindung an, oder read und write, um Änderungen zu erlauben. Siehe API-Schlüssel und Berechtigungen.
2. Fügen Sie den Server mit dem Schlüssel im Authorization-Header zu Ihrer App hinzu.

Claude Code:

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

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

Eine App, die nur lokale Server ausführen kann, verbindet sich über npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Was die Tools abdecken

Jede Operation der Ringhum-API ist als Tool verfügbar: Ihr Konto und Ihre Nutzung, Assistenten, Telefonnummern, Anrufe und Transkripte, Kontakte, Termine und Verfügbarkeit, Bestellungen und Produkte, Zimmerreservierungen, der Posteingang, Text- und WhatsApp-Nachrichten, Kampagnen, Webhooks, das Unternehmensprofil, Leistungen, FAQs und Wissensdatenbank, unbeantwortete Fragen, Zahlungslinks, Bewertungsanfragen, Umsatz und Spam-Schutz. Anrufaufzeichnungen sind die einzige Ausnahme: Sie sind nicht als Tool verfügbar.

Jedes Tool führt die passende API-Anfrage aus, es gelten also dieselben Plan-Limits, Validierungen und Rate Limits. Tool-Aufrufe zählen zum Limit der API von 120 Anfragen pro Minute. Die vollständige Liste der Tools finden Sie im MCP-Abschnitt der API-Referenz unter /docs.

Verbundene Apps sehen und trennen

Apps, die Sie durch Anmelden verbunden haben, werden unter Entwickler unter Verbundene KI-Apps aufgelistet, mit wer sie verbunden hat, ihrem Zugriff (Nur lesen oder Lesen und ändern) und wann sie zuletzt genutzt wurden.

Um eine App zu entfernen, klicken Sie auf Trennen und bestätigen Sie. Sie verliert sofort den Zugriff und muss erneut genehmigt werden. Um den Zugriff einer App zu ändern, trennen Sie sie und verbinden Sie sie mit der anderen Auswahl erneut.

Für eine mit einem API-Schlüssel hergestellte Verbindung widerrufen Sie den Schlüssel unter API-Schlüssel.

Problembehandlung

"Nur Owner und Admins eines Workspace können Apps verbinden." Bitten Sie den Workspace-Inhaber, die App zu verbinden, oder Sie zum Admin zu machen. Siehe Laden Sie Ihr Team ein.

"Die Anmeldeanfrage ist abgelaufen. Starten Sie die Verbindung erneut von Ihrer KI-App aus." Die Genehmigungsseite war zu lange geöffnet. Beginnen Sie erneut von der KI-App aus.

Die App meldet, sie sei nicht autorisiert, oder bittet Sie, sich erneut anzumelden. Die App wurde getrennt, der Schlüssel wurde widerrufen, oder Sie sind kein Mitglied des Workspace mehr. Verbinden Sie sie erneut.

Die App kann keine Änderungen vornehmen. Sie wurde mit Nur-Lese-Zugriff verbunden, oder ihrem API-Schlüssel fehlt die Berechtigung write.

Die App schaut auf den falschen Workspace. Bitten Sie sie, who_am_i aufzurufen, um das zu prüfen. Jede Verbindung nutzt einen Workspace. Trennen Sie sie und verbinden Sie sie erneut, um einen anderen zu wählen.