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

# Chatarmin MCP

> Verbinde KI-Assistenten mit deiner Chatarmin-Organisation über das Model Context Protocol (MCP).

Mit Chatarmin MCP verbindest du einen KI-Assistenten mit deiner Organisation. Er kann Kampagnen, Kontakte, Flows, Chats und Analytics lesen – und freigegebene Aktionen wie Nachrichten senden oder Flows veröffentlichen – per natürlicher Sprache ausführen.

## Wann du es nutzt

Nutze Chatarmin MCP, wenn ein KI-Assistent (Cursor, Claude, ChatGPT, VS Code oder ähnlich) mit deinen Live-Daten in Chatarmin arbeiten soll – ohne Exporte oder ständiges Wechseln zwischen Tools.

<Tip>
  OAuth ist die empfohlene Verbindungsmethode. Du meldest dich einmal bei Chatarmin an und bestätigst den Zugriff – kein manuelles API-Token nötig.
</Tip>

## Was neu ist

Chatarmin bietet jetzt einen eigenen Bereich **MCP** in deinem Konto:

* **Profil → MCP** zeigt deine MCP-Endpoint-URL, die OAuth-Konfiguration und die Fähigkeiten deines Assistenten.
* **OAuth-Zustimmungsseite** – wenn du in deinem KI-Client auf **Connect** klickst, meldest du dich bei Chatarmin an und bestätigst den Zugriff für diesen Client (z. B. Cursor oder Claude).
* **Statisches Bearer-Token (erweitert)** – für Clients ohne OAuth nutzt du dasselbe API-Token wie unter **Profil → Einstellungen → API-Token**.

<Frame>
  <img src="https://mintcdn.com/chatarmin-help-center/lGe-w4qMajFJnjYi/images/api-documentation/profile-mcp-nav.png?fit=max&auto=format&n=lGe-w4qMajFJnjYi&q=85&s=c0d84cd35ac06b99f4b1d2cd01ab85fe" alt="Profil-Seitenleiste mit ausgewähltem MCP-Tab und Beta-Badge" width="420" height="720" data-path="images/api-documentation/profile-mcp-nav.png" />
</Frame>

Der MCP-Server-Endpoint lautet:

```
https://api.chatarmin.com/api/mcp
```

## Was dein Assistent kann

Die Tools gelten für deine Chatarmin-Organisation. Möglichkeiten:

<CardGroup cols={2}>
  <Card title="Kampagnen & Messaging" icon="bullhorn">
    Kampagnen auflisten, Metriken prüfen, Zielgruppengröße vor dem Versand schätzen, Kampagnen erstellen oder pausieren, WhatsApp-Chats lesen, Nachrichten senden und Flows auslösen.
  </Card>

  <Card title="Kontakte & Zielgruppe" icon="users">
    Kontakte suchen, Audience-Statistiken anzeigen, Tags und Segmente mit Live-Zählern listen, Tags anlegen und Segmentgrößen vorab prüfen.
  </Card>

  <Card title="Flows & Templates" icon="diagram-project">
    Flow-Entwürfe erstellen und bearbeiten, Flows veröffentlichen, Analytics und Run-Traces lesen sowie WhatsApp-Templates entwerfen oder zur Meta-Freigabe einreichen.
  </Card>

  <Card title="Analytics & Bestellungen" icon="chart-line">
    Dashboard-KPIs abrufen, Kampagnen-Performance auswerten und attribuierte Bestellungen nach Kampagne, Flow oder Kontakt suchen.
  </Card>
</CardGroup>

<Warning>
  Schreibaktionen (Nachricht senden, Flow veröffentlichen, Kampagne erstellen usw.) werden ausgeführt, wenn der Assistent ein Tool aufruft. Prüfe Prompts sorgfältig und bestätige kritische Aktionen in deinem KI-Client.
</Warning>

## Einrichtung

## Video-Walkthrough

