Freigeben über

SuperMCP (Vorschau)

SuperMCP by Supermetrics – Ein MCP-Server (Model Context Protocol), der Zugriff auf Marketingdaten von verbundenen Plattformen wie Google Analytics, Facebook Ads, Google Ads und mehr ermöglicht.

Diese API ermöglicht LLMs, Marketingdaten abzufragen, Datenquellen und Konten zu ermitteln, verfügbare Felder zu untersuchen und Leistungsmetriken abzurufen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Supermetrische Metriken
URL https://supermetrics.com
Connectormetadaten
Herausgeber Supermetrische Metriken
Webseite https://supermetrics.com
Datenschutzrichtlinie https://supermetrics.com/privacy
Kategorien Marketing

Benutzerdefinierter Connector für SuperMCP (Supermetrics)

Mit diesem Connector können Microsoft Power Automate, Power Apps und Azure Logic Apps Marketingdaten über den MCP-Server von SuperMCP (Supermetrics) abfragen.
Verwenden Sie sie, um Datenquellen und Konten zu ermitteln, verfügbare Felder zu erkunden und Marketingleistungsabfragen auszuführen.

Herausgeber

Supermetrics

Konnektortyp

Benutzerdefinierter Connector (Swagger/OpenAPI 2.0)

Dienst/ API

SuperMCP-API (MCP-Server)

  • Gastgeber:mcp.supermetrics.com
  • Basispfad:/
  • Schema:https

Voraussetzungen

Sie benötigen Folgendes:

  • Eine Power Automate- oder Power Apps-Umgebung, in der Sie benutzerdefinierte Connectors erstellen können
  • Ein Supermetrics-Konto mit mindestens einer verbundenen Datenquelle (z. B. Google Analytics, Google Ads, Facebook Ads usw.). Wenn Sie kein Supermetrics-Konto haben, wird ein Konto mit einer 14-tägigen Testversion für Sie bei der ersten Anmeldung erstellt.

Authentifizierung

Dieser Connector verwendet OAuth 2.0.

Unterstützte Vorgänge

Ermittlung

  • Ermitteln verfügbarer Supermetrischer Datenquellen (POST /mcp/data_source_discovery)
  • Ermitteln von Konten für eine Datenquelle (POST /mcp/accounts_discovery)
  • Ermitteln verfügbarer Felder (POST /mcp/field_discovery)

Datenabfrage

  • Ausführen einer asynchronen Datenabfrage (POST /mcp/data_query)
    • Gibt einen Wert zurück. schedule_id
  • Abrufen asynchroner Abfrageergebnisse (POST /mcp/get_async_query_results)
    • Verwenden Sie die schedule_id Zeit, bis Ergebnisse zurückgegeben werden.

Dienstprogramme /Ressourcen (in der Regel erweiterte Sichtbarkeit)

  • Heute abrufen (UTC) (POST /mcp/get_today)
  • Integritätsprüfung (GET /mcp/resources/health)

Support

Lizenz

Proprietäre - © Supermetrische

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abfragen von Marketingdaten aus Supermetrics-Datenquellen

Abfragen von Marketingdaten aus Supermetrics-Datenquellen Diese gibt eine schedule_id zurück. Anschließend müssen Sie get_async_query_results aufrufen, um die tatsächlichen Daten abzurufen.
Abrufen der aktuellen UTC-Datums- und Uhrzeitinformationen

Abrufen der aktuellen UTC-Datums- und Uhrzeitinformationen Rufen Sie dies zuerst auf, wenn der Benutzer relative Datumsangaben wie "letzter Monat" oder "gestern" erwähnt, um das aktuelle Datum zu kennen.
Abrufen von authentifizierten Benutzerinformationen aus Supermetrics

Abrufen von authentifizierten Benutzerinformationen aus Supermetrics
Abrufen von Ergebnissen von Datenabfragen mithilfe von schedule_id

Abrufen von Ergebnissen von Datenabfragen mithilfe von schedule_id Verwenden Sie dies mit der schedule_id aus data_query, um tatsächliche Abfrageergebnisse abzurufen.
Ermitteln verfügbarer Felder für Datenquellen mit Schemainformationen

