Chaterimo MCP-Server: Claude AI mit Ihrem Chatbot verbinden (2026)

Nutzen Sie Claude Desktop oder Claude Code, um Konversationen zu lesen, Analysen zu prüfen, KI-Anweisungen zu aktualisieren und Ihr Chatbot-Widget zu verwalten — direkt aus Claude heraus.

Developer API Cluster

Siehe auch: Shopify KI-Kundenservice · Bester KI-Chatbot für Shopify

Was ist MCP und warum ist es für den E-Commerce wichtig?

MCP steht für Model Context Protocol — ein offener Standard, der es Claude AI ermöglicht, sich mit externen Tools zu verbinden und Live-Daten aus Ihren Systemen in Echtzeit abzurufen. Anstatt ein Gesprächsprotokoll aus Chaterimo zu kopieren und in Claude einzufügen, fragen Sie Claude direkt: „Was sind die häufigsten Beschwerden in meinem Chatbot diese Woche?" Claude ruft die Chaterimo-MCP-Tools auf, holt die Daten ab und antwortet sofort.

Für E-Commerce-Teams verändert dies die Art und Weise, wie Sie mit Ihren Chatbot-Daten interagieren. Sie müssen sich nicht mehr in ein Dashboard einloggen, um Analysen zu prüfen, ein Ticket zu lesen oder Ihre KI-Anweisungen zu aktualisieren. Sie erledigen das direkt in einer Claude-Konversation auf Deutsch.

Der Chaterimo MCP-Server stellt 19 Tools bereit, die Chatbots, Konversationen, Produkte, Tickets, Leads und Analysen abdecken. Zwölf davon sind schreibgeschützt; sieben ermöglichen Schreibvorgänge. Sie entscheiden, welche Zugriffsebene Sie Claude gewähren, je nachdem, wie Sie sich verbinden.

Was Sie mit Chaterimo + Claude über MCP tun können

  • Claude beauftragen, aktuelle Kundenbeschwerden aus Ihrem Chatbot zusammenzufassen
  • Claude Ihren KI-System-Prompt in einem prägnanteren Stil neu schreiben lassen
  • Analysetrends der letzten 30 Tage prüfen, ohne ein Dashboard zu öffnen
  • Ihren Produktkatalog durchsuchen und Ticket-Muster in einer Konversation analysieren
  • Das KI-Modell oder die Spracheinstellung Ihres Chatbots mit einer einzigen Anweisung wechseln

Zwei Verbindungsmöglichkeiten: Claude Desktop (OAuth) vs. Claude Code CLI

Chaterimo unterstützt zwei Verbindungsmethoden. Die richtige hängt davon ab, wer sich verbindet und wie er arbeitet.

OAuth / Claude Desktop — kein Token erforderlich

Die OAuth-Endpunkte verwenden den standardmäßigen MCP-Autorisierungsflow. Sie fügen eine URL in Claude Desktop ein, autorisieren sich mit Ihrem Chaterimo-Login, und Claude erhält automatisch ein kurzlebiges Zugriffstoken. Kein API-Schlüssel zu verwalten, keine Konfigurationsdateien zu bearbeiten.

  • Vollzugriff (Lesen + Schreiben): https://www.chaterimo.com/mcp/
  • Nur Lesen (sicher für die gemeinsame Nutzung): https://www.chaterimo.com/mcp-readonly/

Geeignet für: Geschäftsinhaber, Marketingverantwortliche, Support-Manager — alle, die Claude Desktop nutzen und ihren Chatbot abfragen oder verwalten möchten, ohne Code schreiben zu müssen.

API-Schlüssel / Claude Code CLI — stdio-Transport

Die CLI-Integration verwendet FastMCP über stdio. Sie geben Ihren Chaterimo-API-Schlüssel (cha_xxx) an, der im Developer-API-Dashboard verfügbar ist, und Claude Code verbindet sich direkt mit dem MCP-Serverprozess.

Geeignet für: Entwickler, die Claude Code im Terminal nutzen und programmatischen Zugriff in ihren Workflow integrieren möchten.

Legacy-Token-URLs: Eine dritte Verbindungsmethode — direkte URL mit eingebettetem Token — ist für erweiterte Integrationen und Automatisierungspipelines verfügbar. Kontaktieren Sie den Support, wenn Sie dieses Format benötigen.

