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

# MCP-Fehlerbehebung

> Häufige MCP-Verbindungs-, Authentifizierungs- und Tool-Fehler diagnostizieren und beheben.

Suchen Sie das Symptom, das zu Ihrem Problem passt. Jeder Eintrag nennt die wahrscheinliche Ursache und die Lösung.

## Fehlerbehebung für Claude Code

| Symptom | Ursache | Lösung |
| - | - | - |
| Der Browser öffnet sich nicht. | Der automatische Start ist fehlgeschlagen. | Kopieren Sie die URL aus dem Terminal und öffnen Sie sie manuell. |
| Verbindung auf Port 35535 abgelehnt. | Der Port wird bereits verwendet. | Führen Sie unter macOS oder Linux `lsof -i :35535` aus, unter Windows `netstat -ano \| findstr :35535`, beenden Sie den Prozess und versuchen Sie es erneut. |
| Verbindungsaufbau nach OAuth fehlgeschlagen. | Das Token wurde nicht gespeichert. | Führen Sie den [Befehl aus Schritt 2](https://docs.kameleoon.com/de/mcp/set-up-clients.md#schritt-2-oauth-authentifizierung-abschließen) erneut aus, um Ihr Token zu aktualisieren. |
| Tools sind in Claude nicht sichtbar. | Die Sitzung wurde gestartet, bevor der Server hinzugefügt wurde. | Starten Sie eine neue Claude-Code-Unterhaltung. |
| Ein neueres Tool, etwa `experiment_update` oder `trigger_list`, fehlt in der Tool-Liste. | Der Client behält die Tool-Liste, die er geladen hat, bevor Kameleoon diese Tools veröffentlicht hat. | Verbinden Sie den Server neu. Gehen Sie in Claude.ai zu **Customize** > **Connectors** und verbinden Sie Kameleoon neu. Führen Sie in Claude Code `/mcp` aus und wählen Sie **Reconnect**. |
| Der Schlüssel `mcpServers` wird in `settings.json` abgelehnt. | Falsche Datei; Claude Code verwendet diesen Schlüssel nicht. | Verwenden Sie stattdessen den Befehl `claude mcp add`. |
| Authentifizierungsfehler nach längerer Zeit. | Das OAuth-Token ist abgelaufen. | Führen Sie den [Befehl aus Schritt 2](https://docs.kameleoon.com/de/mcp/set-up-clients.md#schritt-2-oauth-authentifizierung-abschließen) erneut aus. |

## Allgemeine Fehlerbehebung

### Rate-Limit-Fehler

Ein Tool-Aufruf liefert einen Rate-Limit-Fehler mit einem Wert für `retryAfterSeconds`.

* **Ursache:** Der Aufruf hat das Limit des MCP-Servers pro Tool für Ihren Benutzer überschritten oder das Gateway-Limit der Automation API für die MCP-Integration.
* **Lösung:** Warten Sie die Anzahl Sekunden aus `retryAfterSeconds` und wiederholen Sie den Aufruf. Bei Massenoperationen bündeln Sie Ihre Anfragen oder drosseln Sie die Schleife, damit sie unter den Limits bleibt.

### Port 35535 wird bereits verwendet

Schlägt die Authentifizierung mit dem Fehler `EADDRINUSE` fehl, lauscht bereits ein anderer Prozess auf dem OAuth-Callback-Port.

* **Ursache:** Ein veralteter Prozess `mcp-remote` ist aus einem früheren Authentifizierungsversuch noch aktiv.
* **Lösung:** Beenden Sie den veralteten Prozess, der Port 35535 belegt, und führen Sie den OAuth-Befehl erneut aus.

### MCP-Server erscheint nicht im Codex-Chat

Codex lädt neu hinzugefügte MCP-Server möglicherweise nicht im bereits laufenden Thread neu.

* **Lösung:** Laden Sie Codex neu oder starten Sie eine neue Sitzung, nachdem Sie `config.toml` aktualisiert haben.

### Browserablauf wird nicht abgeschlossen

Wenn sich das OAuth-Browserfenster öffnet, die Autorisierung aber nicht abgeschlossen wird:

* Prüfen Sie, ob Sie auf der Kameleoon-Anmeldeseite auf **Authorize** geklickt haben.
* Prüfen Sie, ob Ihre Browser- oder Systemeinstellungen `localhost`-Callbacks nicht blockieren.
* Öffnen Sie die Callback-URL manuell, falls Ihr Browser sie nicht automatisch startet.

### Ein Tool gibt BLOCKED zurück, statt die Änderung vorzunehmen

Tools, die den Traffic ändern, geben bis zu Ihrer Bestätigung eine Vorschau mit dem Status `BLOCKED` zurück. Das bedeutet keinen Fehler.

* **Lösung:** Lesen Sie die Vorschau und bitten Sie Ihren KI-Assistenten, den Aufruf mit `confirm` auf `true` zu wiederholen, wenn die Änderung so gewünscht ist. Für `segment_delete` und `trigger_delete` verwenden Sie stattdessen `force`.

### Health-Check gibt DOWNSTREAM\_ERROR zurück

`experiment_health_check_get` schlägt für ein Experiment fehl, das ein Ratio-Ziel verwendet, dessen Zählerziel nicht an das Experiment angehängt ist.

* **Lösung:** Hängen Sie das fehlende Ziel in der App an oder führen Sie die Prüfung für ein anderes Experiment aus.

### Zieleffekte liefern keine Zeilen

`goal_experiment_impacts_list` kann keine Zeilen liefern, solange die Daten noch vorbereitet werden.

* **Lösung:** Prüfen Sie das Feld `readiness` (`PREPARING` oder `PARTIAL`) und fragen Sie nach Ablauf von `retryAfterSeconds` erneut.

### Ergebnisse für einen Tag weichen von der Tagesaufteilung ab

Ein Zeitfenster von einem Tag folgt der Zeitzone Ihrer Organisation. Tägliche Einträge folgen der Zeitzone der Site. Deshalb können beide unterschiedliche 24 Stunden abdecken.

### Verbesserung ist 0 oder fehlt bei einer Variation

Es gibt keine Basis für den Vergleich, wenn das Original 0 % des Traffics erhält.

### Eine Seite, Seitengröße oder ein Limit von 0 liefert den Standardwert

Bei `takeaway_list` und `goal_experiment_impacts_list` bedeutet 0 für eine Seite, Seitengröße oder ein Limit „den Standardwert verwenden“.

### Neue Tools fehlen nach einem Release

Clients behalten die alte Tool-Liste, bis Sie die Verbindung erneuern.

* **Lösung:** Verbinden Sie nach einem Release den Kameleoon-MCP-Connector neu.

### Headless- oder Remote-Agenten können sich nicht authentifizieren

Remote- oder Headless-Agenten (etwa ein cloud-gehostetes Codex) können den browserbasierten Autorisierungsschritt nicht abschließen.

* **Lösung:** Verwenden Sie stattdessen eine Desktop-Version Ihres Tools.

### Paketrunner-Befehl nicht gefunden

Schlägt der Befehl mit einem Fehler „not found“ fehl, prüfen Sie, ob `npx` in Ihrem Systempfad verfügbar ist. Node.js ab Version 8.2 enthält `npx` standardmäßig.