Dela via

SuperMCP (förhandsversion)

SuperMCP by Supermetrics – en MCP-server (Model Context Protocol) som ger åtkomst till marknadsföringsdata från anslutna plattformar som Google Analytics, Facebook Ads, Google Ads med mera.

Det här API:et gör det möjligt för LLM:er att fråga efter marknadsföringsdata, identifiera datakällor och konton, utforska tillgängliga fält och hämta prestandamått.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Premie Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Logiska appar Norm Alla Logic Apps-regioner utom följande:
     – Azure Government-regioner
     – Regioner i Azure Kina
     - US Department of Defense (DoD)
Power Apps Premie Alla Power Apps-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Power Automate Premie Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC)
     - Amerikanska myndigheter (GCC High)
     – China Cloud drivs av 21Vianet
     - US Department of Defense (DoD)
Kontakt
Namn Supermetrics
URL https://supermetrics.com
Metadata för anslutningsprogram
Utgivare Supermetrics
Webbplats https://supermetrics.com
Sekretesspolicy https://supermetrics.com/privacy
Kategorier Marknadsföring

Anpassad anslutning för SuperMCP (Supermetrics)

Med den här anslutningsappen kan Microsoft Power Automate, Power Apps och Azure Logic Apps köra frågor mot marknadsföringsdata via SuperMCP (Supermetrics MCP-server).
Använd den för att identifiera datakällor och konton, utforska tillgängliga fält och köra frågor om marknadsföringsprestanda.

Utgivare

Supermetrics

Anslutningstyp

Anpassad anslutningsapp (Swagger/OpenAPI 2.0)

Tjänst/API

SuperMCP API (MCP-server)

  • Värd:mcp.supermetrics.com
  • Bassökväg:/
  • System:https

Förutsättningar

Du behöver:

  • En Power Automate- eller Power Apps-miljö där du kan skapa anpassade anslutningsappar
  • Ett Supermetrics-konto med minst en ansluten datakälla (t.ex. Google Analytics, Google Ads, Facebook Ads osv.). Om du inte har ett Supermetrics-konto skapas ett med en 14-dagars utvärderingsversion för dig vid första inloggningen.

Authentication

Den här anslutningsappen använder OAuth 2.0.

Åtgärder som stöds

Upptäckt

  • Identifiera tillgängliga Supermetrics-datakällor (POST /mcp/data_source_discovery)
  • Identifiera konton för en datakälla (POST /mcp/accounts_discovery)
  • Identifiera tillgängliga fält (POST /mcp/field_discovery)

Datafråga

  • Köra en asynkron datafråga (POST /mcp/data_query)
    • Returnerar en schedule_id
  • Hämta asynkrona frågeresultat (POST /mcp/get_async_query_results)
    • schedule_id Använd tills resultatet returneras

Verktyg/resurser (vanligtvis avancerad synlighet)

  • Hämta idag (UTC) (POST /mcp/get_today)
  • Hälsokontroll (GET /mcp/resources/health)

Support

Licens

Patentskyddad – © supermetri

Begränsningar för strypning

Namn Samtal Förnyelseperioden
API-anrop per anslutning 100 60 sekunder

Åtgärder

Fråga marknadsföringsdata från Supermetrics-datakällor

Fråga marknadsföringsdata från Supermetrics-datakällor Detta returnerar en schedule_id – du måste sedan anropa get_async_query_results för att hämta faktiska data.
Hälsokontroll

Hämta status för serverhälsa och konfigurationsinformation.
Hämta aktuell datum- och tidsinformation för UTC

Hämta aktuell datum- och tidsinformation för UTC Anropa detta först när användaren nämner relativa datum som "förra månaden" eller "igår" för att veta aktuellt datum.
Hämta autentiserad användarinformation från Supermetrics

Hämta autentiserad användarinformation från Supermetrics
Hämta resultat av datafrågor med hjälp av schedule_id

Hämta resultat av datafrågor med hjälp av schedule_id Använd detta med schedule_id från data_query för att hämta faktiska frågeresultat.
Identifiera tillgängliga fält för datakällor med schemainformation

Identifiera tillgängliga fält för datakällor med schemainformation Anropa detta för att se tillgängliga mått och dimensioner för en datakälla innan du frågar.
Identifiera tillgängliga konton för en specifik datakälla

Identifiera tillgängliga konton för en specifik datakälla Anropa detta efter data_source_discovery för att hämta konto-ID:t som behövs för datafrågor.
Identifiera tillgängliga Supermetrics-datakällor

Identifiera tillgängliga Supermetrics-datakällor Detta är vanligtvis det första steget – anropa detta för att se vilka datakällor som är tillgängliga innan du frågar efter data.

Fråga marknadsföringsdata från Supermetrics-datakällor

Operation ID:
dataquery

Fråga marknadsföringsdata från Supermetrics-datakällor Detta returnerar en schedule_id – du måste sedan anropa get_async_query_results för att hämta faktiska data.