12 Dinge, die Sie über Claude lesen können (schreibgeschützte Tools)

Alle folgenden Tools sind sowohl auf dem Vollzugriffs- als auch auf dem schreibgeschützten Endpunkt verfügbar. Sie geben Claude einen vollständigen Überblick über Ihr Chaterimo-Konto, ohne etwas zu ändern.

list_chatbots read

Alle Chatbots in Ihrer Organisation mit IDs, Namen und aktuellem KI-Modell auflisten.

get_chatbot read

Vollständige Chatbot-Konfiguration: KI-Modell, System-Prompt, Temperatur, Widget-Farben, Schaltflächenbeschriftungen und alle Erscheinungseinstellungen.

list_conversations read

Konversationen nach Chatbot, Datumsbereich und Plattform filtern (Web, WhatsApp, Facebook Messenger).

get_conversation read

Vollständiges Gesprächsprotokoll mit allen Nachrichten, Zeitstempeln und Besuchermetadaten. Unterstützt Paginierung für lange Sitzungen.

search_products read

Ihren synchronisierten Produktkatalog per Schlüsselwort durchsuchen — dieselbe Hybridsuche, die Ihr Chatbot für Produktfragen verwendet.

list_products read

Alle von Ihrer E-Commerce-Plattform synchronisierten Produkte durchsuchen, einschließlich Preis, Beschreibung und Verfügbarkeit.

list_tickets read

Support-Tickets nach Status filtern: neu, in Bearbeitung, gelöst oder geschlossen. Nützlich, um offene Problemmuster zu erkennen.

get_ticket read

Vollständige Ticket-Details einschließlich Thread, Statusverlauf, zugewiesenem Agenten und verknüpfter Konversation.

list_leads read

Alle vom Chat-Widget erfassten Besucher-Leads — E-Mail, Name, Erfassungsdatum und Quell-Chatbot.

get_analytics read

Chatbot-Leistungskennzahlen für jeden Zeitraum bis zu 365 Tagen: Sitzungsanzahl, Nachrichtenvolumen, Plattformverteilung und Antwortquoten.

list_sales_rules read

Alle aktiven Sales-Agent-Regeln anzeigen — die Auslöser und Nachrichten, mit denen Ihr proaktives Sales-Widget Besucher anspricht.

get_dashboard read

Dashboard-Übersicht: Gesamtsitzungen, aktive Chatbots, Plattformverteilung und Zusammenfassung der letzten Aktivitäten.

7 Aktionen, die Claude an Ihrem Chatbot ausführen kann (Schreib-Tools)

Schreib-Tools sind nur auf dem Vollzugriffs-Endpunkt (/mcp/) verfügbar. Sie ermöglichen es Claude, echte Änderungen an Ihrer Chatbot-Konfiguration vorzunehmen — praktisch, wenn Sie Ihr Setup innerhalb einer Claude-Konversation aktualisieren möchten, ohne die Registerkarte zu wechseln.

update_chatbot_instructions write

Den KI-System-Prompt neu schreiben (max. 15.000 Zeichen). Empfohlene Länge: 15–40 Zeilen für beste Ergebnisse. Änderungen werden sofort wirksam.

update_chatbot_model write

Das KI-Modell wechseln (GPT-4o, Claude Sonnet, Gemini Flash und andere) und die Temperatur zwischen 0,1 und 1,0 einstellen.

update_chatbot_language write

Eine feste Antwortsprache festlegen oder „Automatisch" wählen, um die Sprache jedes Besuchers zu erkennen und entsprechend zu antworten.

update_chatbot_settings write

Chatbot-Namen und -Beschreibung aktualisieren, das Widget aktivieren oder deaktivieren und die Verhaltensstrenge anpassen (wie eng er den Wissensquellen folgt).

update_widget_appearance write

Widget-Farben per Hex-Code festlegen, Position ändern (links, Mitte, rechts) und den Blasenstil an Ihre Marke anpassen.

update_widget_messages write

Begrüßungsnachricht, Eingabe-Platzhaltertext, Beschriftung der „Denken"-Animation und Schaltflächenbeschriftung bearbeiten — alles für Ihre Besucher sichtbar.

retrain_chatbot write

Einen vollständigen Neutraining-Job der Wissensdatenbank auslösen. Der Chatbot indiziert alle verbundenen Quellen neu: Produkte, Dokumente und benutzerdefinierte Inhalte.

