> ## 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 mit KI-Tools verbinden

> Schritt-für-Schritt-Anleitung für Cursor, Claude, ChatGPT, VS Code und GitHub Copilot.

Verbinde Chatarmin MCP mit deinem KI-Assistenten, damit er mit Kampagnen, Kontakten, Flows und Analytics deiner Organisation arbeiten kann.

<Note>
  Du brauchst ein Chatarmin-Konto mit Zugriff auf **Profil → MCP**. OAuth ist empfohlen; siehe [Chatarmin MCP](/de/api-documentation-de/chatarmin-mcp-de) für Funktionen und Fehlerbehebung.
</Note>

**MCP-Endpoint-URL (alle Clients):**

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

**OAuth-Konfiguration (Cursor und andere Clients mit `mcp.json`):**

```json theme={null}
{
  "mcpServers": {
    "chatarmin": {
      "url": "https://api.chatarmin.com/api/mcp"
    }
  }
}
```

***

## Cursor

Cursor unterstützt Remote-MCP-Server mit OAuth. Kein API-Token in der Konfiguration nötig.

<Steps>
  <Step title="OAuth-Konfiguration kopieren">
    Öffne in Chatarmin **Profil → MCP** und klicke auf **Copy OAuth config** (oder kopiere das JSON auf der Seite).

    <Frame>
      <img src="https://mintcdn.com/chatarmin-help-center/lGe-w4qMajFJnjYi/images/api-documentation/profile-mcp-connect-section.png?fit=max&auto=format&n=lGe-w4qMajFJnjYi&q=85&s=d4d0a6f1d9dd8ff4c3361820c4271a08" alt="Chatarmin MCP-Endpoint-URL und Copy OAuth config Schaltflächen" width="1860" height="1040" data-path="images/api-documentation/profile-mcp-connect-section.png" />
    </Frame>
  </Step>

  <Step title="Server in Cursor hinzufügen">
    Öffne **Cursor Settings → Tools & MCP** (oder bearbeite `~/.cursor/mcp.json` / `.cursor/mcp.json` im Projekt).

    Füge die Chatarmin-OAuth-Konfiguration unter `mcpServers` ein oder ergänze:

    ```json theme={null}
    {
      "mcpServers": {
        "chatarmin": {
          "url": "https://api.chatarmin.com/api/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Verbinden">
    Unter **Tools & MCP** findest du **chatarmin** – klicke auf **Connect**.

    Der Browser öffnet die Chatarmin-Zustimmungsseite. Melde dich an und klicke auf **Allow access**.

    <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 für Cursor" width="2880" height="1800" data-path="images/api-documentation/mcp-oauth-consent.png" />
    </Frame>
  </Step>

  <Step title="Chatarmin im Agent nutzen">
    In Cursor Agent oder Chat stellst du Fragen zu Live-Daten in Chatarmin. Bestätige Tool-Aufrufe, wenn Cursor danach fragt.
  </Step>
</Steps>

<Tip>
  Projektbezogene Tools: `.cursor/mcp.json` im Repo. Benutzerweit: `~/.cursor/mcp.json`.
</Tip>

***

## Claude (Desktop und Web)

Claude verbindet Remote-MCP-Server über **Custom Connectors**. Anthropics Cloud erreicht deinen Server per HTTPS – nutze die Chatarmin-Produktions-URL, keine lokale Adresse.

<Steps>
  <Step title="Connectors öffnen">
    In Claude Desktop oder auf [claude.ai](https://claude.ai) öffnest du **Einstellungen**.

    * **Persönlich:** **Customize → Connectors**
    * **Team / Enterprise:** **Organization settings → Connectors**
  </Step>

  <Step title="Custom Connector hinzufügen">
    Klicke auf **Add custom connector** (oder **Add → Custom**, Typ **Web** falls gefragt).

    Trage ein:

    | Feld | Wert                                |
    | ---- | ----------------------------------- |
    | Name | `Chatarmin`                         |
    | URL  | `https://api.chatarmin.com/api/mcp` |

    Transport auf der erkannten Standardeinstellung (Streamable HTTP) belassen, sofern Chatarmin-Support nichts anderes empfiehlt.
  </Step>

  <Step title="Authentifizieren">
    Wähle **OAuth**, wenn gefragt. Schließe die Anmeldung auf der Chatarmin-Zustimmungsseite ab und klicke auf **Allow access**.
  </Step>

  <Step title="Im Chat aktivieren">
    Starte eine neue Unterhaltung, öffne das Tools- oder Connectors-Menü und aktiviere **Chatarmin**. Stelle deine Frage und bestätige Tool-Nutzung, wenn Claude danach fragt.
  </Step>
</Steps>

