Partilhar via

SuperMCP (Pré-visualização)

SuperMCP da Supermetrics - Um servidor MCP (Model Context Protocol) que fornece acesso a dados de marketing de plataformas ligadas como Google Analytics, Facebook Ads, Google Ads, entre outras.

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

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

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - 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 Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Supermetria
URL https://supermetrics.com
Metadados do conector
Editora Supermetria
Sítio Web https://supermetrics.com
Política de privacidade https://supermetrics.com/privacy
Categorias Marketing

Conector Personalizado SuperMCP (Supermétricos)

Este conector permite que o Microsoft Power Automate, Power Apps e Azure Logic Apps consultem dados de marketing através do SuperMCP (servidor MCP da Supermetrics).
Utilize-o para descobrir fontes de dados e contas, explorar campos disponíveis e realizar consultas de desempenho de marketing.

Editora

Supermetrics

Tipo de conector

Conector Personalizado (Swagger/OpenAPI 2.0)

Serviço / API

API SuperMCP (servidor MCP)

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

Pré-requisitos

Irá necessitar de:

  • Um ambiente Power Automate ou Power Apps onde pode criar conectores personalizados
  • Uma conta Supermetrics com pelo menos uma fonte de dados ligada (por exemplo, Google Analytics, Google Ads, Facebook Ads, etc.). Se não tiver uma conta Supermetrics, será criada uma com um período experimental de 14 dias para si no primeiro login.

Authentication

Este conector utiliza OAuth 2.0.

Operações suportadas

Descoberta

  • Descubra as fontes de dados Supermetrics disponíveis (POST /mcp/data_source_discovery)
  • O Discover conta para uma fonte de dados (POST /mcp/accounts_discovery)
  • Descubra campos disponíveis (POST /mcp/field_discovery)

Consulta de Dados

  • Executar uma consulta de dados assíncrona (POST /mcp/data_query)
    • Devolve um schedule_id
  • Obter resultados de consultas assíncronas (POST /mcp/get_async_query_results)
    • Use o schedule_id até que os resultados sejam devolvidos

Utilidades / Recursos (tipicamente visibilidade avançada)

  • Obtenha hoje (UTC) (POST /mcp/get_today)
  • Exame de saúde (GET /mcp/resources/health)

Support

Licença

Proprietário — © Supermétricas

Limites de Limitação

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

Ações

Consultar dados de marketing a partir de fontes de dados Supermetrics

Consulta dados de marketing a partir de fontes de dados Supermetrics Isto retorna um schedule_id – deve depois ligar get_async_query_results para obter os dados reais.
Descubra as fontes de dados Supermetrics disponíveis

Descubra fontes de dados Supermetrics disponíveis. Este é normalmente o primeiro passo – ligue para ver que fontes de dados estão disponíveis antes de consultar os dados.
Descubra campos disponíveis para fontes de dados com informação de esquema

Descubra os campos disponíveis para fontes de dados com informação de esquema Ligue para ver métricas e dimensões disponíveis para uma fonte de dados antes de consultar.
Descubra contas disponíveis para uma fonte de dados específica

Descubra as contas disponíveis para uma fonte de dados específica. Ligue para esta data_source_discovery para obter os IDs de conta necessários para consultas de dados.
Obtenha informações atuais sobre data e hora UTC

Obtenha informações atuais sobre data e hora UTC Ligue primeiro quando o utilizador mencionar datas relativas como 'mês passado' ou 'ontem' para saber a data atual.
Recuperar informações autenticadas do utilizador a partir da Supermetrics

Recuperar informações autenticadas do utilizador a partir da Supermetrics
Recuperar resultados de consultas de dados usando schedule_id

Recuperar resultados de consultas de dados usando schedule_id Use isto com a schedule_id de data_query para obter resultados reais da consulta.
Verificação de saúde

Obtenha informações sobre o estado de saúde do servidor e a sua configuração.

Consultar dados de marketing a partir de fontes de dados Supermetrics

ID da Operação:
dataquery

Consulta dados de marketing a partir de fontes de dados Supermetrics Isto retorna um schedule_id – deve depois ligar get_async_query_results para obter os dados reais.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da Fonte de Dados
 ds_id True string

ID da fonte de dados que pode ser recuperado usando a ferramenta data_source_discovery. Exemplos: 'FA' para Facebook Ads, 'AW' para Google Ads, 'GAWA' para Google Analytics.
ds_accounts
 ds_accounts True array of string
campos
 fields True array of string
Tipo de Intervalo de Datas
 date_range_type string

Escolha uma de duas abordagens:

  1. Use 'personalizado' 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').
    • Pode acrescentar '_inc' para incluir o período atual (por exemplo, 'last_7_days_inc').

IMPORTANTE: Para qualquer data relativa mencionada pelo utilizador, PRIMEIRO ligue get_today ferramenta para saber o ano e a data em curso! Se houver alguma ambiguidade quanto ao período temporal (por exemplo, o significado de 'hoje', 'esta semana', 'agosto passado' ou expressões semelhantes), ligue para a get_today ferramenta para confirmar o ano e a data atual, e depois use essa resposta para preencher esse parâmetro.
Data de início
 start_date string

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

  • Data exata em formato YYYY-MM-DD (por exemplo, '2024-01-01')
  • Data em linguagem natural (ex.: 'ontem', 'próxima segunda-feira')

IMPORTANTE: Para qualquer data relativa mencionada pelo utilizador, PRIMEIRO ligue get_today ferramenta para saber o ano e a data em curso! Se houver ambiguidade sobre a referência temporal (por exemplo, expressões relativas como 'hoje', 'esta semana', 'final de mês'), ligue para a get_today ferramenta para confirmar o ano e a data atuais e use essa resposta para preencher esse parâmetro.
Data de fim
 end_date string

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

  • Data exata no formato YYYY-MM-DD (por exemplo, '2024-01-31')
  • Data em linguagem natural (por exemplo, 'ontem', 'sexta-feira passada')

