> ## 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-Clients einrichten

> Registrieren Sie den Kameleoon-MCP-Server in Claude Code, Antigravity, Codex oder Cursor.

Jeder Client registriert den Kameleoon-MCP-Server in seiner eigenen Konfiguration und führt danach einmal eine OAuth-Anmeldung durch. Folgen Sie den Schritten für Ihren Client und führen Sie anschließend einen Beispielprompt aus, um zu prüfen, ob die Tools funktionieren.

## Claude-Code-Integration

### Schritt 1: Server registrieren

Um den Server für Ihr Benutzerprofil zu registrieren (damit er in allen Projekten verfügbar ist), öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

```bash theme={null}
claude mcp add --scope user kameleoon -- npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
```

Um den Server nur für das aktuelle Projekt zu registrieren (dabei wird Ihrem Repository eine Datei `.mcp.json` hinzugefügt, damit das Team sie teilen kann), führen Sie aus:

```bash theme={null}
claude mcp add --scope project kameleoon -- npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
```

Prüfen Sie, ob Claude den Server hinzugefügt hat:

```bash theme={null}
claude mcp list
```

**Erwartete Ausgabe:** `kameleoon: ... - ✗ Failed to connect` (Ein fehlgeschlagener Verbindungsaufbau ist hier normal, weil Sie die Authentifizierung noch nicht abgeschlossen haben.)

### Schritt 2: OAuth-Authentifizierung abschließen

Starten Sie im selben Terminal den Anmeldevorgang:

```bash theme={null}
npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
```

1. Der Befehl öffnet automatisch einen Browser-Tab. Falls nicht, kopieren Sie die im Terminal ausgegebene URL und öffnen Sie sie manuell.
2. Melden Sie sich bei Ihrem Kameleoon-Konto an.
3. Klicken Sie auf **Authorize**.
4. Wenn der Browser eine Erfolgsmeldung anzeigt, drücken Sie im Terminal `Ctrl+C`.

Prüfen Sie die Verbindung:

```bash theme={null}
claude mcp list
```

**Erwartete Ausgabe:** `kameleoon: ... - ✓ Connected`

### Schritt 3: Eine neue Claude-Code-Sitzung starten

Claude Code stellt Tools neu hinzugefügter MCP-Server nur in Sitzungen bereit, die Sie nach der Registrierung des Servers starten. Schließen Sie Ihren aktuellen Claude-Code-Chat und öffnen Sie einen neuen.

### Schritt 4: Verbindung prüfen

Probieren Sie in einer neuen Claude-Code-Unterhaltung die folgenden Prompts aus:

* "List the Kameleoon feature flags."
* "What experiments are running on site X?"
* "Show the status of experiment Y."
* "Show the code for variation 1 of experiment Z."

## Antigravity-Integration

### Schnelleinrichtung

Fügen Sie den folgenden Self-Starter-Prompt direkt in Ihren Antigravity-Chat ein, um sich automatisch zu verbinden:

```text theme={null}
Connect to the Kameleoon MCP production server. The endpoint is https://mcp.kameleoon.com/mcp, using mcp-remote@0.1.37 on port 35535 with the openid scope. Authenticate by running the npx mcp-remote command to trigger my browser, then verify the connection.
```

### Manuelle Konfiguration

Bearbeiten Sie die Konfigurationsdatei unter `~/.gemini/config/mcp_config.json` und fügen Sie den folgenden JSON-Block hinzu. Hat die Datei bereits ein Objekt `mcpServers`, ergänzen Sie darin nur den Eintrag `kameleoon`:

```json theme={null}
{
  "mcpServers": {
    "kameleoon": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.37",
        "https://mcp.kameleoon.com/mcp",
        "35535",
        "--static-oauth-client-metadata",
        "{ \"scope\": \"openid\" }"
      ]
    }
  }
}
```

## Codex-Integration

### Schnelleinrichtung

Fügen Sie den folgenden Self-Starter-Prompt in Ihren Codex-Chat ein:

```text theme={null}
Configure the Kameleoon MCP server at https://mcp.kameleoon.com/mcp. Use port 35535 for callback. Once configured, run the login command to trigger my browser and then list my feature flags.
```

### Manuelle Konfiguration

Fügen Sie den folgenden Block in `~/.codex/config.toml` ein. Erstellen Sie die Datei, falls sie noch nicht existiert:

```toml theme={null}
[mcp_servers.kameleoon]
command = "npx"
args = ["-y", "mcp-remote@0.1.37", "https://mcp.kameleoon.com/mcp",
        "35535", "--static-oauth-client-metadata",
        "{ \"scope\": \"openid\" }"]
```

## Verbindung authentifizieren

Der Kameleoon-MCP-Server verwendet OAuth. Führen Sie im Terminal den folgenden Befehl aus, um den Autorisierungsablauf zu starten:

```bash theme={null}
npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 \
  --static-oauth-client-metadata '{ "scope": "openid" }'
```

**Erwartetes Verhalten:**

1. Der Browser öffnet automatisch ein Fenster.
2. Klicken Sie auf der Kameleoon-Anmeldeseite auf **Authorize**.
3. Kameleoon schließt den lokalen Callback auf Port 35535 ab.
4. Das Terminal bestätigt, dass der Proxy erfolgreich verbunden wurde.

