Compartir a través de

SuperMCP (versión preliminar)

SuperMCP by Supermetrics : un servidor MCP (Protocolo de contexto de modelo) que proporciona acceso a los datos de marketing desde plataformas conectadas como Google Analytics, Facebook Ads, Google Ads, etc.

Esta API permite a las LLM consultar datos de marketing, detectar orígenes de datos y cuentas, explorar campos disponibles y recuperar métricas de rendimiento.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Supermetrics
URL https://supermetrics.com
Metadatos del conector
Publicador Supermetrics
Sitio web https://supermetrics.com
Directiva de privacidad https://supermetrics.com/privacy
Categorías Mercadotecnia

Conector personalizado de SuperMCP (Supermetrics)

Este conector permite a Microsoft Power Automate, Power Apps y Azure Logic Apps consultar datos de marketing a través de SuperMCP (servidor MCP de Supermetrics).
Úselo para detectar orígenes de datos y cuentas, explorar campos disponibles y ejecutar consultas de rendimiento de marketing.

Publicador

Supermetrics

Tipo de conector

Conector personalizado (Swagger/OpenAPI 2.0)

Servicio o API

API de SuperMCP (servidor MCP)

  • Anfitrión:mcp.supermetrics.com
  • Ruta de acceso base:/
  • Esquema:https

Prerrequisitos

Necesitará lo siguiente:

  • Un entorno de Power Automate o Power Apps en el que puede crear conectores personalizados
  • Una cuenta de Supermetrics con al menos un origen de datos conectado (por ejemplo, Google Analytics, Google Ads, Facebook Ads, etc.). Si no tiene una cuenta de Supermetrics, se creará una con una prueba de 14 días para usted en el primer inicio de sesión.

Autenticación

Este conector usa OAuth 2.0.

Operaciones admitidas

Descubrimiento

  • Detección de orígenes de datos supermétricos disponibles (POST /mcp/data_source_discovery)
  • Detección de cuentas para un origen de datos (POST /mcp/accounts_discovery)
  • Detectar campos disponibles (POST /mcp/field_discovery)

Consulta de datos

  • Ejecución de una consulta de datos asincrónica (POST /mcp/data_query)
    • Devuelve un schedule_id
  • Obtención de los resultados de la consulta asincrónica (POST /mcp/get_async_query_results)
    • Use los resultados hasta que se devuelvan los schedule_id resultados.

Utilidades y recursos (normalmente visibilidad avanzada)

  • Obtener hoy (UTC) (POST /mcp/get_today)
  • Comprobación de estado (GET /mcp/resources/health)

Support

Licencia

Propiedad: © supermétricas

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Comprobación de estado

Obtenga información de configuración y estado de mantenimiento del servidor.
Consulta de datos de marketing de orígenes de datos supermétricos

Consulta de datos de marketing de orígenes de datos supermétricos: devuelve un schedule_id: debe llamar a get_async_query_results para obtener los datos reales.
Detección de campos disponibles para orígenes de datos con información de esquema

Descubra los campos disponibles para los orígenes de datos con información de esquema Llame a esto para ver las métricas y dimensiones disponibles de un origen de datos antes de realizar consultas.
Detección de cuentas disponibles para un origen de datos específico

Descubra las cuentas disponibles para un origen de datos específico Llame a esto después de data_source_discovery para obtener los identificadores de cuenta necesarios para las consultas de datos.
Detección de orígenes de datos supermétricos disponibles

Detectar orígenes de datos supermétricos disponibles Este suele ser el primer paso: llame a esto para ver qué orígenes de datos están disponibles antes de consultar los datos.
Obtención de la información actual de fecha y hora UTC

Obtenga la información de fecha y hora UTC actual: llame a esta primera vez cuando el usuario mencione fechas relativas como "último mes" o "ayer" para conocer la fecha actual.
Recuperación de información de usuario autenticada de Supermetrics

Recuperación de información de usuario autenticada de Supermetrics
Recuperación de resultados de consultas de datos mediante schedule_id

Recupere los resultados de las consultas de datos mediante schedule_id Úselo con el schedule_id de data_query para recuperar los resultados reales de la consulta.

Comprobación de estado

Id. de la operación:
healthCheck

Obtenga información de configuración y estado de mantenimiento del servidor.

Devoluciones

response
string

Consulta de datos de marketing de orígenes de datos supermétricos

Id. de la operación:
dataquery

Consulta de datos de marketing de orígenes de datos supermétricos: devuelve un schedule_id: debe llamar a get_async_query_results para obtener los datos reales.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del origen de datos
 ds_id True string

Identificador de origen de datos que se puede recuperar mediante la herramienta data_source_discovery. Ejemplos: "FA" para Facebook Ads, "AW" para Google Ads, "GAWA" para Google Analytics.
ds_accounts
 ds_accounts True array of string