IMPORTANTE: Para qualquer data relativa mencionada pelo utilizador, PRIMEIRO ligue get_today ferramenta para saber o ano e a data em curso! Se houver ambiguidade sobre a referência temporal (por exemplo, expressões relativas como 'hoje', 'esta semana', 'final de mês'), ligue para a get_today ferramenta para confirmar o ano e a data atuais e 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 os nomes dos fusos horários da IANA. Se não especificado, usa UTC.
Filtros
 filters string

Cadeia de expressão de filtro. Cada condição tem a forma: [field_name] [operador] [valor] As condições podem ser combinadas com AND / OR.

Operadores suportados:

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

Examples:

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

Configuração adicional de consultas. Use um objeto JSON, por exemplo: {"show_all_time_values": true}. Funcionalidade avançada para definições específicas de fontes de dados. Dispensa a menos que tenhas 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 da mesma duração
  • 'prev_year': mesmo período do ano anterior
  • 'prev_year_weekday': mesmos dias úteis do ano anterior
  • 'personalizado': período definido pelo utilizador (requer compare_start_date e compare_end_date)
Tipo de Valor de Comparação
 compare_show string

Como mostrar a comparação:

  • 'perc_change': variação percentual (defeito)
  • 'abs_change': mudança absoluta
  • 'valor': valor bruto do período de comparação
Data de Início do Período de Comparação
 compare_start_date string

Obrigatório se compare_type='personalizado'. Data de início do período de comparação personalizada, no formato YYYY-MM-DD (por exemplo, '2024-01-01').
Data de Término do Período de Comparação
 compare_end_date string

Obrigatório se compare_type='personalizado'. Data final do período de comparação personalizada, no formato YYYY-MM-DD (por exemplo, '2024-01-31').

Regressos

Body
DataqueryResponse

Descubra as fontes de dados Supermetrics disponíveis

ID da Operação:
datasourcediscovery

Descubra fontes de dados Supermetrics disponíveis. Este é normalmente o primeiro passo – ligue para ver que fontes de dados estão disponíveis antes de consultar os dados.

Parâmetros

Nome Chave Necessário Tipo Descrição
Resposta de compressão
 compress boolean

Ativar a compressão de toon para a resposta

Regressos

Body
DatasourcediscoveryResponse

Descubra campos disponíveis para fontes de dados com informação de esquema

ID da Operação:
fielddiscovery

Descubra os campos disponíveis para fontes de dados com informação de esquema Ligue para ver métricas e dimensões disponíveis para uma fonte de dados antes de consultar.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da Fonte de Dados
 ds_id True string

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

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

Ativar a compressão de toon para a resposta

Regressos

Body
FielddiscoveryResponse

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

ID da Operação:
accountsdiscovery

Descubra as contas disponíveis para uma fonte de dados específica. Ligue para esta data_source_discovery para obter os IDs de conta necessários para consultas de dados.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da Fonte de Dados
 ds_id True string

ID da fonte de dados que pode ser recuperado usando a ferramenta data_source_discovery. Exemplos: 'FA' para Facebook Ads, 'AW' para Google Ads, 'GAWA' para Google Analytics.
Resposta de compressão
 compress boolean

Ativar a compressão de toon para a resposta

Regressos

Body
AccountsdiscoveryResponse

Obtenha informações atuais sobre data e hora UTC

ID da Operação:
gettoday

Obtenha informações atuais sobre data e hora UTC Ligue primeiro quando o utilizador mencionar datas relativas como 'mês passado' ou 'ontem' para saber a data atual.

Parâmetros

Nome Chave Necessário Tipo Descrição
object

Regressos

Body
GettodayResponse

Recuperar informações autenticadas do utilizador a partir da Supermetrics

ID da Operação:
userinfo

Recuperar informações autenticadas do utilizador a partir da Supermetrics

Parâmetros

Nome Chave Necessário Tipo Descrição
object

Regressos

Body
UserinfoResponse

Recuperar resultados de consultas de dados usando schedule_id

ID da Operação:
getasyncqueryresults

Recuperar resultados de consultas de dados usando schedule_id Use isto com a schedule_id de data_query para obter resultados reais da consulta.

Parâmetros

Nome Chave Necessário Tipo Descrição
ID da agenda
 schedule_id True string

O ID de horário foi devolvido de um pedido de data_query. O ID do Schedule deve ser exatamente o mesmo que devolvido na resposta data_query. Trate as identificações como opacas. Copiar palavra por palavra. Não abrevie, formate ou paráfrasee.
Resposta de compressão
 compress boolean

Ativar a compressão de toon para a resposta

Regressos

Body
GetasyncqueryresultsResponse

Verificação de saúde

ID da Operação:
healthCheck

Obtenha informações sobre o estado de saúde do servidor e a sua configuração.

Regressos

response
string

Definições

ContasdescobertaResposta

Nome Percurso Tipo Descrição
sucesso
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Nome Percurso Tipo Descrição
sucesso
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Nome Percurso Tipo Descrição
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 Percurso Tipo Descrição
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 Percurso Tipo Descrição
sucesso
 success boolean
dados
 data.data array of object
items
 data.data object
estado
 data.status string

GettodayResponse

Nome Percurso Tipo Descrição
sucesso
 success boolean
date
 data.date date
iso_string
 data.iso_string string
carimbo de data/hora
 data.timestamp integer

UserinfoResponse

Nome Percurso Tipo Descrição
sucesso
 success boolean
ID de utilizador
 data.user_id string
e-mail
 data.email string
nome
 data.name string

cadeia (de caracteres)

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