Zum Hauptinhalt springen
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 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: 
{
  "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: 
{
  "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

ChatGPT mit Topsort Analytics verbinden

Claude Desktop

Claude Desktop mit Authentifizierung konfigurieren

Postman

Den MCP-Server mit Postman testen

​
ChatGPT

ChatGPT unterstützt Remote-MCP-Server für Plus- und Team-Abonnenten.
1

ChatGPT-Einstellungen öffnen

Navigieren Sie zu chat.openai.com und klicken Sie auf Ihr Profilsymbol, dann wählen Sie Einstellungen.
2

Auf Verbindungen zugreifen

Klicken Sie in der Einstellungsseitenleiste auf Verbindungen oder Integrationen.
3

MCP-Server hinzufügen

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

1

Claude Desktop-Einstellungen öffnen

  • macOS: Klicken Sie in der Menüleiste auf Claude → Einstellungen
  • Windows: Klicken Sie auf Datei → Einstellungen
2

Zum Entwickler-Tab navigieren

Klicken Sie in der linken Seitenleiste auf den Entwickler-Tab.
3

MCP-Konfiguration bearbeiten

Klicken Sie auf Config bearbeiten und fügen Sie hinzu:
{
  "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:
{
  "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"
      ]
    }
  }
}
4

Claude Desktop neu starten

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.
1

Postman öffnen

Starten Sie Postman und navigieren Sie zu Einstellungen → MCP-Server.
2

Neuen Server hinzufügen

Klicken Sie auf Server hinzufügen und konfigurieren Sie:
  • Name: Topsort Analytics
  • URL: https://mcp-server.api.topsort.ai/mcp
3

Headers konfigurieren

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
4

Verbindung testen

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 für Dienstunterbrechungen

​
Mehr erfahren