Partager via

SuperMCP (préversion)

SuperMCP par Supermetrics - Un serveur MCP (Model Context Protocol) fournissant l’accès aux données marketing à partir de plateformes connectées telles que Google Analytics, Facebook Ads, Google Ads, etc.

Cette API permet aux llms d’interroger des données marketing, de découvrir des sources de données et des comptes, d’explorer les champs disponibles et de récupérer les métriques de performances.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Supermetrics
URL https://supermetrics.com
Métadonnées du connecteur
Éditeur Supermetrics
Site web https://supermetrics.com
Politique de confidentialité https://supermetrics.com/privacy
Catégories Commercialisation

Connecteur personnalisé SuperMCP (Supermetrics)

Ce connecteur permet à Microsoft Power Automate, Power Apps et Azure Logic Apps d’interroger des données marketing via le serveur SUPERMCP (serveur MCP de Supermetrics).
Utilisez-le pour découvrir les sources de données et les comptes, explorer les champs disponibles et exécuter des requêtes de performances marketing.

Éditeur

Supermetrics

Type de connecteur

Connecteur personnalisé (Swagger/OpenAPI 2.0)

Service / API

API SuperMCP (serveur MCP)

  • Hôte:mcp.supermetrics.com
  • Chemin d’accès de base :/
  • Régime:https

Prerequisites

Vous aurez besoin des éléments suivants :

  • Un environnement Power Automate ou Power Apps dans lequel vous pouvez créer des connecteurs personnalisés
  • Un compte Supermetrics avec au moins une source de données connectée (par exemple, Google Analytics, Google Ads, Facebook Ads, etc.). Si vous n’avez pas de compte Supermetrics, un compte avec une version d’évaluation de 14 jours sera créé pour vous lors de la première connexion.

Authentication

Ce connecteur utilise OAuth 2.0.

Opérations prises en charge

Découverte

  • Découvrir les sources de données Supermetrics disponibles (POST /mcp/data_source_discovery)
  • Découvrir des comptes pour une source de données (POST /mcp/accounts_discovery)
  • Découvrir les champs disponibles (POST /mcp/field_discovery)

Requête de données

  • Exécuter une requête de données asynchrone (POST /mcp/data_query)
    • Retourne un schedule_id
  • Obtenir les résultats des requêtes asynchrones (POST /mcp/get_async_query_results)
    • Utiliser les résultats jusqu’à ce que les schedule_id résultats soient retournés

Utilitaires / ressources (généralement une visibilité avancée)

  • Obtenir aujourd’hui (UTC) (POST /mcp/get_today)
  • Contrôle d’intégrité (GET /mcp/resources/health)

Support

Licence

Propriétaire — © Supermétriques

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Bilan de santé

Obtenir l’état d’intégrité du serveur et les informations de configuration.
Découvrir les champs disponibles pour les sources de données avec des informations de schéma

Découvrez les champs disponibles pour les sources de données avec des informations de schéma Appelez ceci pour afficher les métriques et dimensions disponibles pour une source de données avant d’interroger.
Découvrir les comptes disponibles pour une source de données spécifique

Découvrez les comptes disponibles pour un appel de source de données spécifique après data_source_discovery pour obtenir les ID de compte nécessaires pour les requêtes de données.
Découvrir les sources de données Supermetrics disponibles

Découvrez les sources de données Supermetrics disponibles. Il s’agit généralement de la première étape : appelez-la pour voir quelles sources de données sont disponibles avant d’interroger les données.
Interroger des données marketing à partir de sources de données Supermetrics

Interroger des données marketing à partir de sources de données Supermetrics Cette opération retourne un schedule_id : vous devez ensuite appeler get_async_query_results pour obtenir les données réelles.
Obtenir les informations de date et d’heure UTC actuelles

Obtenez les informations de date et d’heure UTC actuelles Appelez-la pour la première fois quand l’utilisateur mentionne des dates relatives telles que « dernier mois » ou « hier » pour connaître la date actuelle.
Récupérer des informations utilisateur authentifiées à partir de Supermetrics

Récupérer des informations utilisateur authentifiées à partir de Supermetrics
Récupérer les résultats des requêtes de données à l’aide de schedule_id

Récupérez les résultats des requêtes de données à l’aide de schedule_id Utilisez-le avec le schedule_id de data_query pour récupérer les résultats de requête réels.

Bilan de santé

ID d’opération :
healthCheck

Obtenir l’état d’intégrité du serveur et les informations de configuration.

Retours

response
string

Découvrir les champs disponibles pour les sources de données avec des informations de schéma

ID d’opération :
fielddiscovery

Découvrez les champs disponibles pour les sources de données avec des informations de schéma Appelez ceci pour afficher les métriques et dimensions disponibles pour une source de données avant d’interroger.

Paramètres

Nom Clé Obligatoire Type Description
ID de source de données
 ds_id True string