Ermitteln Sie verfügbare Felder für Datenquellen mit Schemainformationen Rufen Sie diese auf, um verfügbare Metriken und Dimensionen für eine Datenquelle vor der Abfrage anzuzeigen.
Ermitteln verfügbarer Konten für eine bestimmte Datenquelle

Ermitteln Sie verfügbare Konten für einen bestimmten Datenquellenaufruf, nachdem data_source_discovery, um Konto-IDs abzurufen, die für Datenabfragen erforderlich sind.
Ermitteln verfügbarer Supermetrischer Datenquellen

Entdecken Sie verfügbare Supermetrische Datenquellen Dies ist in der Regel der erste Schritt – rufen Sie dies auf, um zu sehen, welche Datenquellen verfügbar sind, bevor Sie Daten abfragen.
Gesundheitscheck

Abrufen des Serverstatus und der Konfigurationsinformationen.

Abfragen von Marketingdaten aus Supermetrics-Datenquellen

Vorgangs-ID:
dataquery

Abfragen von Marketingdaten aus Supermetrics-Datenquellen Diese gibt eine schedule_id zurück. Anschließend müssen Sie get_async_query_results aufrufen, um die tatsächlichen Daten abzurufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datenquellen-ID
 ds_id True string

Datenquellen-ID, die mithilfe des tools data_source_discovery abgerufen werden kann. Beispiele: "FA" für Facebook-Anzeigen, "AW" für Google Ads, "GAWA" für Google Analytics.
ds_accounts
 ds_accounts True array of string
fields
 fields True array of string
Datumsbereichstyp
 date_range_type string

Wählen Sie eine von zwei Ansätzen aus:

  1. Verwenden Sie "benutzerdefiniert", und stellen Sie start_date und end_date bereit.
  2. Verwenden Sie einen relativen Bereich im Format "last_X_Y" (z. B. "last_7_days", "last_3_months").
    • Sie können "_inc" anfügen, um den aktuellen Punkt einzuschließen (z. B. "last_7_days_inc").

WICHTIG: Rufen Sie für jedes relative Datum, das vom Benutzer erwähnt wird, zuerst get_today Tool auf, um das aktuelle Jahr und das aktuelle Datum zu kennen! Wenn mehrdeutig über den Zeitraum (z. B. die Bedeutung von "heute", "diese Woche", "letzte August" oder ähnliche Ausdrücke) vorhanden ist, rufen Sie das get_today Tool auf, um das aktuelle Jahr und das aktuelle Datum zu bestätigen, und verwenden Sie diese Antwort, um diesen Parameter auszufüllen.
Startdatum
 start_date string

Erforderlich, wenn date_range_type='custom'. Akzeptiert:

  • Genaues Datum im Format JJJJ-MM-DD (z. B. "2024-01-01")
  • Datum der natürlichen Sprache (z. B. "gestern", "nächster Montag")

WICHTIG: Rufen Sie für jedes relative Datum, das vom Benutzer erwähnt wird, zuerst get_today Tool auf, um das aktuelle Jahr und das aktuelle Datum zu kennen! Wenn mehrdeutig über den Zeitverweis (z. B. relative Ausdrücke wie "heute", "diese Woche", "Monatsende") vorhanden sind, rufen Sie das get_today Tool auf, um das aktuelle Jahr und das aktuelle Datum zu bestätigen, und verwenden Sie diese Antwort, um diesen Parameter auszufüllen.
Enddatum
 end_date string

Erforderlich, wenn date_range_type='custom'. Akzeptiert:

  • Genaues Datum im Format JJJJ-MM-DD (z. B. "2024-01-31"))
  • Datum der natürlichen Sprache (z. B. "gestern", "letzter Freitag")

WICHTIG: Rufen Sie für jedes relative Datum, das vom Benutzer erwähnt wird, zuerst get_today Tool auf, um das aktuelle Jahr und das aktuelle Datum zu kennen! Wenn mehrdeutig über den Zeitverweis (z. B. relative Ausdrücke wie "heute", "diese Woche", "Monatsende") vorhanden sind, rufen Sie das get_today Tool auf, um das aktuelle Jahr und das aktuelle Datum zu bestätigen, und verwenden Sie diese Antwort, um diesen Parameter auszufüllen.
Zeitzone
 timezone string

