> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Analytics MCP-Server
> Verbinden Sie Ihre KI-Agenten mit der Werbeplattform von Topsort für Echtzeit-Analytics und Katalogoperationen
Das **Model Context Protocol (MCP)** ist ein offener Standard zum Verbinden von KI-Anwendungen mit externen Systemen—denken Sie daran wie an einen USB-C-Port für KI. Unser Analytics MCP-Server gibt Ihren KI-Assistenten direkten Zugriff auf die Werbe-Analytics- und Katalog-APIs von Topsort.
Suchen Sie stattdessen Dokumentationszugriff? Schauen Sie sich unseren [Dokumentations-MCP-Server](/api/mcp) für KI-gestützte API-Integrationsanleitung an.
## Was Sie tun können
Durch Verbindung mit dem Analytics MCP-Server von Topsort können KI-Assistenten:
* **Werbeleistung analysieren** - Echtzeit-Metriken wie CTR, CVR, ROAS, CPC und Werbeausgaben über Kampagnen oder Marktplätze abfragen
* **Kampagnengesundheit überwachen** - Budgetauslastung, Gebotsverhalten, Qualitätswerte und Pacing in Echtzeit überprüfen
* **Leistung über Zeit vergleichen** - Woche-für-Woche-, Monat-für-Monat- oder benutzerdefinierte Periodenvergleiche durchführen, um Trends und Anomalien zu identifizieren
* **Mit der Branche vergleichen** - Kampagnenmetriken mit Kategorie-Benchmarks vergleichen (Einzelhandel, Pharmazie, Reisen, etc.)
* **Insights visualisieren** - Linien-, Balken- und Kreisdiagramme aus beliebigen Analysedaten generieren für einfache Interpretation
* **Topsort-Anleitung erhalten** - Fragen zur API-Integration, Fehlerbehebung und Plattform-Best-Practices beantworten
Alle Abfragen können auf einen bestimmten Anbieter beschränkt werden, um sicherzustellen, dass Werbetreibende nur auf ihre eigenen Daten zugreifen, während Marktplatzbetreiber aggregierte Einblicke sehen können.
## Schnellstart
Unser Analytics MCP-Server ist verfügbar unter:
```
https://mcp-server.api.topsort.ai/mcp
```
Dieser MCP-Server erfordert Authentifizierung. Kontaktieren Sie Ihren Topsort-Vertriebsmitarbeiter, um einen API-Schlüssel mit MCP-Server-Zugriff anzufordern.
## Authentifizierung
### Marktplatz-Authentifizierung
Alle Anfragen müssen einen gültigen API-Schlüssel enthalten. Für MCP-Clients, die `mcp-remote` verwenden (wie Claude Desktop), übergeben Sie den Schlüssel über das `--header`-Argument:
```json theme={null}
{
"mcpServers": {
"topsort-analytics": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-server.api.topsort.ai/mcp",
"--header",
"X-API-Key: MPS_xxxx"
]
}
}
}
```
### Anbieter-ID-Filterung
Werkzeugergebnisse können für bestimmte Anbieter gefiltert werden, indem die Anbieter-ID im Anfrage-Header eingefügt wird. Dies beschränkt den Umfang aller Werkzeuge und verhindert Datenlecks zwischen Anbietern:
```json theme={null}
{
"mcpServers": {
"topsort-analytics": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-server.api.topsort.ai/mcp",
"--header",
"X-API-Key: MPS_xxxx",
"--header",
"X-Vendor-Id: 1111-2222-3333-4444-55555"
]
}
}
}
```
## Werkzeugfilterung
Tags ermöglichen eine feinkörnige Zugriffskontrolle darüber, welche Werkzeuge verschiedenen Clients zur Verfügung stehen. Jedes Werkzeug kann mit einem oder mehreren Tags annotiert werden, und Clients werden ihre eigenen Tag-Sätze zugewiesen.
Beim Abrufen von Werkzeugen filtert das System die Liste, indem es auf Überschneidungen zwischen den Tags des Clients und den erforderlichen Tags jedes Werkzeugs prüft—ein Client benötigt nur ein übereinstimmendes Tag, um Zugriff zu erhalten.
## Integrationsleitfäden
ChatGPT mit Topsort Analytics verbinden
Claude Desktop mit Authentifizierung konfigurieren
Den MCP-Server mit Postman testen
## ChatGPT
ChatGPT unterstützt Remote-MCP-Server für Plus- und Team-Abonnenten.
Navigieren Sie zu [chat.openai.com](https://chat.openai.com) und klicken Sie auf Ihr Profilsymbol, dann wählen Sie **Einstellungen**.
Klicken Sie in der Einstellungsseitenleiste auf **Verbindungen** oder **Integrationen**.
Klicken Sie auf **Verbindung hinzufügen** und geben Sie ein:
* **Name**: `Topsort Analytics`
* **Server-URL**: `https://mcp-server.api.topsort.ai/mcp`
* **Transport-Typ**: `http`
* **Headers**: Fügen Sie `X-API-Key` mit Ihrem API-Schlüssel hinzu
## Claude Desktop
Claude Desktop bietet umfassende lokale MCP-Unterstützung.
### Voraussetzungen
* **Node.js** auf Ihrem System installiert (erforderlich für `mcp-remote`)
### Konfiguration
* **macOS**: Klicken Sie in der Menüleiste auf **Claude** → **Einstellungen**
* **Windows**: Klicken Sie auf **Datei** → **Einstellungen**
Klicken Sie in der linken Seitenleiste auf den **Entwickler**-Tab.
Klicken Sie auf **Config bearbeiten** und fügen Sie hinzu:
```json theme={null}
{
"mcpServers": {
"topsort-analytics": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-server.api.topsort.ai/mcp",
"--header",
"X-API-Key: MPS_xxxx"
]
}
}
}
```
Ersetzen Sie `MPS_xxxx` durch Ihren tatsächlichen API-Schlüssel.
Für anbieterbeschränkten Zugriff fügen Sie ein zusätzliches `--header`-Argument hinzu:
```json theme={null}
{
"mcpServers": {
"topsort-analytics": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-server.api.topsort.ai/mcp",
"--header",
"X-API-Key: MPS_xxxx",
"--header",
"X-Vendor-Id: 1111-2222-3333-4444-55555"
]
}
}
}
```
Speichern Sie die Konfiguration und starten Sie Claude Desktop neu.
## Postman
Sie können den Analytics MCP-Server mit der MCP-Unterstützung von Postman testen.
Starten Sie Postman und navigieren Sie zu **Einstellungen** → **MCP-Server**.
Klicken Sie auf **Server hinzufügen** und konfigurieren Sie:
* **Name**: `Topsort Analytics`
* **URL**: `https://mcp-server.api.topsort.ai/mcp`
Fügen Sie die erforderlichen Headers hinzu:
* `X-API-Key`: Ihr Topsort API-Schlüssel
* `X-Vendor-Id`: (Optional) Anbieter-ID für beschränkten Zugriff
Klicken Sie auf **Verbindung testen**, um zu überprüfen, ob der Server korrekt antwortet.
## Fehlerbehebung
### Verbindungsprobleme
* Überprüfen Sie, dass die URL korrekt ist: `https://mcp-server.api.topsort.ai/mcp`
* Stellen Sie sicher, dass Ihr API-Schlüssel gültig ist und MCP-Server-Zugriff hat
* Überprüfen Sie Ihre Internetverbindung
* Starten Sie Ihre MCP-Client-Anwendung neu
### Authentifizierungsfehler
* Bestätigen Sie, dass Ihr API-Schlüssel mit `MPS_` beginnt
* Überprüfen Sie, dass der `X-API-Key`-Header korrekt formatiert ist
* Kontaktieren Sie Ihren Topsort-Vertriebsmitarbeiter, wenn Ihr Schlüssel abgelehnt wird
### Server antwortet nicht
* Überprüfen Sie, dass der Transport-Typ auf `http` gesetzt ist
* Prüfen Sie, ob Ihre Firewall oder Ihr VPN die Verbindung blockiert
* Konsultieren Sie [unsere Statusseite](https://status.topsort.com) für Dienstunterbrechungen
## Mehr erfahren
* [Model Context Protocol-Dokumentation](https://modelcontextprotocol.io)
* [Liste der MCP-Clients](https://modelcontextprotocol.io/clients)
* [Topsort API-Dokumentation](/api-reference)
* [Dokumentations-MCP-Server](/api/mcp) - Für KI-gestützte API-Integration