# MCP server

URL: https://docs.ablyft.com/de/developers/reference/mcp-server/

> Verbinde KI-Assistenten wie Claude, ChatGPT oder Cursor über das Model Context Protocol mit ABlyft.



Der ABlyft MCP Server lässt einen KI-Assistenten in deinem Namen mit deinem ABlyft-Account arbeiten. Über das
Model Context Protocol (MCP), einen offenen Standard zur Anbindung von Assistenten an Tools, kannst du den Assistenten bitten,
Experiments aufzulisten, ein Experiment mit einer Variation anzulegen, seinen Status zu ändern oder seine Results zu erklären.

## Was du brauchst

* Einen ABlyft-User mit Zugriff auf mindestens ein Team.
* Einen MCP-kompatiblen Assistenten, zum Beispiel Claude Desktop, Cursor oder Windsurf (die App listet diese als Beispiele) oder ChatGPT.

Der Assistent kann das, was **deine Rolle** erlaubt. Ein Viewer kann zum Beispiel keine Experiments anlegen. Siehe
[Rollen & Berechtigungen](https://docs.ablyft.com/de/guides/projects-and-teams/roles-and-permissions/).

## Einen Assistenten verbinden

1. Öffne in ABlyft deine persönlichen Einstellungen und gehe zu **MCP Connections**.

2. Kopiere die dort angezeigte **MCP Server URL**. Für die gehostete App lautet sie:

   ```text
   https://app.ablyft.com/mcp
   ```

3. Füge diese URL in deinem Assistenten als Custom Connector oder MCP Server hinzu.

4. Wenn der Assistent danach fragt, melde dich bei ABlyft an und autorisiere die Verbindung (OAuth).

5. Der Client erscheint nun in der Tabelle unter **MCP Connections**.

Typische Menüs in den Assistenten:

| Assistent | Wo                                                                                                                                     |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Claude    | Settings → Connectors → Add custom connector. Nenne ihn `ABlyft`, gib die URL ein und klicke auf **Connect**.                          |
| ChatGPT   | Settings → Plugins → MCPs tab. Nenne ihn `ABlyft`, wähle den Typ **Streamable HTTP**, gib die URL ein und klicke auf **Authenticate**. |

Die Menünamen hängen von der Version des Assistenten ab und können sich ändern. Details findest du in der Dokumentation deines Assistenten.
Andere Clients verwendest du genauso: Sie brauchen nur die Server-URL.

### Verbindungen verwalten und widerrufen

Die Tabelle unter **MCP Connections** zeigt den **Client**, seine **Scopes**, wann er **Connected** wurde und wann er **Expires**.
Mit **Revoke** (oder durch Auswahl mehrerer Zeilen, um sie gesammelt zu widerrufen) entziehst du den Zugriff. Der Assistent muss dann erneut autorisiert werden.

> **Der Assistent handelt als du:** Alles, was der Assistent tut, geschieht mit deinem User und ist wie deine eigenen Änderungen sichtbar. Prüfe, was er vorhat,
> besonders bevor du ein Experiment startest oder pausierst. Widerrufe Verbindungen, die du nicht mehr nutzt.

## Verfügbare Tools

Der Server heißt "Ablyft Server". Er bietet diese Tools (mit den Namen, die dein Assistent sieht):

| Bereich            | Tools                                                                                                                                                                                                                    | Zweck                                                                                                                                                                                   |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Teams und Projects | `list-teams-tool`, `list-projects-tool`                                                                                                                                                                                  | Teams, auf die du Zugriff hast, und Projects (optional nach Team gefiltert)                                                                                                             |
| Experiments        | `list-experiments-tool`, `show-experiment-tool`, `create-experiment-tool`, `clone-experiment-tool`                                                                                                                       | Auflisten (Filter nach Project und Status), Details anzeigen, ein Draft-Experiment anlegen, ein Experiment als Draft klonen                                                             |
| Status             | `update-experiment-status-tool`, `archive-experiment-tool`, `un-archive-experiment-tool`                                                                                                                                 | Ein Experiment zwischen Draft, Preview, Running und Paused verschieben; archivieren und wiederherstellen                                                                                |
| Variations         | `create-variation-tool`, `edit-variation-tool`                                                                                                                                                                           | Variations anlegen oder bearbeiten, inklusive CSS und JavaScript. Bei neuen Variations kann der Assistent die Änderung beschreiben und den Code von einem KI-Agenten generieren lassen. |
| Pages              | `list-pages-tool`, `create-page-tool`, `edit-page-tool`, `clone-page-tool`                                                                                                                                               | Pages mit ihren URL-Targeting-Regeln                                                                                                                                                    |
| Audiences          | `list-audiences-tool`, `create-audience-tool`, `edit-audience-tool`, `clone-audience-tool`                                                                                                                               | Visitor-Segmente und ihre Regeln                                                                                                                                                        |
| Goals              | `list-goals-tool`, `create-goal-tool`, `edit-goal-tool`, `clone-goal-tool`                                                                                                                                               | Was du misst                                                                                                                                                                            |
| Attach und detach  | `attach-page-to-experiment-tool`, `detach-page-from-experiment-tool`, `attach-audience-to-experiment-tool`, `detach-audience-from-experiment-tool`, `attach-goal-to-experiment-tool`, `detach-goal-from-experiment-tool` | Pages, Audiences und Goals mit Experiments verbinden                                                                                                                                    |
| Schedules          | `list-schedules-tool`, `create-schedule-tool`, `edit-schedule-tool`, `delete-schedule-tool`                                                                                                                              | Start- und Endzeiten sowie Endbedingungen von Experiments                                                                                                                               |
| Results            | `show-experiment-results-tool`, `interpret-experiment-results-tool`                                                                                                                                                      | Statistiken pro Goal und eine KI-Interpretation                                                                                                                                         |

Der Assistent wählt die Tools, die er braucht. Du beschreibst in normaler Sprache, was du möchtest, zum Beispiel "Create an experiment on
the product page that makes the buy button green, with a click goal".

> **AI credits:** Die Interpretation von Results (`interpret-experiment-results-tool`) nutzt einen KI-Agenten und verbraucht AI credits. Die Anweisungen
> des Servers weisen den Assistenten an, dich vorher zu fragen.

## Grenzen, die du kennen solltest

* Statusänderungen folgen denselben Regeln wie in der App: Ein Experiment braucht zum Beispiel mindestens eine Variation, Page und ein Goal,
  bevor es starten kann ([Details](https://docs.ablyft.com/de/guides/experiments/start-pause-stop/#before-you-can-preview-or-start)). Ist eine Änderung nicht möglich, nennt das Tool den Grund.
* Listen enthalten bis zu 50 Einträge pro Seite.
* Wenn du Zugriff auf mehrere Projects hast, muss der Assistent dem Tool mitteilen, welches Project verwendet werden soll.

## Nächste Schritte

- [REST API](https://docs.ablyft.com/de/developers/reference/rest-api/): Für Skripte und Integrationen ohne KI-Assistenten.
- [Security](https://docs.ablyft.com/de/developers/consent-and-security/security/): Tokens, Verbindungen und Zugriff.