ID de source de données qui peut être récupéré à l’aide de l’outil data_source_discovery. Exemples : « FA » pour Facebook Ads, « AW » pour Google Ads, « GAWA » pour Google Analytics.
Type de champ
 field_type string

Filtrer par type de champ (dimension ou métrique)
Compresser la réponse
 compress boolean

Activer la compression toon pour la réponse

Retours

Corps
FielddiscoveryResponse

Découvrir les comptes disponibles pour une source de données spécifique

ID d’opération :
accountsdiscovery

Découvrez les comptes disponibles pour un appel de source de données spécifique après data_source_discovery pour obtenir les ID de compte nécessaires pour les requêtes de données.

Paramètres

Nom Clé Obligatoire Type Description
ID de source de données
 ds_id True string

ID de source de données qui peut être récupéré à l’aide de l’outil data_source_discovery. Exemples : « FA » pour Facebook Ads, « AW » pour Google Ads, « GAWA » pour Google Analytics.
Compresser la réponse
 compress boolean

Activer la compression toon pour la réponse

Retours

Corps
AccountsdiscoveryResponse

Découvrir les sources de données Supermetrics disponibles

ID d’opération :
datasourcediscovery

Découvrez les sources de données Supermetrics disponibles. Il s’agit généralement de la première étape : appelez-la pour voir quelles sources de données sont disponibles avant d’interroger les données.

Paramètres

Nom Clé Obligatoire Type Description
Compresser la réponse
 compress boolean

Activer la compression toon pour la réponse

Retours

Corps
DatasourcediscoveryResponse

Interroger des données marketing à partir de sources de données Supermetrics

ID d’opération :
dataquery

Interroger des données marketing à partir de sources de données Supermetrics Cette opération retourne un schedule_id : vous devez ensuite appeler get_async_query_results pour obtenir les données réelles.

Paramètres

Nom Clé Obligatoire Type Description
ID de source de données
 ds_id True string

ID de source de données qui peut être récupéré à l’aide de l’outil data_source_discovery. Exemples : « FA » pour Facebook Ads, « AW » pour Google Ads, « GAWA » pour Google Analytics.
ds_accounts
 ds_accounts True array of string
fields
 fields True array of string
Type de plage de dates
 date_range_type string

Choisissez l’une des deux approches suivantes :

  1. Utilisez « personnalisé » et fournissez start_date et end_date.
  2. Utilisez une plage relative au format « last_X_Y » (par exemple, « last_7_days », « last_3_months »).
    • Vous pouvez ajouter « _inc » pour inclure la période actuelle (par exemple, « last_7_days_inc »).

IMPORTANT : Pour toute date relative mentionnée par l’utilisateur, appelez d’abord get_today outil pour connaître l’année et la date actuelles ! S’il existe une ambiguïté sur la période (par exemple, la signification de « aujourd’hui », « cette semaine », « dernier août » ou des expressions similaires), appelez l’outil get_today pour confirmer l’année et la date actuelles, puis utilisez cette réponse pour remplir ce paramètre.
Date de début
 start_date string

Obligatoire si date_range_type='custom'. Accepte:

  • Date exacte au format AAAA -MM-DD (par exemple, '2024-01-01')
  • Date du langage naturel (par exemple, « hier », « lundi prochain »)

IMPORTANT : Pour toute date relative mentionnée par l’utilisateur, appelez d’abord get_today outil pour connaître l’année et la date actuelles ! S’il y a ambiguïté concernant la référence temporelle (par exemple, les expressions relatives telles que « aujourd’hui », « cette semaine », « fin du mois »), appelez l’outil get_today pour confirmer l’année et la date actuelles, puis utilisez cette réponse pour remplir ce paramètre.
Date de fin
 end_date string

Obligatoire si date_range_type='custom'. Accepte:

  • Date exacte au format AAAA -MM-DD (par exemple, « 2024-01-31 »)
  • Date du langage naturel (par exemple, « hier », « dernier vendredi »)

IMPORTANT : Pour toute date relative mentionnée par l’utilisateur, appelez d’abord get_today outil pour connaître l’année et la date actuelles ! S’il y a ambiguïté concernant la référence temporelle (par exemple, les expressions relatives telles que « aujourd’hui », « cette semaine », « fin du mois »), appelez l’outil get_today pour confirmer l’année et la date actuelles, puis utilisez cette réponse pour remplir ce paramètre.
Fuseau horaire
 timezone string

Si vous le souhaitez, définissez le fuseau horaire pour les calculs de date (par exemple, « Amérique/New_York », « Europe/Londres », « Asie/Tokyo »). Utilise des noms de fuseau horaire IANA. Si ce n’est pas spécifié, utilise UTC.
Filtres
 filters string

Chaîne d’expression de filtre. Chaque condition a la forme : [field_name] [operator] [value] Conditions peuvent être combinées avec AND/OR.

