Compartilhar via

SuperMCP (versão prévia)

SuperMCP by Supermetrics - Um servidor MCP (Protocolo de Contexto de Modelo) que fornece acesso a dados de marketing de plataformas conectadas como Google Analytics, Anúncios do Facebook, Google Ads e muito mais.

Essa API permite que as LLMs consultem dados de marketing, descubram fontes de dados e contas, explorem campos disponíveis e recuperem métricas de desempenho.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Supermetrics
URL https://supermetrics.com
Metadados do conector
Publicador Supermetrics
Site da Web https://supermetrics.com
Política de privacidade https://supermetrics.com/privacy
Categorias Marketing

Conector Personalizado supermcp (supermétrico)

Esse conector permite que o Microsoft Power Automate, o Power Apps e os Aplicativos Lógicos do Azure consultem dados de marketing por meio do SuperMCP (servidor MCP da Supermetrics).
Use-o para descobrir fontes de dados e contas, explorar campos disponíveis e executar consultas de desempenho de marketing.

Publicador

Supermetrics

Tipo de conector

Conector Personalizado (Swagger/OpenAPI 2.0)

Serviço/API

API do SuperMCP (servidor MCP)

  • Anfitrião:mcp.supermetrics.com
  • Caminho base:/
  • Esquema:https

Pré-requisitos

Você precisará de:

  • Um ambiente do Power Automate ou do Power Apps em que você pode criar conectores personalizados
  • Uma conta supermétrica com pelo menos uma fonte de dados conectada (por exemplo, Google Analytics, Google Ads, Anúncios do Facebook etc.). Se você não tiver uma conta supermétrica, uma com uma avaliação de 14 dias será criada para você no primeiro logon.

Authentication

Esse conector usa o OAuth 2.0.

Operações com suporte

Descoberta

  • Descobrir fontes de dados supermétricas disponíveis (POST /mcp/data_source_discovery)
  • Descobrir contas de uma fonte de dados (POST /mcp/accounts_discovery)
  • Descobrir campos disponíveis (POST /mcp/field_discovery)

Consulta de dados

  • Executar uma consulta de dados assíncrona (POST /mcp/data_query)
    • Retorna um schedule_id
  • Obter resultados da consulta assíncrona (POST /mcp/get_async_query_results)
    • Use o até que os schedule_id resultados sejam retornados

Utilitários/recursos (normalmente visibilidade avançada)

  • Obter hoje (UTC) (POST /mcp/get_today)
  • Verificação de integridade (GET /mcp/resources/health)

Support

Licença

Proprietário – © Supermétrica

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Consultar dados de marketing de fontes de dados supermétricas

Consultar dados de marketing de fontes de dados supermétricas Isso retorna um schedule_id – você deve chamar get_async_query_results para obter os dados reais.
Descobrir campos disponíveis para fontes de dados com informações de esquema

Descubra campos disponíveis para fontes de dados com informações de esquema Chame isso para ver as métricas e dimensões disponíveis para uma fonte de dados antes da consulta.
Descobrir contas disponíveis para uma fonte de dados específica

Descubra contas disponíveis para uma fonte de dados específica Chame isso depois que data_source_discovery para obter as IDs de conta necessárias para consultas de dados.
Descobrir fontes de dados supermétricas disponíveis

Descobrir fontes de dados supermétricas disponíveis Normalmente, essa é a primeira etapa – chame-a para ver quais fontes de dados estão disponíveis antes de consultar dados.
Obter informações atuais de data e hora utc

Obtenha informações atuais de data e hora utc Chame isso primeiro quando o usuário menciona datas relativas como 'último mês' ou 'ontem' para saber a data atual.
Recuperar informações de usuário autenticados do Supermetrics

Recuperar informações de usuário autenticados do Supermetrics
Recuperar resultados de consultas de dados usando schedule_id

Recupere os resultados de consultas de dados usando schedule_id Use-o com o schedule_id de data_query para recuperar os resultados reais da consulta.
Verificação de saúde

Obter informações de status de integridade e configuração do servidor.

Consultar dados de marketing de fontes de dados supermétricas

ID da operação:
dataquery

Consultar dados de marketing de fontes de dados supermétricas Isso retorna um schedule_id – você deve chamar get_async_query_results para obter os dados reais.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da fonte de dados
 ds_id True string

ID da fonte de dados que pode ser recuperada usando a ferramenta data_source_discovery. Exemplos: 'FA' para Anúncios do Facebook, '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 datas
 date_range_type string

