> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/connect-ai-clients-mcp.md).

# KI-Clients mit MCP verbinden

Generieren Sie ein MCP-Token unter Einstellungen → Automatisierung und verbinden Sie Claude Desktop, Claude Code, Cursor, Windsurf, VS Code oder Codex CLI mit Ihrem Incogniton-Konto.

Öffnen Sie **Einstellungen** im Menü auf der linken Seite, klicken Sie auf den Tab **Automatisierung** und dann auf **MCP-Token generieren**. Wählen Sie dann Ihren AI-Client unter **In Ihrem AI-Client installieren** und klicken Sie auf **Konfiguration kopieren**.

MCP (Model Context Protocol) ermöglicht es einem AI-Client wie Claude, Cursor oder VS Code, mit Ihrem Incogniton-Konto zu arbeiten. Sie können ihn bitten, Profile zu finden, zu erstellen oder zu bearbeiten, Proxys, Gruppen und Tags zu verwalten sowie Profile zu starten oder zu stoppen.

Die Verbindung läuft über das npm-Paket `@incogniton/mcp`. Ihr AI-Client startet es mit `npx`, daher benötigen Sie [Node.js](https://nodejs.org/) 18 oder neuer auf dem Computer, auf dem der AI-Client läuft.

### Generieren Sie Ihr MCP-Token

{% stepper %}
{% step %}

#### Öffnen Sie den Automatisierungs-Tab

Klicken Sie auf **Einstellungen** im Menü auf der linken Seite und dann auf den Tab **Automatisierung**. Scrollen Sie zum Abschnitt **MCP-Token**.
{% endstep %}

{% step %}

#### Generieren Sie das Token

Klicken Sie auf **MCP-Token generieren**. Das neue Token erscheint in einem Feld unter dem Button.
{% endstep %}

{% step %}

#### Kopieren und speichern Sie es

Klicken Sie auf **Kopieren** neben dem Token und speichern Sie es an einem sicheren Ort, zum Beispiel in einem Passwort-Manager. Incogniton zeigt das Token nur einmal an: **Warnung: Sie können dieses Token später nicht abrufen — kopieren und speichern Sie es jetzt.**
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Behandeln Sie das MCP-Token wie ein Passwort. Jeder, der es hat, kann die Profile Ihres Kontos verwalten. Teilen Sie es niemals oder fügen Sie es nicht in eine öffentliche Datei ein.
{% endhint %}

### Ersetzen oder widerrufen Sie Ihr Token

Sie haben jeweils ein aktives MCP-Token. Wenn Sie erneut auf **MCP-Token generieren** klicken, wird ein neues Token erstellt und das alte funktioniert nicht mehr. Aktualisieren Sie das Token in jedem verbundenen AI-Client.

Um den Zugriff zu stoppen, klicken Sie unter **Aktive Tokens** auf **Widerrufen**. Wenn kein Token aktiv ist, zeigt der Abschnitt **Keine aktiven Tokens** an.

### Fügen Sie Incogniton zu Ihrem AI-Client hinzu

Unter **In Ihrem AI-Client installieren** öffnen Sie das Dropdown-Menü **AI-Client** und wählen Ihren Client: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code oder Codex CLI. Incogniton zeigt eine einsatzbereite Konfiguration mit Ihrem neuen Token an und erklärt, wo Sie es einfügen sollen. Klicken Sie auf **Konfiguration kopieren**, fügen Sie es dort ein, wo die App es angibt, und starten Sie den AI-Client neu.

Generieren Sie zuerst das Token. Wenn Sie diese Liste später öffnen, enthält die Konfiguration `YOUR_MCP_TOKEN` anstelle eines Tokens: Ersetzen Sie es durch das gespeicherte Token.

Für die manuelle Einrichtung in anderen MCP-Clients siehe die [MCP-Server-Dokumentation](https://api-docs.incogniton.com/mcp).

### Was der AI-Client über MCP tun kann

Nachdem Sie die Verbindung hergestellt haben, kann Ihr AI-Client:

* **Profile:** Suchen, erstellen, bearbeiten und klonen von Profilen sowie Abrufen der Gruppen, Tags, Proxys und Browser-Sprachen, die Sie für ein neues Profil verwenden können.
* **Gruppen und Tags:** Suchen und Erstellen von Profilgruppen und Tags.
* **Proxys:** Suchen und Hinzufügen von Proxys sowie Suchen und Erstellen von Proxy-Gruppen.
* **Team:** Abrufen von Teammitgliedern.
* **Starten und stoppen:** Sehen, welche Computer ein Profil starten können, ein Profil starten, überprüfen, ob ein Start oder Stopp funktioniert hat, und ein Profil stoppen.
* **Cloud-Telefone:** Auflisten Ihrer Cloud-Telefone, Erstellen eines Cloud-Telefons mit einem Proxy aus Ihrer Proxy-Bibliothek und Starten oder Stoppen von Cloud-Telefonen. Über MCP gestartete Telefone starten ohne Bildschirm.

Die vollständige Werkzeugliste finden Sie in der [MCP-Server-Dokumentation](https://api-docs.incogniton.com/mcp).

### Wie das Starten über MCP funktioniert

Ein Profil wird immer in der Incogniton-App auf einem Ihrer Computer geöffnet. Dieser Computer muss die App geöffnet haben und in Ihrem Konto angemeldet sein.

* Wenn ein Computer verfügbar ist, wird das Profil dort gestartet. Wenn mehrere verfügbar sind, erhält der AI-Client die Liste der Computer und Sie wählen einen aus.
* Eine Startanfrage, die innerhalb von 5 Minuten von keinem Computer angenommen wird, läuft ab.
* MCP kann nur Profile stoppen, die über MCP gestartet wurden. Schließen Sie ein Profil, das Sie selbst aus der Incogniton-App geöffnet haben.

### Steuern Sie den Browser nach einem MCP-Start

MCP selbst öffnet und schließt nur Profile. Es kann nicht klicken, tippen oder Seiten im Browser lesen.

Nach einem Start kann der AI-Client eine lokale DevTools-Adresse (`cdp_url`) des laufenden Browsers abrufen. Ein AI-Client, der Code ausführen kann, kann Puppeteer, Playwright oder einen Browser-MCP mit dieser Adresse verbinden.

{% hint style="info" %}
Die `cdp_url` funktioniert nur, wenn der AI-Client auf demselben Computer läuft wie die Incogniton-App, die das Profil gestartet hat. Sie funktioniert nicht von einem anderen Computer aus oder von einem Client, der keinen Code ausführen kann, wie Claude Desktop. Außerdem muss **Browser-Fernsteuerung erlauben** im Automatisierungs-Tab aktiviert sein. Siehe [Browser-Fernsteuerung](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/browser-remote-control.md).
{% endhint %}

### Was MCP nicht tun kann

Diese Aktionen sind über MCP nicht verfügbar:

* Öffnen einer URL, Verwalten von Tabs oder Lesen von Seiten in einem laufenden Profil.
* Überprüfen, ob ein Proxy funktioniert.
* Löschen von Profilen.
* Wiederherstellen eines Profils aus einem Backup.

Cas, der AI-Assistent in der Incogniton-App, kann dies tun. Öffnen Sie Cas in der App, um sie zu verwenden.

### Fehlerbehebung

* **Der Client zeigt keine Incogniton-Tools:** Starten Sie den AI-Client neu, nachdem Sie die Konfiguration eingefügt haben, und überprüfen Sie, ob Node.js 18 oder neuer installiert ist.
* **Das MCP-Protokoll des Clients zeigt "fehlendes Berechtigungstoken":** Das Token fehlt in der Konfiguration. Fügen Sie Ihr Token anstelle von `YOUR_MCP_TOKEN` ein.
* **Authentifizierungsfehler:** Das Token wurde ersetzt oder widerrufen. Generieren Sie ein neues und aktualisieren Sie die Konfiguration.

Für Skripte, die auf Ihrem eigenen Computer laufen, können Sie auch die [lokale REST-API](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/local-rest-api.md) oder das [JavaScript- und Python-SDK](https://docs.incogniton.com/documentation/german-documentation-1/automatisierungs-api-und-sdks/javascript-and-python-sdk.md) verwenden.