Opérateurs pris en charge :

  • '==' → égal
  • ' !=' → n’est pas égal à
  • '>' → supérieur à
  • '>=' → supérieur ou égal à
  • '<' → inférieur à
  • '<=' → inférieur ou égal à
  • '=@' → contient (ne respectant pas la casse, dimensions uniquement)
  • ' !@' → ne contient pas (sans respect de la casse, dimensions uniquement)
  • '=~' → correspond à l’expression régulière (dimensions uniquement)
  • ' !~' → ne correspond pas à l’expression régulière (dimensions uniquement)

Exemples :

  • « country == États-Unis »
  • « country == United States OR country == Canada »
  • « sessions > 1000 AND deviceCategory == mobile »
  • « campaign_name =@ spring_sale »
  • « pagePath =~ ^/products/.* »
Paramètres
 settings object

Configuration de requête supplémentaire. Utilisez un objet JSON, par exemple : {"show_all_time_values » : true}. Fonctionnalité avancée pour des paramètres de source de données spécifiques. Ignorez sauf si vous avez des exigences spécifiques.
Type de période de comparaison
 compare_type string

Sélectionnez comment comparer les résultats à une période antérieure :

  • 'prev_range' : période précédente de la même longueur
  • 'prev_year' : même période de l’année précédente
  • 'prev_year_weekday' : mêmes jours de semaine de l’année précédente
  • 'custom' : période définie par l’utilisateur (nécessite compare_start_date et compare_end_date)
Type de valeur de comparaison
 compare_show string

Comment afficher la comparaison :

  • 'perc_change' : pourcentage de modification (par défaut)
  • 'abs_change' : changement absolu
  • 'value' : valeur brute de la période de comparaison
Date de début de la période de comparaison
 compare_start_date string

Obligatoire si compare_type='custom'. Date de début de la période de comparaison personnalisée, au format aaaa-MM-DD (par exemple, « 2024-01-01 »).
Date de fin de la période de comparaison
 compare_end_date string

Obligatoire si compare_type='custom'. Date de fin de la période de comparaison personnalisée, au format aaaa-MM-DD (par exemple, « 2024-01-31 »).

Retours

Corps
DataqueryResponse

Obtenir les informations de date et d’heure UTC actuelles

ID d’opération :
gettoday

Obtenez les informations de date et d’heure UTC actuelles Appelez-la pour la première fois quand l’utilisateur mentionne des dates relatives telles que « dernier mois » ou « hier » pour connaître la date actuelle.

Paramètres

Nom Clé Obligatoire Type Description
object

Retours

Corps
GettodayResponse

Récupérer des informations utilisateur authentifiées à partir de Supermetrics

ID d’opération :
userinfo

Récupérer des informations utilisateur authentifiées à partir de Supermetrics

Paramètres

Nom Clé Obligatoire Type Description
object

Retours

Corps
UserinfoResponse

Récupérer les résultats des requêtes de données à l’aide de schedule_id

ID d’opération :
getasyncqueryresults

Récupérez les résultats des requêtes de données à l’aide de schedule_id Utilisez-le avec le schedule_id de data_query pour récupérer les résultats de requête réels.

Paramètres

Nom Clé Obligatoire Type Description
ID de planification
 schedule_id True string

ID de planification retourné à partir d’une demande de data_query. L’ID de planification doit être exactement le même que celui retourné dans la réponse data_query. Traitez les ID comme opaques. Copiez un verbatim. Ne pas abrégér, mettre en forme ou paraphrase.
Compresser la réponse
 compress boolean

Activer la compression toon pour la réponse

Retours

Corps
GetasyncqueryresultsResponse

Définitions

AccountsdiscoveryResponse

Nom Chemin d’accès Type Description
success
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Nom Chemin d’accès Type Description
success
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Nom Chemin d’accès Type Description
success
 success boolean
data_sources
 data.data_sources array of object
pièce d'identité
 data.data_sources.id string
nom
 data.data_sources.name string
catégorie
 data.data_sources.category string

FielddiscoveryResponse

Nom Chemin d’accès Type Description
success
 success boolean
source de données
 data.data_source string
total
 data.total integer
metrics
 data.metrics array of object
pièce d'identité
 data.metrics.id string
nom
 data.metrics.name string
descriptif
 data.metrics.description string
dimensions
 data.dimensions array of object
pièce d'identité
 data.dimensions.id string
nom
 data.dimensions.name string
descriptif
 data.dimensions.description string

GetasyncqueryresultsResponse

Nom Chemin d’accès Type Description
success
 success boolean
données
 data.data array of object
items
 data.data object
status
 data.status string

GettodayResponse

Nom Chemin d’accès Type Description
success
 success boolean
date
 data.date date
iso_string
 data.iso_string string
horodatage
 data.timestamp integer

UserinfoResponse

Nom Chemin d’accès Type Description
success
 success boolean
identifiant_utilisateur
 data.user_id string
Messagerie électronique
 data.email string
nom
 data.name string

ficelle

Il s’agit du type de données de base « string ».