Parametrar

Namn Nyckel Krävs Typ Beskrivning
Datakällans ID
 ds_id True string

Datakällans ID som kan hämtas med hjälp av verktyget data_source_discovery. Exempel: "FA" för Facebook Ads, "AW" för Google Ads, "GAWA" för Google Analytics.
ds_accounts
 ds_accounts True array of string
Fält
 fields True array of string
Datumintervalltyp
 date_range_type string

Välj någon av två metoder:

  1. Använd "anpassad" och ange start_date och end_date.
  2. Använd ett relativt intervall i formatet "last_X_Y" (t.ex. "last_7_days", "last_3_months").
    • Du kan lägga till "_inc" för att inkludera den aktuella perioden (t.ex. "last_7_days_inc").

VIKTIGT: För alla relativa datum som nämns av användaren anropar FIRST get_today verktyg för att känna till aktuellt år och datum! Om det finns tvetydigheter om tidsperioden (t.ex. innebörden av "idag", "den här veckan", "i augusti förra året" eller liknande fraser), anropar get_today du verktyget för att bekräfta aktuellt år och datum och använder sedan svaret för att fylla i den här parametern.
Startdatum
 start_date string

Krävs om date_range_type='custom'. Accepterar:

  • Exakt datum i ÅÅÅÅ-MM-DD format (t.ex. "2024-01-01")
  • Datum för naturligt språk (t.ex. "igår", "nästa måndag")

VIKTIGT: För alla relativa datum som nämns av användaren anropar FIRST get_today verktyg för att känna till aktuellt år och datum! Om det finns tvetydigheter om tidsreferensen (t.ex. relativa fraser som "today", "this week", "end of month") anropar du get_today verktyget för att bekräfta aktuellt år och datum och använder sedan svaret för att fylla den här parametern.
Slutdatum
 end_date string

Krävs om date_range_type='custom'. Accepterar:

  • Exakt datum i ÅÅÅÅ-MM-DD format (t.ex. "2024-01-31")
  • Datum för naturligt språk (t.ex. "igår", "förra fredagen")

VIKTIGT: För alla relativa datum som nämns av användaren anropar FIRST get_today verktyg för att känna till aktuellt år och datum! Om det finns tvetydigheter om tidsreferensen (t.ex. relativa fraser som "today", "this week", "end of month") anropar du get_today verktyget för att bekräfta aktuellt år och datum och använder sedan svaret för att fylla den här parametern.
Tidszon
 timezone string

Du kan också ange tidszonen för datumberäkningar (t.ex. "America/New_York", "Europe/London", "Asia/Tokyo"). Använder IANA-tidszonsnamn. Om det inte anges använder UTC.
Filterar
 filters string

Filteruttryckssträng. Varje villkor har formuläret : [field_name] [operator] [value] Villkor kan kombineras med AND/OR.

Operatorer som stöds:

  • '==' → är lika med
  • '!=' → är inte lika med
  • '>' → större än
  • '>=' → större än eller lika med
  • '<' → mindre än
  • '<=' → mindre än eller lika med
  • '=@' → innehåller (skiftlägesokänslig, endast dimensioner)
  • '!@' → innehåller inte (skiftlägesokänslig, endast dimensioner)
  • '=~' → matchar reguljära uttryck (endast dimensioner)
  • '!~' → matchar inte reguljära uttryck (endast dimensioner)

Examples:

  • "country == United States"
  • "country == United States OR country == Canada"
  • "sessions > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
Inställningar
 settings object

Ytterligare frågekonfiguration. Använd ett JSON-objekt, till exempel: {"show_all_time_values": true}. Avancerad funktion för specifika inställningar för datakällor. Hoppa över om du inte har specifika krav.
Jämförelseperiodtyp
 compare_type string

Välj hur du jämför resultat med en tidigare period:

  • "prev_range": föregående period med samma längd
  • "prev_year": samma period föregående år
  • "prev_year_weekday": samma vardagar föregående år
  • "anpassad": användardefinierad period (kräver compare_start_date och compare_end_date)
Jämförelsevärdetyp
 compare_show string

Så här visar du jämförelsen:

  • "perc_change": procentuell ändring (standard)
  • "abs_change": absolut förändring
  • "value": raw-värde från jämförelseperioden
Startdatum för jämförelseperiod
 compare_start_date string

Krävs om compare_type='custom'. Startdatum för den anpassade jämförelseperioden i ÅÅÅÅ-MM-DD format (t.ex. "2024-01-01").
Slutdatum för jämförelseperiod
 compare_end_date string

Krävs om compare_type='custom'. Slutdatum för den anpassade jämförelseperioden i ÅÅÅÅ-MM-DD format (t.ex. "2024-01-31").

Returnerar

Body
DataqueryResponse

Hälsokontroll

Operation ID:
healthCheck