Schritt für Schritt: Claude Desktop einrichten (OAuth)

Dies ist der schnellste Weg zur Verbindung für Nicht-Entwickler. Keine Konfigurationsdateien, keine API-Schlüssel — nur ein OAuth-Flow.

  1. Öffnen Sie Claude Desktop und navigieren Sie zu Einstellungen → Integrationen (in einigen App-Versionen auch als „MCP-Server" aufgeführt).
  2. Klicken Sie auf „MCP-Server hinzufügen" und fügen Sie eine der folgenden URLs ein:
    • Vollzugriff (Lesen + Schreiben): https://www.chaterimo.com/mcp/
    • Nur Lesen: https://www.chaterimo.com/mcp-readonly/
  3. Claude Desktop öffnet eine OAuth-Autorisierungsseite in Ihrem Browser. Melden Sie sich bei Ihrem Chaterimo-Konto an und klicken Sie auf Autorisieren. Claude erhält automatisch ein kurzlebiges Token — Sie sehen es nicht und müssen es nicht speichern.
  4. Claude Desktop zeigt nun „Chaterimo" in Ihrer Tools-Liste mit einem grünen Verbindungsindikator an. Die 19 Tools (oder 12 schreibgeschützte Tools) sind jetzt verfügbar.
  5. Starten Sie eine neue Konversation und probieren Sie: „Liste meine Chatbots auf" oder „Wie lauten meine Analysen für die letzten 7 Tage?" Claude ruft die MCP-Tools auf und liefert eine formatierte Antwort.

Wann Sie den schreibgeschützten Endpunkt verwenden sollten

Verwenden Sie /mcp-readonly/, wenn Sie Claude Zugriff auf Ihre Daten gewähren möchten — Konversationen, Analysen, Tickets — ohne zu erlauben, dass Chatbot-Einstellungen geändert werden. Dies ist die richtige Wahl für Teammitglieder oder Analysten, die Daten abfragen, aber nicht Ihre Live-Chatbot-Konfiguration ändern sollen.

Schritt für Schritt: Claude Code CLI einrichten

Für Entwickler, die Claude Code im Terminal nutzen, läuft der MCP-Server als lokaler Prozess über stdio-Transport. Sie benötigen Ihren Chaterimo-API-Schlüssel aus dem Developer-API-Dashboard.

API-Schlüssel abrufen: Melden Sie sich bei Chaterimo an → Developer API → API-Schlüssel → Neuen Schlüssel erstellen. Der Schlüssel beginnt mit cha_.

Fügen Sie Folgendes zu Ihrer .claude/settings.json hinzu (oder claude_desktop_config.json für den Claude Desktop CLI-Modus):

// .claude/settings.json or claude_desktop_config.json { "mcpServers": { "chaterimo": { "command": "python", "args": ["-m", "developer_api.mcp_server"], "env": { "CHATERIMO_API_KEY": "cha_your_key_here" } } } }

Oder führen Sie den Server direkt in einer Terminal-Sitzung für schnelle Tests aus:

# Set your key and start the MCP server process CHATERIMO_API_KEY=cha_xxx python -m developer_api.mcp_server

Nach der Verbindung kann Claude Code während einer Sitzung alle 19 Chaterimo-Tools aufrufen. Die Tool-Ausgaben werden inline angezeigt, während Claude Daten aus Ihrem Konto abruft.

Halten Sie Ihren API-Schlüssel privat

Ihr cha_xxx-Schlüssel gewährt dieselbe Zugriffsebene wie Ihr Chaterimo-Login für API-Operationen. Übertragen Sie ihn nicht in die Versionsverwaltung. Für gemeinsam genutzte Umgebungen oder Team-Kontexte, in denen kein Schreibzugriff gewünscht ist, erstellen Sie einen separaten schreibgeschützten API-Schlüssel im Developer-API-Dashboard und verwenden Sie diesen stattdessen.

Praxisbeispiele für den Einsatz

Hier sind fünf konkrete Claude-Prompts, die zeigen, wie die MCP-Integration in der Praxis aussieht. Jeder Prompt löst automatisch bestimmte Chaterimo-Tools aus.

  1. „Liste alle meine Chatbots auf und sag mir, welcher in diesem Monat die meisten Konversationen hatte."
    Claude ruft list_chatbots auf, um Ihre Chatbot-IDs zu erhalten, und ruft anschließend get_analytics für jeden mit einem 30-Tage-Zeitraum auf. Es vergleicht die Sitzungsanzahlen und gibt eine priorisierte Zusammenfassung mit dem Spitzenreiter zurück.
  2. „Zeig mir die letzten 10 Konversationen, in denen ein Kunde das Wort 'Rückgabe' erwähnt hat."
    Claude ruft list_conversations auf, um die neuesten Sitzungen zu durchlaufen, und anschließend get_conversation für Kandidaten. Es filtert Protokolle nach dem Schlüsselwort und präsentiert Auszüge mit Zeitstempeln und Chatbot-Namen.
  3. „Schreibe die Anweisungen für Chatbot Nr. 3 prägnanter und freundlicher um."
    Claude ruft get_chatbot auf, um den aktuellen System-Prompt zu lesen, schlägt in der Konversation eine überarbeitete Version zur Prüfung vor und ruft nach Ihrer Bestätigung update_chatbot_instructions auf, um sie anzuwenden.
  4. „Wechsle meinen Haupt-Chatbot zu GPT-4o mit Temperatur 0,3."
    Claude ruft list_chatbots auf, um zu ermitteln, welcher Chatbot als primär markiert ist, und ruft anschließend update_chatbot_model mit dem Zielmodell und dem Temperaturwert auf. Die Änderung tritt sofort in Kraft.
  5. „Was sind meine wichtigsten Support-Tickets gerade und welche Muster erkennst du?"
    Claude ruft list_tickets gefiltert nach Status new und in_progress auf, dann get_ticket für jeden offenen Eintrag. Es gruppiert Tickets nach Thema, identifiziert wiederkehrende Probleme und fasst die häufigsten Kundenanliegen in einem strukturierten Bericht zusammen.

Nur Lesen vs. Vollzugriff: Was sollten Sie verwenden?

Die richtige Wahl hängt von Ihrer Rolle ab und davon, wie viel Claude verändern darf. Im Zweifel beginnen Sie mit dem schreibgeschützten Zugriff und erweitern ihn bei Bedarf.

Nur Lesen Vollzugriff
Konversationen, Analysen, Leads anzeigen Ja Ja
Chatbot-Konfiguration und Produkte lesen Ja Ja
Chatbot-Anweisungen aktualisieren Nein Ja
KI-Modell oder Sprache ändern Nein Ja
Widget-Erscheinungsbild anpassen Nein Ja
Neutraining auslösen Nein Ja
Endpunkt (OAuth) /mcp-readonly/ /mcp/
Geeignet für Analysten, Teammitglieder Eigentümer, Entwickler

Ratenlimits nach Plan

MCP-Tool-Aufrufe werden auf Ihr Developer-API-Kontingent angerechnet. Jeder Tool-Aufruf — ob Claude ihn automatisch während einer Konversation ausführt oder Sie ihn manuell auslösen — zählt als ein API-Aufruf.

Plan Aufrufe pro Minute Aufrufe pro Tag
Kostenlos 5 5
Testversion 10 100
Kostenpflichtig 30 1.000

Alle Tool-Aufrufe werden in Ihrem Chaterimo-Dashboard unter Developer API → MCP-Sitzungen protokolliert. Sie können prüfen, welche Tools wann aufgerufen wurden und wie viele Aufrufe in Ihrem Tageskontingent noch verbleiben.

Alles an einem Ort

Der Chaterimo MCP-Server verbindet Claude mit Ihren Live-Chatbot-Daten — Konversationen, Analysen, Produkte, Tickets und Konfiguration — ohne Kopieren und Einfügen oder Tab-Wechsel. Ob Sie Claude Desktop mit OAuth oder Claude Code mit einem API-Schlüssel verwenden, dieselben 19 Tools stehen zur Verfügung, um Ihren Chatbot auf Deutsch abzufragen und zu verwalten.

  • Keine Konversationsprotokolle mehr in Claude kopieren
  • Natürlichsprachliche Fragen zur Chatbot-Leistung stellen
  • Chatbot-Anweisungen direkt aus einer Claude-Konversation heraus aktualisieren
  • Funktioniert mit Claude Desktop (OAuth) und Claude Code (API-Schlüssel)
  • Schreibgeschützter Endpunkt für die sichere gemeinsame Nutzung im Team
Kostenlos starten Developer API Dokumentation

Copyright © Chaterimo

about-icon