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.
Documentação
Servidor MCP Maqui Analytics
MCP de marketing analytics tudo-em-um — Instagram, anúncios, tráfego web, SEO e avaliações para negócios locais e as agências que os gerenciam.
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 dashboards, sem alternar entre abas.
| Canal | O que você pode perguntar |
|---|---|
| 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 |
| Avaliações | Notas do Google Business e Facebook, taxa de resposta, avaliações recentes |
| CRM / Leads | Leads no funil por status e origem |
| Vendas POS | Vendas do restaurante Fudo por canal (no local, delivery, balcão) |
Exemplos de prompts
- "Como foi o desempenho do nosso Instagram no mês passado comparado ao mês anterior?"
- "Qual campanha do Google Ads tem o melhor ROAS neste trimestre?"
- "Quais são as 5 principais consultas de busca orgânica desta semana?"
- "Mostre todas as avaliações de 1 estrela dos últimos 30 dias"
- "Quantos leads recebemos do Meta Ads versus orgânicos em janeiro?"
Clientes compatíveis
Funciona com qualquer cliente de IA compatível com MCP:
- Claude Desktop e Claude.ai
- ChatGPT (com suporte a MCP habilitado)
- Cursor
- Windsurf
- Cline
- Continue
- Qualquer cliente que suporte o Model Context Protocol
Autenticação
O Maqui usa autenticação por conta. Cada conta de cliente tem seu próprio token — os dados são sempre limitados a essa conta.
Opção A: OAuth 2.0 (recomendado para Claude.ai, ChatGPT e clientes modernos)
Clientes que suportam OAuth 2.0 podem conectar automaticamente. O Maqui implementa o fluxo PKCE completo:
| Endpoint | URL |
|---|---|
| Descoberta | https://app.somosmaqui.com/.well-known/oauth-authorization-server |
| Autorização | https://app.somosmaqui.com/oauth/authorize |
| Token | https://app.somosmaqui.com/oauth/token |
Basta adicionar a URL do servidor ao seu cliente — ele cuidará do login automaticamente.
Opção B: Token Bearer (para Claude Desktop e configuração manual)
Obtenha seu token de API no painel do Maqui e configure seu cliente manualmente.
Claude Desktop — adicione em ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"maqui": {
"url": "https://app.somosmaqui.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Outros clientes — use a URL do servidor com um cabeçalho Authorization: Bearer YOUR_API_TOKEN.
Os tokens de API são gerados por conta no painel administrativo do Maqui e são válidos por um ano. Eles podem ser revogados a qualquer momento pelo painel — o acesso é cortado imediatamente, sem afetar o token de nenhuma outra conta.
Para agências
O Maqui foi criado 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 limitado aos seus dados. Quando o relacionamento com um 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 marketing analytics para restaurantes, varejo e negócios de serviços. Ela sincroniza dados diariamente do Instagram, Google Ads, Meta Ads, Google Analytics, Search Console, avaliações do Google Business e sistemas POS — e os torna consultáveis por meio de uma interface conversacional.