<img src="https://mintcdn.com/chatarmin-help-center/lGe-w4qMajFJnjYi/images/api-documentation/profile-open-mcp-tab.gif?s=aa24152c65c32ecfb0f41d8c2e243a60" alt="Profil öffnen und den MCP-Tab auswählen" width="800" height="450" data-path="images/api-documentation/profile-open-mcp-tab.gif" />

<Steps>
  <Step title="MCP-Einstellungen in Chatarmin öffnen">
    Öffne in [Chatarmin](https://app.chatarmin.com/) **Profil → MCP**.

    <Frame>
      <img src="https://mintcdn.com/chatarmin-help-center/lGe-w4qMajFJnjYi/images/api-documentation/profile-mcp-settings.png?fit=max&auto=format&n=lGe-w4qMajFJnjYi&q=85&s=3017eaafe7ebab98faacc2eca539bfd1" alt="Chatarmin Profil MCP-Seite mit Funktionen und Verbindungseinstellungen" width="2880" height="1800" data-path="images/api-documentation/profile-mcp-settings.png" />
    </Frame>

    Kopiere die **MCP-Endpoint-URL** oder die **OAuth-Konfiguration** als JSON.
  </Step>

  <Step title="Server im KI-Client hinzufügen">
    Folge der Anleitung für dein Tool:

    * [Chatarmin MCP mit KI-Tools verbinden](/de/api-documentation-de/chatarmin-mcp-mit-ki-tools-verbinden-de)
  </Step>

  <Step title="Verbinden und Zugriff bestätigen">
    Klicke in deinem KI-Client auf **Connect** (oder gleichwertig). Der Browser öffnet die Chatarmin-Zustimmungsseite.

    <Frame>
      <img src="https://mintcdn.com/chatarmin-help-center/lGe-w4qMajFJnjYi/images/api-documentation/mcp-oauth-consent.png?fit=max&auto=format&n=lGe-w4qMajFJnjYi&q=85&s=728db6b5c6cc8f00c9b4d6aeccb34ab6" alt="Chatarmin MCP OAuth-Zustimmungsseite mit Cursor-Zugriffsanfrage" width="2880" height="1800" data-path="images/api-documentation/mcp-oauth-consent.png" />
    </Frame>

    Melde dich bei Bedarf an, prüfe die Berechtigungen und klicke auf **Allow access** (Zugriff erlauben).
  </Step>

  <Step title="Chatarmin-Tools nutzen">
    Nach der Autorisierung erscheinen die Chatarmin-Tools im Assistenten. Frag z. B. „Wie lief die Kampagne letzte Woche?“ oder „Liste Kontakte, die uns in den letzten 7 Tagen geschrieben haben.“
  </Step>
</Steps>

## Erweitert: statisches Bearer-Token

Nur nutzen, wenn dein KI-Client kein OAuth **Connect** unterstützt.

1. Öffne **Profil → Einstellungen** und kopiere dein **API-Token**.
2. Füge die MCP-URL mit `Authorization`-Header in der Client-Konfiguration ein:

```json theme={null}
{
  "mcpServers": {
    "chatarmin": {
      "url": "https://api.chatarmin.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
```

Ersetze `YOUR_API_TOKEN` durch dein Token. Das Bearer-Beispiel findest du auch unter **Profil → MCP**.

## Fehlerbehebung

**Missing authorization state** – Starte erneut über **Connect** im KI-Client. Die Zustimmungsseite nicht manuell neu laden.

**Authorization request expired** – OAuth-States sind kurzlebig. Klicke erneut auf **Connect** im KI-Client.

**Session expired on consent screen** – Melde dich bei Chatarmin an und starte **Connect** im KI-Client erneut.

**Tools erscheinen nicht** – Prüfe, ob die URL exakt `https://api.chatarmin.com/api/mcp` ist, schließe OAuth ab und lade MCP im Client neu.

Hilfe nötig? Kontaktiere den Support über dein [Chatarmin-Dashboard](https://app.chatarmin.com/) oder siehe [Chatarmin MCP mit KI-Tools verbinden](/de/api-documentation-de/chatarmin-mcp-mit-ki-tools-verbinden-de).