fields
 fields True array of string
Tipo de intervalo de fechas
 date_range_type string

Elija uno de los dos enfoques:

  1. Use "personalizado" y proporcione start_date y end_date.
  2. Use un intervalo relativo con el formato "last_X_Y" (por ejemplo, "last_7_days", "last_3_months").
    • Puede anexar "_inc" para incluir el período actual (por ejemplo, "last_7_days_inc").

IMPORTANTE: Para cualquier fecha relativa mencionada por el usuario, FIRST llame a get_today herramienta para conocer el año actual y la fecha! Si hay alguna ambigüedad sobre el período de tiempo (por ejemplo, el significado de "today", "this week", "last august" o frases similares), llame a la get_today herramienta para confirmar el año actual y la fecha, use esa respuesta para rellenar este parámetro.
Fecha de inicio
 start_date string

Obligatorio si date_range_type='custom'. Acepta:

  • Fecha exacta en formato AAAA-MM-DD (por ejemplo, "2024-01-01")
  • Fecha de lenguaje natural (por ejemplo, "ayer", "próximo lunes")

IMPORTANTE: Para cualquier fecha relativa mencionada por el usuario, FIRST llame a get_today herramienta para conocer el año actual y la fecha! Si hay ambigüedad sobre la referencia de hora (por ejemplo, frases relativas como "today", "this week", "end of month", llame a la get_today herramienta para confirmar el año actual y la fecha, use esa respuesta para rellenar este parámetro.
Fecha de finalización
 end_date string

Obligatorio si date_range_type='custom'. Acepta:

  • Fecha exacta en formato AAAA-MM-DD (por ejemplo, "2024-01-31")
  • Fecha de lenguaje natural (por ejemplo, "ayer", "último viernes")

IMPORTANTE: Para cualquier fecha relativa mencionada por el usuario, FIRST llame a get_today herramienta para conocer el año actual y la fecha! Si hay ambigüedad sobre la referencia de hora (por ejemplo, frases relativas como "today", "this week", "end of month", llame a la get_today herramienta para confirmar el año actual y la fecha, use esa respuesta para rellenar este parámetro.
Zona horaria
 timezone string

Opcionalmente, establezca la zona horaria para los cálculos de fecha (por ejemplo, "América/New_York", "Europa/Londres", "Asia/Tokio"). Usa nombres de zona horaria de IANA. Si no se especifica, usa UTC.
Filtros
 filters string

Cadena de expresión de filtro. Cada condición tiene el formato: [field_name] [operador] [valor] Condiciones se pueden combinar con AND /OR.

Operadores admitidos:

  • '==' → es igual a
  • '!=' → no es igual que
  • '>' → mayor que
  • '>=' → mayor o igual que
  • '<' → menor que
  • '<=' → menor o igual que
  • '=@' → contiene (sin distinción entre mayúsculas y minúsculas, solo dimensiones)
  • '!@' → no contiene (sin distinción entre mayúsculas y minúsculas, solo dimensiones)
  • '=~' → coincide con la expresión regular (solo dimensiones)
  • '!~' → no coincide con la expresión regular (solo dimensiones)

Ejemplos:

  • "country == Estados Unidos"
  • "country == United States OR country == Canada"
  • "sesiones > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
Configuración
 settings object

Configuración de consulta adicional. Use un objeto JSON, por ejemplo: {"show_all_time_values": true}. Característica avanzada para la configuración específica del origen de datos. Omita a menos que tenga requisitos específicos.
Tipo de período de comparación
 compare_type string

Seleccione cómo comparar los resultados con un período anterior:

  • 'prev_range': período anterior de la misma longitud
  • 'prev_year': mismo período del año anterior
  • 'prev_year_weekday': los mismos días laborables del año anterior
  • "personalizado": período definido por el usuario (requiere compare_start_date y compare_end_date)
Tipo de valor de comparación
 compare_show string

Cómo mostrar la comparación:

  • 'perc_change': cambio porcentual (valor predeterminado)
  • 'abs_change': cambio absoluto
  • 'value': valor sin formato del período de comparación
Fecha de inicio del período de comparación
 compare_start_date string

Obligatorio si compare_type='custom'. Fecha de inicio del período de comparación personalizado, en formato aaaa-MM-DD (por ejemplo, "2024-01-01").
Fecha de finalización del período de comparación
 compare_end_date string

Obligatorio si compare_type='custom'. Fecha de finalización del período de comparación personalizado, en formato aaaa-MM-DD (por ejemplo, "2024-01-31").

Devoluciones

Body
DataqueryResponse

Detección de campos disponibles para orígenes de datos con información de esquema

Id. de la operación:
fielddiscovery

Descubra los campos disponibles para los orígenes de datos con información de esquema Llame a esto para ver las métricas y dimensiones disponibles de un origen de datos antes de realizar consultas.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del origen de datos
 ds_id True string

Identificador de origen de datos que se puede recuperar mediante la herramienta data_source_discovery. Ejemplos: "FA" para Facebook Ads, "AW" para Google Ads, "GAWA" para Google Analytics.
Tipo de campo
 field_type string

Filtrar por tipo de campo (dimensión o métrica)
Comprimir respuesta
 compress boolean

Habilitación de la compresión toon para la respuesta

Devoluciones

Body
FielddiscoveryResponse

Detección de cuentas disponibles para un origen de datos específico

Id. de la operación:
accountsdiscovery

Descubra las cuentas disponibles para un origen de datos específico Llame a esto después de data_source_discovery para obtener los identificadores de cuenta necesarios para las consultas de datos.

Parámetros

Nombre Clave Requerido Tipo Description
Identificador del origen de datos
 ds_id True string

Identificador de origen de datos que se puede recuperar mediante la herramienta data_source_discovery. Ejemplos: "FA" para Facebook Ads, "AW" para Google Ads, "GAWA" para Google Analytics.
Comprimir respuesta
 compress boolean

Habilitación de la compresión toon para la respuesta

Devoluciones

Body
AccountsdiscoveryResponse

Detección de orígenes de datos supermétricos disponibles

Id. de la operación:
datasourcediscovery

Detectar orígenes de datos supermétricos disponibles Este suele ser el primer paso: llame a esto para ver qué orígenes de datos están disponibles antes de consultar los datos.

Parámetros

Nombre Clave Requerido Tipo Description
Comprimir respuesta
 compress boolean

Habilitación de la compresión toon para la respuesta

Devoluciones

Body
DatasourcediscoveryResponse

Obtención de la información actual de fecha y hora UTC

Id. de la operación:
gettoday

Obtenga la información de fecha y hora UTC actual: llame a esta primera vez cuando el usuario mencione fechas relativas como "último mes" o "ayer" para conocer la fecha actual.

Parámetros

Nombre Clave Requerido Tipo Description
object

Devoluciones

Body
GettodayResponse

Recuperación de información de usuario autenticada de Supermetrics

Id. de la operación:
userinfo

Recuperación de información de usuario autenticada de Supermetrics

Parámetros

Nombre Clave Requerido Tipo Description
object

Devoluciones

Body
UserinfoResponse

Recuperación de resultados de consultas de datos mediante schedule_id

Id. de la operación:
getasyncqueryresults

Recupere los resultados de las consultas de datos mediante schedule_id Úselo con el schedule_id de data_query para recuperar los resultados reales de la consulta.

Parámetros

Nombre Clave Requerido Tipo Description
Id. de programación
 schedule_id True string

Identificador de programación devuelto desde una solicitud de data_query. El identificador de programación debe ser exactamente el mismo que se devuelve en la respuesta de data_query. Trate los identificadores como opacos. Copie textualmente. No abreviar, dar formato ni frase.
Comprimir respuesta
 compress boolean

Habilitación de la compresión toon para la respuesta

Devoluciones

Body
GetasyncqueryresultsResponse

Definiciones

AccountsdiscoveryResponse

Nombre Ruta de acceso Tipo Description
correcto
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Nombre Ruta de acceso Tipo Description
correcto
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Nombre Ruta de acceso Tipo Description
correcto
 success boolean
data_sources
 data.data_sources array of object
id
 data.data_sources.id string
nombre
 data.data_sources.name string
categoría
 data.data_sources.category string

FielddiscoveryResponse

Nombre Ruta de acceso Tipo Description
correcto
 success boolean
fuente_de_datos
 data.data_source string
total
 data.total integer
metrics
 data.metrics array of object
id
 data.metrics.id string
nombre
 data.metrics.name string
descripción
 data.metrics.description string
dimensions
 data.dimensions array of object
id
 data.dimensions.id string
nombre
 data.dimensions.name string
descripción
 data.dimensions.description string

GetasyncqueryresultsResponse

Nombre Ruta de acceso Tipo Description
correcto
 success boolean
datos
 data.data array of object
items
 data.data object
estado
 data.status string

GettodayResponse

Nombre Ruta de acceso Tipo Description
correcto
 success boolean
date
 data.date date
iso_string
 data.iso_string string
marca de tiempo
 data.timestamp integer

UserinfoResponse

Nombre Ruta de acceso Tipo Description
correcto
 success boolean
identificador de usuario
 data.user_id string
Correo electrónico
 data.email string
nombre
 data.name string

cuerda / cadena

Este es el tipo de datos básico "string".