Escolha uma das duas abordagens:

  1. Use 'custom' e forneça start_date e end_date.
  2. Use um intervalo relativo no formato 'last_X_Y' (por exemplo, 'last_7_days', 'last_3_months').
    • Você pode acrescentar '_inc' para incluir o período atual (por exemplo, 'last_7_days_inc').

IMPORTANTE: para qualquer data relativa mencionada pelo usuário, primeira chamada get_today ferramenta para saber o ano e a data atuais! Se houver alguma ambiguidade sobre o período de tempo (por exemplo, o significado de "hoje", "esta semana", "agosto passado" ou frases semelhantes), chame a get_today ferramenta para confirmar o ano e a data atuais e use essa resposta para preencher esse parâmetro.
Data de Início
 start_date string

Obrigatório se date_range_type='custom'. Aceita:

  • Data exata no formato YYYY-MM-DD (por exemplo, '2024-01-01')
  • Data do idioma natural (por exemplo, 'ontem', 'próxima segunda-feira')

IMPORTANTE: para qualquer data relativa mencionada pelo usuário, primeira chamada get_today ferramenta para saber o ano e a data atuais! Se houver ambiguidade sobre a referência de tempo (por exemplo, frases relativas como 'today', 'this week', 'end of month'), chame a get_today ferramenta para confirmar o ano e a data atuais e, em seguida, use essa resposta para preencher esse parâmetro.
Data de Término
 end_date string

Obrigatório se date_range_type='custom'. Aceita:

  • Data exata no formato YYYY-MM-DD (por exemplo, '2024-01-31')
  • Data do idioma natural (por exemplo, 'ontem', 'última sexta-feira')

IMPORTANTE: para qualquer data relativa mencionada pelo usuário, primeira chamada get_today ferramenta para saber o ano e a data atuais! Se houver ambiguidade sobre a referência de tempo (por exemplo, frases relativas como 'today', 'this week', 'end of month'), chame a get_today ferramenta para confirmar o ano e a data atuais e, em seguida, use essa resposta para preencher esse parâmetro.
Fuso horário
 timezone string

Opcionalmente, defina o fuso horário para cálculos de data (por exemplo, 'América/New_York', 'Europa/Londres', 'Ásia/Tóquio'). Usa nomes de fuso horário IANA. Se não for especificado, usará UTC.
Filtros
 filters string

Filtrar cadeia de caracteres de expressão. Cada condição tem o formulário: [field_name] [operador] [valor] As condições podem ser combinadas com AND/OR.

Operadores com suporte:

  • '==' → iguais
  • '!=' → não é igual a
  • '>' → maior que
  • '>=' → maior ou igual a
  • '<' → menor que
  • '<=' → menor ou igual a
  • '=@' → contém (não diferencia maiúsculas de minúsculas, apenas dimensões)
  • '!@' → não contém (não diferencia maiúsculas de minúsculas, apenas dimensões)
  • '=~' → corresponde à expressão regular (somente dimensões)
  • '!~' → não corresponde à expressão regular (somente dimensões)

Exemplos:

  • "country == Estados Unidos"
  • "country == Estados Unidos OU país == Canadá"
  • "sessions > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
Configurações
 settings object

Configuração de consulta adicional. Use um objeto JSON, por exemplo: {"show_all_time_values": true}. Recurso avançado para configurações de fonte de dados específicas. Ignore a menos que você tenha requisitos específicos.
Tipo de período de comparação
 compare_type string

Selecione como comparar os resultados com um período anterior:

  • 'prev_range': período anterior do mesmo comprimento
  • 'prev_year': mesmo período do ano anterior
  • 'prev_year_weekday': mesmos dias da semana do ano anterior
  • 'custom': período definido pelo usuário (requer compare_start_date e compare_end_date)
Tipo de valor de comparação
 compare_show string

Como exibir a comparação:

  • 'perc_change': alteração percentual (padrão)
  • 'abs_change': mudança absoluta
  • 'value': valor bruto do período de comparação
Data de início do período de comparação
 compare_start_date string

Necessário se compare_type='custom'. Data de início do período de comparação personalizado, no formato YYYY-MM-DD (por exemplo, '2024-01-01').
Data de término do período de comparação
 compare_end_date string

Necessário se compare_type='custom'. Data de término do período de comparação personalizado, no formato YYYY-MM-DD (por exemplo, '2024-01-31').

Retornos

Corpo
DataqueryResponse

Descobrir campos disponíveis para fontes de dados com informações de esquema

ID da operação:
fielddiscovery