Legen Sie optional die Zeitzone für Datumsberechnungen fest (z. B. "America/New_York", "Europe/London", "Asia/Tokyo"). Verwendet IANA-Zeitzonennamen. Wenn nicht angegeben, wird UTC verwendet.
Filter
 filters string

Filterausdruckszeichenfolge. Jede Bedingung hat die Form: [field_name] [Operator] [Wert] Bedingungen können mit AND / OR kombiniert werden.

Unterstützte Operatoren:

  • '==' → entspricht
  • '!=' → ist nicht gleich
  • "" →> größer als
  • '>=' → größer oder gleich
  • "<" → kleiner als
  • '<=' → kleiner oder gleich
  • '=@' → enthält (nur Groß-/Kleinschreibung, Dimensionen)
  • '!@' → enthält keine Groß-/Kleinschreibung( nur Dimensionen).
  • "=~" → entspricht dem regulären Ausdruck (nur Dimensionen)
  • '!~' → stimmt nicht mit dem regulären Ausdruck überein (nur Dimensionen)

Beispiele

  • "Land == Vereinigte Staaten"
  • "Land == Vereinigte Staaten ODER Land == Kanada"
  • "Sessions > 1000 AND deviceCategory == Mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
Einstellungen
 settings object

Zusätzliche Abfragekonfiguration. Verwenden Sie ein JSON-Objekt, z. B. {"show_all_time_values": true}. Erweiterte Funktion für bestimmte Datenquelleneinstellungen. Überspringen Sie, es sei denn, Sie haben bestimmte Anforderungen.
Vergleichszeitraumstyp
 compare_type string

Wählen Sie aus, wie Ergebnisse mit einem früheren Zeitraum verglichen werden sollen:

  • "prev_range": vorheriger Zeitraum derselben Länge
  • "prev_year": Selben Zeitraum im Vorjahr
  • "prev_year_weekday": dieselben Wochentage im Vorjahr
  • "benutzerdefiniert": Benutzerdefinierter Zeitraum (erfordert compare_start_date und compare_end_date)
Vergleichswerttyp
 compare_show string

So zeigen Sie den Vergleich an:

  • 'perc_change': Prozentuale Änderung (Standard)
  • 'abs_change': absolute Veränderung
  • 'value': Rohwert aus dem Vergleichszeitraum
Startdatum des Vergleichszeitraums
 compare_start_date string

Erforderlich, wenn compare_type='custom'. Startdatum des benutzerdefinierten Vergleichszeitraums im Format JJJJ-MM-DD (z. B. "2024-01-01").
Enddatum des Vergleichszeitraums
 compare_end_date string

Erforderlich, wenn compare_type='custom'. Enddatum des benutzerdefinierten Vergleichszeitraums im Format JJJJ-MM-DD (z. B. "2024-01-31").

Gibt zurück

Body
DataqueryResponse

Abrufen der aktuellen UTC-Datums- und Uhrzeitinformationen

Vorgangs-ID:
gettoday

Abrufen der aktuellen UTC-Datums- und Uhrzeitinformationen Rufen Sie dies zuerst auf, wenn der Benutzer relative Datumsangaben wie "letzter Monat" oder "gestern" erwähnt, um das aktuelle Datum zu kennen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
object

Gibt zurück

Body
GettodayResponse

Abrufen von authentifizierten Benutzerinformationen aus Supermetrics

Vorgangs-ID:
userinfo

Abrufen von authentifizierten Benutzerinformationen aus Supermetrics

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
object

Gibt zurück

Body
UserinfoResponse

Abrufen von Ergebnissen von Datenabfragen mithilfe von schedule_id

Vorgangs-ID:
getasyncqueryresults

Abrufen von Ergebnissen von Datenabfragen mithilfe von schedule_id Verwenden Sie dies mit der schedule_id aus data_query, um tatsächliche Abfrageergebnisse abzurufen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Zeitplan-ID
 schedule_id True string