Eine erfolgreiche Verbindung gibt einen Text ähnlich dem folgenden aus:

```text theme={null}
Connected to remote server using StreamableHTTPClientTransport
Local STDIO server running
Proxy established successfully between local STDIO and remote StreamableHTTPClientTransport
```

## Tool-Funktionen prüfen

Führen Sie nach der Authentifizierung die folgenden Prüfungen durch, um zu bestätigen, dass die Tools wie erwartet funktionieren:

1. **Verfügbare Tools auflisten:** Prüfen Sie, dass `tools/list` erfolgreich ist und die Kameleoon-Tools zurückgibt. Stellen Sie sicher, dass die Ausgabe die Tools aus der [Tool-Referenz](https://docs.kameleoon.com/de/mcp/mcp-server.md#tool-referenz) enthält, etwa `experiment_code_get`, `feature_flag_list` und `feature_flag_create`.
2. **Feature Flags abrufen:** Führen Sie `feature_flag_list(siteCode = "d1alzzxd7k")` aus. Eine erfolgreiche Antwort liefert eine Liste der Feature Flags für die angegebene Site.
3. **Ergebnisse eines Experiments abrufen:** Führen Sie `experiment_results_get(experimentId = 149640)` aus. Eine erfolgreiche Antwort enthält die Ergebnisse für jedes Ziel, das dem Experiment zugeordnet ist.

## Cursor-Integration

Cursor integriert MCP-Tools direkt in die Chat-Seitenleiste der IDE, sodass Sie sie während des Programmierens nutzen können.

### Option 1: Über die Cursor-Oberfläche konfigurieren (empfohlen)

1. Öffnen Sie die Cursor Settings (`Cmd+Shift+J` unter macOS, `Ctrl+Shift+J` unter Windows/Linux).
2. Navigieren Sie zu **Features > MCP Servers > + Add New MCP Server**.
3. Setzen Sie **Name** auf `kameleoon`.
4. Setzen Sie **Type** auf `command`.
5. Geben Sie die folgende Zeichenkette als **Command** ein:
   ```bash theme={null}
   npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ "scope": "openid" }'
   ```
6. Speichern Sie die Konfiguration.

### Option 2: In einer JSON-Datei konfigurieren (fortgeschritten)

Öffnen Sie `~/.cursor/mcp.json` (erstellen Sie die Datei, falls sie nicht existiert) und fügen Sie den folgenden Eintrag im Objekt `mcpServers` hinzu:

```json theme={null}
{
  "mcpServers": {
    "kameleoon": {
      "command": "bash",
      "args": [
        "-lc",
        "npx -y mcp-remote@0.1.37 https://mcp.kameleoon.com/mcp 35535 --static-oauth-client-metadata '{ \"scope\": \"openid\" }'"
      ]
    }
  }
}
```

> [!NOTE]
>
> Starten Sie Cursor neu, nachdem Sie die Datei manuell bearbeitet haben.

## Beispielprompts für Entwickler-Workflows

Nachdem Sie den Kameleoon-MCP-Server verbunden haben, verwenden Sie in Ihrer IDE Prompts wie die folgenden:

* "List the Kameleoon MCP tools available in this session."
* "Show all feature flags for site code `d1alzzxd7k`."
* "Get the details for feature flag new\_search on site `d1alzzxd7k`."
* "Fetch experiment results for experiment `149640` and summarize the current status."
* "Pull the variation code for experiment `<experimentId>` and variation `<variationId>`."

Für komplexere Workflows probieren Sie die folgenden Prompts aus:

* "Inspect feature flag new\_search for site `d1alzzxd7k` and explain what environments and variations it has."
* "Summarize experiment `149640` for an engineer. Include status, site code, winner state, and whether any variation data is available."
* "List the active feature flags for site `d1alzzxd7k` and point out any flags that look like stale candidates."
* "Retrieve the code for variation `<variationId>` in experiment `<experimentId>` and explain what frontend behavior it changes."
* "Create a new feature flag named `<name>` with key `<featureKey>` for site `d1alzzxd7k`."
* "Turn on feature flag `<featureKey>` in the staging environment for site `d1alzzxd7k`."
* "Turn off feature flag `<featureKey>` in the production environment for site `d1alzzxd7k`."
* "How has the checkout experiment performed week by week on phones?"
* "Did new visitors react differently from returning ones in the pricing test? Use Bayesian statistics."
* "Show the daily trend of the checkout test without Safari, counting every purchase, not only buyers."
* "Create a segment of returning visitors from Germany on desktop who already completed the Purchase goal."

## Tipps zum Prompting

* Geben Sie den Site code an, wenn Sie mit Feature Flags arbeiten.
* Geben Sie die Experiment ID an, wenn Sie Experimente oder Experimentergebnisse abfragen.
* Geben Sie sowohl `experimentId` als auch `variationId` an, wenn Sie den Code einer Variation abfragen.
* Nennen Sie die Zielumgebung ausdrücklich, wenn Sie den Agenten bitten, ein Feature Flag ein- oder auszuschalten.
* Bitten Sie um eine Zusammenfassung in einfacher Sprache, wenn Ihr KI-Agent die MCP-Antwort interpretieren soll, statt nur die Rohdaten abzurufen.