Descubra campos disponíveis para fontes de dados com informações de esquema Chame isso para ver as métricas e dimensões disponíveis para uma fonte de dados antes da consulta.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da fonte de dados
 ds_id True string

ID da fonte de dados que pode ser recuperada usando a ferramenta data_source_discovery. Exemplos: 'FA' para Anúncios do Facebook, 'AW' para Google Ads, 'GAWA' para Google Analytics.
Tipo de campo
 field_type string

Filtrar por tipo de campo (dimensão ou métrica)
Compactar resposta
 compress boolean

Habilitar a compactação de toon para a resposta

Retornos

Corpo
FielddiscoveryResponse

Descobrir contas disponíveis para uma fonte de dados específica

ID da operação:
accountsdiscovery

Descubra contas disponíveis para uma fonte de dados específica Chame isso depois que data_source_discovery para obter as IDs de conta necessárias para consultas de dados.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID da fonte de dados
 ds_id True string

ID da fonte de dados que pode ser recuperada usando a ferramenta data_source_discovery. Exemplos: 'FA' para Anúncios do Facebook, 'AW' para Google Ads, 'GAWA' para Google Analytics.
Compactar resposta
 compress boolean

Habilitar a compactação de toon para a resposta

Retornos

Corpo
AccountsdiscoveryResponse

Descobrir fontes de dados supermétricas disponíveis

ID da operação:
datasourcediscovery

Descobrir fontes de dados supermétricas disponíveis Normalmente, essa é a primeira etapa – chame-a para ver quais fontes de dados estão disponíveis antes de consultar dados.

Parâmetros

Nome Chave Obrigatório Tipo Description
Compactar resposta
 compress boolean

Habilitar a compactação de toon para a resposta

Retornos

Corpo
DatasourcediscoveryResponse

Obter informações atuais de data e hora utc

ID da operação:
gettoday

Obtenha informações atuais de data e hora utc Chame isso primeiro quando o usuário menciona datas relativas como 'último mês' ou 'ontem' para saber a data atual.

Parâmetros

Nome Chave Obrigatório Tipo Description
object

Retornos

Corpo
GettodayResponse

Recuperar informações de usuário autenticados do Supermetrics

ID da operação:
userinfo

Recuperar informações de usuário autenticados do Supermetrics

Parâmetros

Nome Chave Obrigatório Tipo Description
object

Retornos

Corpo
UserinfoResponse

Recuperar resultados de consultas de dados usando schedule_id

ID da operação:
getasyncqueryresults

Recupere os resultados de consultas de dados usando schedule_id Use-o com o schedule_id de data_query para recuperar os resultados reais da consulta.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID de agendamento
 schedule_id True string

A ID de agenda retornada de uma solicitação data_query. A ID da agenda deve ser exatamente a mesma retornada na resposta data_query. Trate as IDs como opacas. Copiar verbatim. Não abreviar, formatar ou parafrasear.
Compactar resposta
 compress boolean

Habilitar a compactação de toon para a resposta

Retornos

Corpo
GetasyncqueryresultsResponse

Verificação de saúde

ID da operação:
healthCheck

Obter informações de status de integridade e configuração do servidor.

Retornos

response
string

Definições

AccountsdiscoveryResponse

Nome Caminho Tipo Description
sucesso
 success boolean
Contas
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Nome Caminho Tipo Description
sucesso
 success boolean
Schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Nome Caminho Tipo Description
sucesso
 success boolean
data_sources
 data.data_sources array of object
id
 data.data_sources.id string
nome
 data.data_sources.name string
categoria
 data.data_sources.category string

FielddiscoveryResponse

Nome Caminho Tipo Description
sucesso
 success boolean
fonte_de_dados
 data.data_source string
total
 data.total integer
métricas
 data.metrics array of object
id
 data.metrics.id string
nome
 data.metrics.name string
descrição
 data.metrics.description string
dimensions
 data.dimensions array of object
id
 data.dimensions.id string
nome
 data.dimensions.name string
descrição
 data.dimensions.description string

GetasyncqueryresultsResponse

Nome Caminho Tipo Description
sucesso
 success boolean
dados
 data.data array of object
items
 data.data object
status
 data.status string

GettodayResponse

Nome Caminho Tipo Description
sucesso
 success boolean
date
 data.date date
iso_string
 data.iso_string string
carimbo de data/hora
 data.timestamp integer

UserinfoResponse

Nome Caminho Tipo Description
sucesso
 success boolean
id_do_usuário
 data.user_id string
email
 data.email string
nome
 data.name string

cadeia

Esse é o tipo de dados básico 'string'.