Maqui Analytics

MCP de análise de marketing tudo-em-um — Instagram, anúncios, tráfego web, SEO e avaliações para negócios locais e as agências que os gerenciam.

GitHub

Documentação

Servidor MCP Maqui Analytics

MCP de análise de marketing tudo-em-um para negócios locais e agências: Instagram, anúncios, tráfego web, SEO e avaliações.

URL do servidor: https://app.somosmaqui.com/api/mcp

O que você pode perguntar

Conecte o Maqui ao seu assistente de IA e consulte todos os seus canais de marketing em linguagem natural — sem painéis, sem alternar entre abas.

Canal	O que você pode perguntar
Instagram	Alcance, taxa de engajamento, principais posts, crescimento de seguidores, desempenho de hashtags
Google Ads	Gastos, CTR, CPC, conversões, CPA, ROAS por campanha e palavra-chave
Meta Ads	Gastos com anúncios no Facebook e Instagram, alcance, leads, mensagens, compras
Google Analytics 4	Sessões, usuários, taxa de rejeição, principais páginas, fontes de tráfego
Search Console	Cliques orgânicos, impressões, rankings, principais consultas e páginas
Microsoft Clarity	Sessões, engajamento, sinais de comportamento, principais páginas e fontes de tráfego
Avaliações	Notas do Google Business e Facebook, taxa de resposta, avaliações recentes
CRM / Leads	Leads no funil por status e origem
Vendas no PDV	Vendas do restaurante Fudo por canal (no salão, delivery, balcão)

Exemplos de perguntas

"Como foi o desempenho do nosso Instagram no mês passado em comparação com o mês anterior?"
"Qual campanha do Google Ads tem o melhor ROAS neste trimestre?"
"Quais são as 5 principais consultas de pesquisa orgânica desta semana?"
"Mostre todas as avaliações de 1 estrela dos últimos 30 dias"
"Quantos leads recebemos do Meta Ads em comparação com os orgânicos em janeiro?"

Clientes compatíveis

Conecte um cliente MCP que suporte Streamable HTTP e autorização OAuth com PKCE. O Maqui aceita registros de clientes aprovados ou Documentos de Metadados de ID de Cliente de origens aprovadas. Clientes não reconhecidos e URLs de callback são rejeitados; entre em contato com o Maqui para solicitar suporte a outro cliente.

Clientes que aceitam um cabeçalho Authorization personalizado também podem usar um token de API por conta. Uma ponte stdio local, como mcp-remote, oferece suporte a essa alternativa.

Autenticação

O OAuth está disponível no endpoint público com descoberta de recursos, PKCE S256 e consentimento explícito. Faça login com sua conta Maqui e aprove o acesso de leitura. Os tokens de acesso OAuth expiram após uma hora. Quando o cliente solicitar offline_access, os tokens de atualização são rotacionados e expiram em até 30 dias; a reutilização revoga a família de tokens. Conexões OAuth mais antigas precisam ser reconectadas.

Metadados de recurso protegido: https://app.somosmaqui.com/.well-known/oauth-protected-resource/api/mcp. Metadados do servidor de autorização: https://app.somosmaqui.com/.well-known/oauth-authorization-server.

Os tokens de API bearer existentes continuam disponíveis no painel administrativo do Maqui. Cada token de API é limitado a uma conta, expira após um ano e pode ser revogado de forma independente. O endpoint exige um token válido tanto para a descoberta de ferramentas quanto para consultas de dados. O acesso a dados reais de negócios é provisionado pelo Maqui.

Demonstração sintética

Escolha Probar solo con datos sintéticos na página de consentimento OAuth para testar todas as 22 ferramentas sem fazer login. As respostas da demonstração são explicitamente marcadas e usam exemplos fictícios para setembro de 2026. Elas nunca consultam métricas de clientes, e alterar account_id não pode alternar um token de demonstração para dados reais. O intervalo de datas solicitado é exibido separadamente do período de amostra fixo; a demonstração não aplica todos os filtros.

As verificações de integridade do diretório podem usar um token bearer de demonstração separado e revogável, emitido por um administrador autenticado do Maqui, válido por 30 dias. No painel, escolha Admin → Tokens MCP → Generar token demo para Glama, verifique as respostas da demonstração e configure o perfil de teste do diretório. Nunca publique essa credencial em um README ou repositório. Use uma credencial separada para cada diretório.

O conector Glama foi verificado como Healthy em 9 de outubro de 2026, com 22 ferramentas indexadas e uma demonstração sintética em Admin → Test Profile → API Key → Bearer Authentication. Este perfil de teste usa um token bearer de demonstração; ele não estabelece compatibilidade OAuth com o Glama. Renove a demonstração antes da expiração de 30 dias para manter as verificações ativas.

Streamable HTTP direto

Para clientes que aceitam URLs MCP remotas e cabeçalhos personalizados:

{
  "mcpServers": {
    "maqui": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Ponte stdio local

Para clientes que iniciam um processo MCP local (requer Node.js):

{
  "mcpServers": {
    "maqui": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.somosmaqui.com/api/mcp",
        "--header",
        "Authorization:Bearer ${MAQUI_TOKEN}"
      ],
      "env": {
        "MAQUI_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Mantenha tokens reais fora de repositórios públicos e exemplos de configuração compartilhados.

Para agências

O Maqui foi desenvolvido para agências de marketing que gerenciam vários clientes. Cada conta de cliente tem um conjunto de dados isolado e seu próprio token de API — não há acesso a dados entre contas.

Se você gerencia vários clientes, cada um recebe seu próprio token com escopo para seus dados. Quando um relacionamento com o cliente termina, revogue o token desse cliente no painel administrativo e o acesso dele é interrompido imediatamente — os tokens dos outros clientes continuam funcionando. Você pode configurar várias instâncias no seu cliente de IA:

{
  "mcpServers": {
    "maqui-cliente-a": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": { "Authorization": "Bearer TOKEN_CLIENTE_A" }
    },
    "maqui-cliente-b": {
      "url": "https://app.somosmaqui.com/api/mcp",
      "headers": { "Authorization": "Bearer TOKEN_CLIENTE_B" }
    }
  }
}

Sobre o Maqui

Maqui é uma plataforma de análise de marketing para restaurantes, varejo e empresas de serviços. Ela sincroniza dados diariamente do Instagram, Google Ads, Meta Ads, Google Analytics, Search Console, avaliações do Google Business e sistemas de PDV — e os torna consultáveis por meio de uma interface conversacional.

→ somosmaqui.com