Die von einer data_query Anforderung zurückgegebene Zeitplan-ID. Die Terminplan-ID muss genau mit der in der antwort data_query zurückgegebenen Id übereinstimmen. Behandeln Sie IDs als undurchsichtig. Kopieren Sie verbatim. Nicht kürzen, formatieren oder paraphrasen.
Komprimieren der Antwort
 compress boolean

Aktivieren der Toon-Komprimierung für die Antwort

Gibt zurück

Body
GetasyncqueryresultsResponse

Ermitteln verfügbarer Felder für Datenquellen mit Schemainformationen

Vorgangs-ID:
fielddiscovery

Ermitteln Sie verfügbare Felder für Datenquellen mit Schemainformationen Rufen Sie diese auf, um verfügbare Metriken und Dimensionen für eine Datenquelle vor der Abfrage anzuzeigen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datenquellen-ID
 ds_id True string

Datenquellen-ID, die mithilfe des tools data_source_discovery abgerufen werden kann. Beispiele: "FA" für Facebook-Anzeigen, "AW" für Google Ads, "GAWA" für Google Analytics.
Feldtyp
 field_type string

Filtern nach Feldtyp (Dimension oder Metrik)
Komprimieren der Antwort
 compress boolean

Aktivieren der Toon-Komprimierung für die Antwort

Gibt zurück

Body
FielddiscoveryResponse

Ermitteln verfügbarer Konten für eine bestimmte Datenquelle

Vorgangs-ID:
accountsdiscovery

Ermitteln Sie verfügbare Konten für einen bestimmten Datenquellenaufruf, nachdem data_source_discovery, um Konto-IDs abzurufen, die für Datenabfragen erforderlich sind.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Datenquellen-ID
 ds_id True string

Datenquellen-ID, die mithilfe des tools data_source_discovery abgerufen werden kann. Beispiele: "FA" für Facebook-Anzeigen, "AW" für Google Ads, "GAWA" für Google Analytics.
Komprimieren der Antwort
 compress boolean

Aktivieren der Toon-Komprimierung für die Antwort

Gibt zurück

Body
AccountsdiscoveryResponse

Ermitteln verfügbarer Supermetrischer Datenquellen

Vorgangs-ID:
datasourcediscovery

Entdecken Sie verfügbare Supermetrische Datenquellen Dies ist in der Regel der erste Schritt – rufen Sie dies auf, um zu sehen, welche Datenquellen verfügbar sind, bevor Sie Daten abfragen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Komprimieren der Antwort
 compress boolean

Aktivieren der Toon-Komprimierung für die Antwort

Gibt zurück

Body
DatasourcediscoveryResponse

Gesundheitscheck

Vorgangs-ID:
healthCheck

Abrufen des Serverstatus und der Konfigurationsinformationen.

Gibt zurück

response
string

Definitionen

AccountsdiscoveryResponse

Name Pfad Typ Beschreibung
success
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Name Pfad Typ Beschreibung
success
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Name Pfad Typ Beschreibung
success
 success boolean
data_sources
 data.data_sources array of object
id
 data.data_sources.id string
name
 data.data_sources.name string
Kategorie
 data.data_sources.category string

FielddiscoveryResponse

Name Pfad Typ Beschreibung
success
 success boolean
Datenquelle
 data.data_source string
gesamt
 data.total integer
metrics
 data.metrics array of object
id
 data.metrics.id string
name
 data.metrics.name string
Beschreibung
 data.metrics.description string
dimensions
 data.dimensions array of object
id
 data.dimensions.id string
name
 data.dimensions.name string
Beschreibung
 data.dimensions.description string

GetasyncqueryresultsResponse

Name Pfad Typ Beschreibung
success
 success boolean
Daten
 data.data array of object
items
 data.data object
status
 data.status string

GettodayResponse

Name Pfad Typ Beschreibung
success
 success boolean
date
 data.date date
iso_string
 data.iso_string string
Zeitstempel
 data.timestamp integer

UserinfoResponse

Name Pfad Typ Beschreibung
success
 success boolean
Benutzer-ID
 data.user_id string
E-Mail
 data.email string
name
 data.name string

Schnur

Dies ist der grundlegende Datentyp "string".