Re:amaze MCP mit Gemini CLI verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Re:amaze klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Re:amaze + Gemini

Der Re:amaze-Helpdesk in jedem KI-Agent: Konversationen aus E-Mail, Chat und sozialen Kanälen lesen und beantworten, Antworten und interne Notizen schreiben, Kontakte und ihre Notizen verwalten, dazu FAQ-Artikel, Kanäle, Mitarbeitende, Antwortvorlagen, Zufriedenheitsbewertungen und Support-Berichte.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

REAMAZE_BRAND, REAMAZE_LOGIN_EMAIL, REAMAZE_API_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein Re:amaze-Konto mit einem Mitarbeiter-Benutzer, dessen API-Token der Connector verwendet, und den Host-Namen der Marke.

1. Öffne in Re:amaze Settings, Developer, API Token und klicke auf Generate New Token. Kopiere das Token in REAMAZE_API_TOKEN. Jeder Mitarbeiter-Benutzer hat sein eigenes Token, und der Connector handelt als dieser Benutzer.
2. Setz REAMAZE_LOGIN_EMAIL auf die E-Mail-Adresse, mit der sich genau dieser Benutzer bei Re:amaze anmeldet. Ein Token funktioniert nur zusammen mit der E-Mail des Benutzers, der es erzeugt hat.
3. Setz REAMAZE_BRAND auf den Host-Namen der Marke: den Teil vor .reamaze.io in der Adresse der Marke, zu sehen unter Settings, Brand Settings. Für mybrand.reamaze.io ist das mybrand: nur der Name aus Buchstaben, Ziffern und Bindestrichen, ohne https:// und ohne .reamaze.io.
4. Installiere den Connector. Prüfe die Verbindung mit reamaze_list_channels: Es listet die Kanäle der Marke mit ihren Slugs, die andere Tools als category verwenden.

Cloud und Self-Hosting funktionieren gleich: Der Connector meldet sich per HTTP Basic über HTTPS an, mit der Login-E-Mail als Benutzername und dem API-Token als Passwort. Es gibt keine Redirect URL und keine IP-Allowlist.

Eine Marke pro Connector: Die Aufrufe gehen an https://<brand>.reamaze.io/api/v1. Konversationen, Nachrichten, Kanäle, FAQ-Artikel und Antwortvorlagen sind die dieser Marke; Kontakte und Mitarbeitende gehören zum ganzen Konto. Berichte und Zufriedenheitsbewertungen umfassen alle Marken des Kontos, solange du keine bestimmte Marke angibst. Für das Postfach einer weiteren Marke richtest du einen zweiten Connector mit deren Host-Namen ein.

Der Connector handelt als Benutzer des Tokens: Was dieser Mitarbeiter in Re:amaze sehen und tun darf, darf auch die KI. Antworten und Notizen gehen in seinem Namen raus, wenn kein anderer Absender angegeben ist. Berichte und Zufriedenheitsbewertungen brauchen die Berechtigung access_reports für diesen Benutzer.

Antworten gehen sofort raus: reamaze_create_message mit visibility 0 schickt dem Kunden sofort eine Antwort über den Kanal der Konversation (E-Mail, Chat, SMS usw.). Deshalb zeigt dir die KI den Text und wartet auf dein Ja. Mit visibility 1 entsteht eine interne Notiz, die nur Mitarbeitende sehen. Nach der Antwort eines Mitarbeiters setzt Re:amaze die Konversation auf Done, außer die KI übergibt suppress_autoresolve; Zufriedenheitsumfragen und Benachrichtigungen lassen sich ebenso unterdrücken. Eine neue Konversation über reamaze_create_conversation löst die üblichen Benachrichtigungen aus, außer suppress_notifications ist gesetzt.

Manche Änderungen ersetzen: tag_list in reamaze_update_conversation ersetzt alle Tags der Konversation, ein neuer Artikeltext ersetzt den alten, und user_data in reamaze_create_conversation ersetzt die bisherigen Datenattribute des Kunden.