Hämta status för serverhälsa och konfigurationsinformation.

Returnerar

response
string

Hämta aktuell datum- och tidsinformation för UTC

Operation ID:
gettoday

Hämta aktuell datum- och tidsinformation för UTC Anropa detta först när användaren nämner relativa datum som "förra månaden" eller "igår" för att veta aktuellt datum.

Parametrar

Namn Nyckel Krävs Typ Beskrivning
object

Returnerar

Body
GettodayResponse

Hämta autentiserad användarinformation från Supermetrics

Operation ID:
userinfo

Hämta autentiserad användarinformation från Supermetrics

Parametrar

Namn Nyckel Krävs Typ Beskrivning
object

Returnerar

Body
UserinfoResponse

Hämta resultat av datafrågor med hjälp av schedule_id

Operation ID:
getasyncqueryresults

Hämta resultat av datafrågor med hjälp av schedule_id Använd detta med schedule_id från data_query för att hämta faktiska frågeresultat.

Parametrar

Namn Nyckel Krävs Typ Beskrivning
Schema-ID
 schedule_id True string

Schema-ID:t som returnerades från en data_query begäran. Schema-ID måste vara exakt samma som returneras i data_query svar. Behandla ID:er som ogenomskinliga. Kopiera ordagrann. Förkorta inte, formatera eller parafrasera.
Komprimeringssvar
 compress boolean

Aktivera toonkomprimering för svaret

Returnerar

Body
GetasyncqueryresultsResponse

Identifiera tillgängliga fält för datakällor med schemainformation

Operation ID:
fielddiscovery

Identifiera tillgängliga fält för datakällor med schemainformation Anropa detta för att se tillgängliga mått och dimensioner för en datakälla innan du frågar.

Parametrar

Namn Nyckel Krävs Typ Beskrivning
Datakällans ID
 ds_id True string

Datakällans ID som kan hämtas med hjälp av verktyget data_source_discovery. Exempel: "FA" för Facebook Ads, "AW" för Google Ads, "GAWA" för Google Analytics.
Fälttyp
 field_type string

Filtrera efter fälttyp (dimension eller mått)
Komprimeringssvar
 compress boolean

Aktivera toonkomprimering för svaret

Returnerar

Body
FielddiscoveryResponse

Identifiera tillgängliga konton för en specifik datakälla

Operation ID:
accountsdiscovery

Identifiera tillgängliga konton för en specifik datakälla Anropa detta efter data_source_discovery för att hämta konto-ID:t som behövs för datafrågor.

Parametrar

Namn Nyckel Krävs Typ Beskrivning
Datakällans ID
 ds_id True string

Datakällans ID som kan hämtas med hjälp av verktyget data_source_discovery. Exempel: "FA" för Facebook Ads, "AW" för Google Ads, "GAWA" för Google Analytics.
Komprimeringssvar
 compress boolean

Aktivera toonkomprimering för svaret

Returnerar

Body
AccountsdiscoveryResponse

Identifiera tillgängliga Supermetrics-datakällor

Operation ID:
datasourcediscovery

Identifiera tillgängliga Supermetrics-datakällor Detta är vanligtvis det första steget – anropa detta för att se vilka datakällor som är tillgängliga innan du frågar efter data.

Parametrar

Namn Nyckel Krävs Typ Beskrivning
Komprimeringssvar
 compress boolean

Aktivera toonkomprimering för svaret

Returnerar

Body
DatasourcediscoveryResponse

Definitioner

AccountsdiscoveryResponse

Namn Stig Typ Beskrivning
framgång
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Namn Stig Typ Beskrivning
framgång
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Namn Stig Typ Beskrivning
framgång
 success boolean
data_sources
 data.data_sources array of object
Id-nummer
 data.data_sources.id string
name
 data.data_sources.name string
kategori
 data.data_sources.category string

FielddiscoveryResponse

Namn Stig Typ Beskrivning
framgång
 success boolean
datakälla
 data.data_source string
summa
 data.total integer
metrics
 data.metrics array of object
Id-nummer
 data.metrics.id string
name
 data.metrics.name string
beskrivning
 data.metrics.description string
dimensions
 data.dimensions array of object
Id-nummer
 data.dimensions.id string
name
 data.dimensions.name string
beskrivning
 data.dimensions.description string

GetasyncqueryresultsResponse

Namn Stig Typ Beskrivning
framgång
 success boolean
data
 data.data array of object
items
 data.data object
status
 data.status string

GettodayResponse

Namn Stig Typ Beskrivning
framgång
 success boolean
date
 data.date date
iso_string
 data.iso_string string
tidsstämpel
 data.timestamp integer

UserinfoResponse

Namn Stig Typ Beskrivning
framgång
 success boolean
användar-ID
 data.user_id string
Mejladress
 data.email string
name
 data.name string

snöre

Det här är den grundläggande datatypen "string".