<Note>
  Im Free-Tarif kann die Anzahl Custom Connectors begrenzt sein. Remote Connectors brauchen eine öffentliche HTTPS-URL – der gehostete Chatarmin-Endpoint funktioniert direkt.
</Note>

***

## ChatGPT

ChatGPT verbindet Remote-MCP-Server als **Custom Connectors**, wenn der **Developer mode** aktiv ist (kostenpflichtige Pläne).

<Steps>
  <Step title="Developer mode aktivieren">
    Öffne in ChatGPT (Web) **Settings**.

    Aktiviere **Developer mode** (je nach Rollout unter **Apps → Advanced settings**, **Connectors → Advanced** oder **Security and login**).
  </Step>

  <Step title="Connector anlegen">
    Gehe zu **Settings → Connectors** (oder **Plugins**) und klicke auf **Create** / **Add connector**.

    | Feld           | Wert                                |
    | -------------- | ----------------------------------- |
    | Name           | `Chatarmin`                         |
    | Connector URL  | `https://api.chatarmin.com/api/mcp` |
    | Authentication | OAuth                               |
  </Step>

  <Step title="Bei Chatarmin anmelden">
    Schließe den OAuth-Flow im Browser ab. Auf der Chatarmin-Zustimmungsseite klickst du auf **Allow access**.
  </Step>

  <Step title="Im Chat nutzen">
    Starte einen neuen Chat, aktiviere den **Chatarmin**-Connector und stelle deine Frage. ChatGPT fragt vor Schreibaktionen nach Bestätigung.
  </Step>
</Steps>

<Warning>
  ChatGPT unterstützt nur **Remote-HTTPS**-MCP-Server. Ein lokaler stdio-Prozess funktioniert nicht ohne Hosting oder Tunnel.
</Warning>

***

## VS Code

VS Code unterstützt MCP über kompatible Extensions. Die Chatarmin-URL und der OAuth-Flow bleiben gleich; die genaue UI hängt von deiner Extension ab.

<Steps>
  <Step title="MCP-fähige Extension installieren">
    Installiere eine Extension mit **Remote HTTP MCP** und OAuth (z. B. GitHub Copilot Agent Mode oder eine MCP-Extension aus dem Marketplace).

    Folge der Extension-Doku zum Hinzufügen eines Remote-Servers.
  </Step>

  <Step title="Chatarmin-Server hinzufügen">
    Bei Abfrage der Server-URL eintragen:

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

    Bei JSON-Konfiguration den OAuth-Block von **Profil → MCP** in Chatarmin verwenden.
  </Step>

  <Step title="Mit OAuth verbinden">
    **Connect** oder **Authenticate** in der Extension auslösen. Die Chatarmin-Zustimmungsseite im Browser abschließen.
  </Step>
</Steps>

***

## GitHub Copilot

GitHub Copilot (VS Code, JetBrains oder Copilot Chat) kann MCP-Server nutzen, wenn deine Client-Version Remote Connectors unterstützt.

<Steps>
  <Step title="MCP-Unterstützung prüfen">
    Stelle sicher, dass dein Copilot-Client MCP Connectors unterstützt (siehe [GitHub Copilot Dokumentation](https://docs.github.com/en/copilot) für deinen Editor).
  </Step>

  <Step title="Chatarmin hinzufügen">
    Remote-MCP-Server mit URL `https://api.chatarmin.com/api/mcp` und Authentifizierung **OAuth** hinzufügen – gemäß MCP- oder Copilot-Einstellungen deines Editors.
  </Step>

  <Step title="Autorisieren">
    Connect-Flow starten und Zugriff auf der Chatarmin-OAuth-Seite bestätigen.
  </Step>
</Steps>

***

## Bearer-Token-Fallback

Wenn ein Client kein OAuth unterstützt, nutze dein API-Token unter **Profil → Einstellungen → API-Token**:

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

Für ältere `claude_desktop_config.json`-Setups kannst du `mcp-remote` als Brücke nutzen:

```json theme={null}
{
  "mcpServers": {
    "chatarmin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.chatarmin.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_TOKEN"
      ]
    }
  }
}
```

## FAQ

**Brauche ich einen separaten MCP-API-Key?**\
Nein. OAuth nutzt deine Chatarmin-Anmeldung. Der Bearer-Fallback verwendet dein bestehendes **API-Token**.

**Kann ich den Zugriff widerrufen?**\
Verwalte Verbindungen unter **Profil → MCP** in Chatarmin und rotiere bei Bearer-Auth dein API-Token unter **Profil → Einstellungen**.

**Welche Clients werden offiziell unterstützt?**\
Jeder MCP-Client mit Remote HTTPS und OAuth (oder Bearer-Headern) kann sich verbinden. Die Anleitungen oben decken die gängigsten Tools ab; die UI kann sich mit Produkt-Updates leicht ändern.