# MCP-Server

Der MCP-Server macht Trackdolphin für Sprachmodelle bedienbar. Statt ein
Dashboard zu öffnen, fragst du:

> Läuft das Tracking bei meinshop.de sauber?

> Welche Kanäle haben letzten Monat am meisten Umsatz gebracht?

> Starte den Historienimport für den neuen Shop.

## Einrichten

Einen Schlüssel im Dashboard unter *Einstellungen → API & MCP* erzeugen, dann
in die Konfiguration deines Clients eintragen. Für Claude Desktop
(`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "trackdolphin": {
      "command": "npx",
      "args": ["-y", "@trackdolphin/mcp"],
      "env": { "TRACKDOLPHIN_TOKEN": "td_live_…" }
    }
  }
}
```

## Was er kann

Der Server pflegt **keine eigene Werkzeugliste**. Er lädt beim Start die
[OpenAPI-Beschreibung](/docs/api.md) und macht daraus Werkzeuge. Ein neuer
Endpunkt ist damit sofort ein neues Werkzeug — und es gibt keine zweite Liste,
die veraltet.

Heute sind das unter anderem:

- `listShops` — welche Shops gibt es
- `getShopTrackingHealth` — offene Störungen, letzter Prüflauf, letztes Event
- `getShopKpis`, `getShopChannels`, `getShopTopPages`, `getShopFunnel`
- `getShopImportStatus` — Erkennungsquote
- `startShopImport`

## Was er nicht kann

Die Schlüsselverwaltung. Ein Modell soll keine neuen Zugänge ausstellen können
— sonst wäre ein Widerruf wertlos, weil der widerrufene Schlüssel sich längst
einen Nachfolger angelegt hat. Schlüssel erstellst und widerrufst du im
Dashboard, siehe [Einstellungen — API & MCP](/docs/app-einstellungen-api-mcp.md).