IDs und Codes: Eine Konversation erkennst du an ihrem Slug (z. B. knock-knock-a1b2c3), einen Kanal an seinem Slug (z. B. support); einen Kontakt an der E-Mail-Adresse oder an der Mobilnummer im E.164-Format (+12223334444) mit dem Identifier-Typ mobile; Artikel am Slug, Antwortvorlagen an der numerischen ID. Status einer Konversation: 0 Open, 1 Responded, 2 Done, 3 Spam, 4 Archived, 5 On Hold, 6 Auto-Done, 7 AI Agent Assigned, 8 AI Agent Done, 9 Spam (AI).

Daten, Seiten und Rate Limits: Listenfilter nehmen Zeitpunkte im ISO-8601-Format; Berichte nehmen zwei Tage als YYYY-MM-DD, standardmäßig die letzten 30 Tage, höchstens ein Jahr auseinander. Listen liefern 30 Einträge pro Seite; die nächste holt die KI mit page. Die API ist pro Token und Minute begrenzt und antwortet darüber mit 429: kurz warten und erneut versuchen.

Häufige Fehler: 401 heißt, dass E-Mail oder Token falsch sind, oft weil die E-Mail nicht zu dem Benutzer gehört, der das Token erzeugt hat. 403 heißt, dass das Token funktioniert, seinem Benutzer aber eine Berechtigung fehlt (Berichte und Bewertungen brauchen access_reports). 404 heißt: unbekannter Slug oder falscher Host-Name der Marke. 422 heißt, dass Re:amaze ein Anlegen oder Ändern abgelehnt hat, etwa weil der Kontakt schon existiert; die Antwort nennt den Grund.

Was der Connector liest: Konversationen mit Betreff, Status, Tags, zuständigem Mitarbeiter, Kanal, eigenen Feldern und Followern, dazu jede Nachricht eines Verlaufs, Antworten wie interne Notizen, mit Absender, Empfängern und Anhängen; Nachrichten über alle Konversationen nach Absender, Kanal, Tag oder Datum; Kontakte mit ihren Identitäten (E-Mail, Mobilnummer, Social-Media-Konten) und Notizen; FAQ-Artikel, veröffentlicht, als Entwurf oder intern; Kanäle und ihre Einstellungen; Mitarbeitende und ihre Rollen; Antwortvorlagen; Zufriedenheitsbewertungen mit Kommentaren; und Berichte zu Volumen, Antwortzeiten, Mitarbeitenden, Tags und Kanälen.

Schreib-Tools sind ab der Installation aktiv: Kein Tool ist deaktiviert. Die KI kann Kunden antworten und interne Notizen anlegen (reamaze_create_message), Konversationen eröffnen (reamaze_create_conversation), deren Status, Tags, Zuständigkeit oder Kanal ändern (reamaze_update_conversation), Kontakte anlegen und ändern und Kontaktnotizen hinzufügen (reamaze_create_contact, reamaze_update_contact, reamaze_add_contact_note) sowie FAQ-Artikel anlegen und bearbeiten (reamaze_create_article, reamaze_update_article). Deaktiviere auf der Connector-Seite die Tools, die die KI nicht nutzen soll.

Nicht enthalten: Kontaktnotizen löschen oder bearbeiten, Kontaktidentitäten bearbeiten, Mitarbeiter-Benutzer anlegen, die Status Page API und Änderungen an Antwortvorlagen. Kein Tool löscht etwas.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Re:amaze-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Welche offenen Konversationen sind niemandem zugewiesen, und was möchte der jeweilige Kunde?“
• „Zeig mir den letzten Verlauf mit [email protected] und schlag eine Antwort auf Basis unserer FAQ-Artikel vor; schick sie erst, wenn ich zustimme.“
• „Füg der Konversation zur verspäteten Lieferung eine interne Notiz hinzu, dass wir den Versanddienstleister kontaktiert haben, und setz sie bis Montag auf On Hold.“
• „Wie haben sich unsere Antwortzeiten in den letzten 30 Tagen entwickelt, und wer im Team hat die meisten Antworten geschrieben?“
• „Liste die Zufriedenheitsbewertungen mit 1 oder 2 Sternen aus dem letzten Monat mit ihren Kommentaren auf.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden