> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# KI-Tools verbinden (MCP)

> Nutze Claude, ChatGPT, Cursor und andere KI-Tools mit deinen Chatarmin CX Daten.

Verbinde Claude, ChatGPT, Cursor, VS Code oder Codex mit deinen Chatarmin CX Workspaces. Dein KI-Tool beantwortet dann Fragen zu deinen Support-Zahlen, liest Tickets, zeigt, wie die KI gearbeitet hat, und entwirft Torben AI Playbooks, die du prüfst. Wenn du es erlaubst, antwortet es Kunden auch in deinem Namen.

Dafür nutzen wir das Model Context Protocol (MCP). Die Server-Adresse:

```
https://api.armin.cx/mcp
```

## Wer verbinden kann

Workspace-Admins, in Workspaces mit freigeschalteten KI-Tool-Verbindungen. Beim Zustimmen wählst du die Workspaces, die die Verbindung abdeckt, und den Zugriff in jedem davon. Sie arbeitet mit deinen Admin-Rechten, nur in diesen Workspaces.

Deckt eine Verbindung mehrere Workspaces ab, listet dein KI-Tool sie zuerst und arbeitet dann jeweils in einem. Sag, welchen Workspace du meinst, sonst fragt es nach.

## Was dein KI-Tool kann

| Zugriff | Was dazugehört |
| - | - |
| Analytics lesen | Ticket-Volumen, Backlog, Antwort- und Lösungszeiten, CSAT und Automatisierungsrate, pro Posteingang, Kanal, Agent oder Team. |
| Tickets lesen | Tickets mit Nachrichten und Kontakten, Ticket-Felder, Ansichten, Makros und die Bestellungen eines Tickets. Das umfasst Kundennachrichten. |
| KI-Setup und Leistung lesen | KI-Agenten und Torben AI Playbooks mit Triggern, Entwürfen, Skills, Tests und Runs, die Aktionen, die Agenten nutzen können, und deine Custom-HTTP-Aktionen (Namen, Beschreibungen, Parameter und Host, nie URLs, Header oder Secrets). Details mit Kundennachrichten brauchen zusätzlich Tickets lesen. |
| Regeln, Workflows und Wissen lesen | Ticket-Regeln, klassische Workflows, Help-Center-Artikel, Wissensquellen mit den Wissens-Agenten, denen sie gehören, und ihrem Trainingsstatus, Torben-AI-Wissensdatenbanken mit ihren Quellen und gelernte Wissensdatenbank-Antworten. Gelernte Antworten zitieren Team-Antworten und brauchen deshalb zusätzlich Tickets lesen. |
| KI-Verbrauch lesen | Verbrauchte KI-Credits und was Credits über deinen Tarif hinaus kosten, pro Abrechnungszeitraum, Agent und Run. Keine Rechnungen oder Zahlungslinks. |
| Tickets bearbeiten | Status, Priorität, Tags, Zuweisung, Ticket-Felder, interne Notizen, Antwortentwürfe, die dein Team sendet, und das Zusammenführen doppelter Tickets oder Kontakte. Braucht zusätzlich Tickets lesen. |
| Ansichten, Tags und Makros bearbeiten | Ansichten, Tags und Makros für das ganze Team anlegen, ändern und löschen. Braucht zusätzlich Tickets lesen. |
| KI-Agenten und Playbooks bearbeiten | KI-Agenten und ihre Skills anlegen, bearbeiten, testen, ein- oder ausschalten und archivieren. Mit Torben AI: Playbook-Entwürfe erstellen und bearbeiten, Routing prüfen und Testläufe starten. Ein aktiver Agent antwortet Kunden; Playbooks aktivierst du in Chatarmin CX. Braucht zusätzlich KI-Setup und Leistung lesen. |
| Wissen bearbeiten | Webseiten, Texte und Q\&As zu dem Wissen hinzufügen, aus dem die KI antwortet: zum Wissen eines KI-Agenten oder zu einer Torben-AI-Wissensdatenbank. Jede Ergänzung braucht eine Bestätigung im Aufruf. Braucht zusätzlich Regeln, Workflows und Wissen lesen. |
| Antworten senden und KI-Aktionen freigeben | Antworten in deinem Namen an Kunden senden und Vorschläge von KI-Agenten freigeben oder ablehnen (Antworten, Erstattungen und andere Aktionen). Nie vorausgewählt. Braucht zusätzlich Tickets lesen; Freigaben brauchen außerdem KI-Setup und Leistung lesen. |
| Neue E-Mail-Tickets | E-Mail-Tickets für bestehende Kontakte erstellen und ihre erste E-Mail in deinem Namen senden. Jedes neue Ticket braucht eine Bestätigung im Aufruf. Nie vorausgewählt. Braucht zusätzlich Tickets lesen. |

Jeder Lesezugriff außer KI-Verbrauch lesen umfasst außerdem die Listen von Posteingängen, Tags, Teams und Ansichten: Die anderen Tools brauchen ihre IDs. Die Liste der Mitglieder (Namen und E-Mails) gibt es nur mit Analytics lesen und Tickets lesen. Ein Schreibzugriff funktioniert nur zusammen mit dem Lesezugriff, den er nennt; der listet die Tickets, Agenten oder Playbooks, die er ändert.

**Tickets lesen** enthält Kontaktdaten: Namen, E-Mail-Adressen und Telefonnummern deiner Kunden, auch in den Kontakt-Tools. Einen Zugriff auf Tickets ohne Kontaktdaten gibt es nicht. Dein KI-Tool sieht nur die Tools, die die Verbindung erlaubt, und Chatarmin CX prüft jeden Aufruf erneut. Ohne Schreibzugriffe gibt es also keine Schreib-Tools, auch keine neu hinzugekommenen.

Dein KI-Tool schreibt Kunden nur mit **Antworten senden und KI-Aktionen freigeben** oder **Neue E-Mail-Tickets**. Es sendet in deinem Namen, über den Kanal des Tickets mit dessen Signatur, und jedes Senden und jede Freigabe braucht eine Bestätigung im Aufruf. Ablehnen sendet nichts. Mit **Neue E-Mail-Tickets** ist ein neues Ticket immer ein E-Mail-Ticket aus einem deiner E-Mail-Posteingänge an einen Kontakt, dessen E-Mail-Adresse schon in Chatarmin CX ist; es legt keine Kontakte an, und ein Ticket als interne Notiz sendet nichts. **Antworten senden und KI-Aktionen freigeben** allein startet nie ein neues Ticket. Bei WhatsApp kann es nach Ablauf des 24-Stunden-Fensters nicht antworten: Sende dann eine freigegebene Vorlage aus Chatarmin CX. Ohne diesen Zugriff kann es mit **Tickets bearbeiten** eine Antwort als Entwurf für dein Team speichern: Er erscheint als Vorschlag im Antwort-Editor des Tickets, markiert mit **Entwurf von**, deinem Namen und dem Namen der App, und dein Team bearbeitet und sendet ihn. Entwürfe verbrauchen keine KI-Credits. Im Posteingang zeigen Antworten, die es gesendet hat, **Gesendet über** und den Namen der App.

Schreibzugriffe sind beim Zustimmen nicht vorausgewählt; wähle nur, was das Tool braucht. Wählst du einen Schreibzugriff, wird der Lesezugriff, den er braucht, mit ausgewählt. Änderungen daran, was Kunden bekommen (Anweisungen oder Status eines Agenten, ein Skill, ein Makro), brauchen eine ausdrückliche Bestätigung im Aufruf, und Chatarmin CX weist dein KI-Tool an, die Änderung zu zeigen und auf dein Go zu warten. Ob wirklich eine Person zugestimmt hat, kann Chatarmin CX nicht prüfen: Das hängt von deinem KI-Tool ab. Lass dort die Bestätigung für Schreib-Tools an und schalte das automatische Zulassen für sie aus. Torben AI Playbooks, die es erstellt, sind Entwürfe; du aktivierst sie in Chatarmin CX.

Mit **Wissen bearbeiten** fügt dein KI-Tool Wissen dort hinzu, wo du es nennst. Ein Workspace kann zwei Arten haben: das Wissen des Wissens-Agenten eines KI-Agenten, das KI-Agenten durchsuchen, und mit Torben AI Wissensdatenbanken, die Torben AI Playbooks durchsuchen. Passen beide, fragt dein KI-Tool, welches du meinst. Neues Wissen wird im Hintergrund trainiert: KI-Agenten und Torben nutzen es erst, wenn das Training fertig ist, und dein KI-Tool kann den Status prüfen. Dateien und ganze Websites für einen KI-Agenten fügst du in Chatarmin CX hinzu.

## Verbinden

> [tab] Claude
>
> Öffne in Claude **Settings → Connectors → Add custom connector**, füge `https://api.armin.cx/mcp` ein und verbinde. Melde dich bei Chatarmin CX an, wähle die Workspaces und erlaube den Zugriff.

> [tab] ChatGPT
>
> In ChatGPT im Web:
>
> 1. Öffne **Plugins → Add → Add custom MCP server**.
> 2. Gib einen Namen und die Server-URL `https://api.armin.cx/mcp` ein und setze **Authentication** auf **OAuth**.
> 3. Setze den Haken bei **I understand and want to continue** und klicke einmal auf **Create as a plugin**. Ein zweiter Klick meldet, dass die App bereits existiert.
> 4. Öffne das Plugin, klicke auf **Connect** und bestätige. Die Anmeldeseite öffnet sich im selben Tab.
>
> Manche ChatGPT-Accounts zeigen noch den älteren Pfad (**Settings → Apps & Connectors → Advanced → Developer mode**). Wenn das bei dir so ist, nutze diesen Pfad mit derselben URL und OAuth.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --scope user --transport http chatarmin-cx https://api.armin.cx/mcp
> ```
>
> Starte danach eine neue Claude-Code-Sitzung, führe `/mcp` aus und melde dich an.

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add chatarmin-cx --url https://api.armin.cx/mcp
> codex mcp login chatarmin-cx
> ```

> [tab] Cursor und VS Code
>
> Öffne in Chatarmin CX **Einstellungen → MCP** und nutze den Button **Cursor** oder **VS Code**.

Tools ohne OAuth-Anmeldung nutzen einen persönlichen Zugriffstoken. Erstelle ihn unter **Einstellungen → MCP** und sende ihn als `Authorization: Bearer <token>`. Der Token wird nur einmal angezeigt.

## Ausprobieren

Frag dein KI-Tool zum Beispiel:

* „Wie lief unser Support letzte Woche im Vergleich zur Woche davor?"
* „Warum hat die KI Ticket #1234 übergeben?"
* „Welche Torben Playbooks scheitern diesen Monat am häufigsten, und warum?"
* „Entwirf ein Playbook für ‚Wo ist meine Bestellung'-Anfragen und teste es an einem aktuellen Ticket."

Die meisten KI-Tools zeigen außerdem fertige Prompts von Chatarmin CX, zum Beispiel **Support report** und **AI performance review**.

Du richtest einen eigenen Agenten oder System-Prompt ein? Chatarmin CX liefert Anleitungen über das Tool `cx_guide`: `start` (zuerst lesen), `entities`, `tickets`, `agents`, `playbooks`, `reporting` und `glossary`. Der Server bittet dein KI-Tool, zuerst `start` zu lesen; tut es das nicht, sag es ihm.

Für Claude und Claude Code bietet **Einstellungen → MCP** dieselben Anleitungen und Regeln auch als Skill-Paket: **Skill-Paket herunterladen** liefert ein ZIP für den Skill-Upload in Claude, und die Zeile für Claude Code entpackt es nach `~/.claude/skills`. Es enthält keine Workspace-Daten und kein Token.

## Trennen

Öffne **Einstellungen → MCP** im Workspace und wähle **Trennen** neben der App oder dem Token. Sie verliert sofort den Zugriff auf diesen Workspace; andere Workspaces, die sie abdeckt, behalten ihren. Eine Verbindung hört außerdem in jedem Workspace auf, in dem die Person, die verbunden hat, kein Admin mehr ist.

## Fehlerbehebung

* **„Only workspace admins can connect"**: Bitte einen Admin, zu verbinden oder deine Rolle zu ändern.
* **„Not enabled for this workspace yet"**: KI-Tool-Verbindungen werden schrittweise freigeschaltet. Melde dich bei deinem Chatarmin-Kontakt.
* **Playbook-Tools fehlen**: Torben AI ist für den Workspace noch nicht aktiv, oder der Verbindung fehlen dort **KI-Agenten und Playbooks bearbeiten** und **KI-Setup und Leistung lesen**. Verbinde neu und erlaube beides.
* **Schreib-Tools fehlen**: Ein Schreibzugriff braucht seinen Lesezugriff im selben Workspace (siehe Tabelle). Verbinde neu und erlaube beides.
* **Tools für Wissensdatenbanken fehlen**: Wissensdatenbanken brauchen Torben AI im Workspace. Ohne Torben AI fügt dein KI-Tool Wissen nur KI-Agenten hinzu.
* **Dein KI-Tool kann nicht antworten oder freigeben**: Die Verbindung braucht in diesem Workspace **Antworten senden und KI-Aktionen freigeben**, Freigaben außerdem **KI-Setup und Leistung lesen**. Verbinde neu und wähle sie aus.
* **Ein Workspace fehlt**: Verbinde die App neu und wähle ihn beim Zustimmen aus. Neu verbinden ersetzt die bisherige Verbindung, wähle also alle gewünschten Workspaces.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.