Maqui Analytics

MCP de análisis de marketing todo en uno: Instagram, anuncios, tráfico web, SEO y reseñas para negocios locales y las agencias que los gestionan.

GitHub

Documentación

Servidor MCP de Maqui Analytics

MCP de analítica de marketing todo-en-uno para negocios locales y agencias: Instagram, anuncios, tráfico web, SEO y reseñas.

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

Lo que puedes preguntar

Conecta Maqui a tu asistente de IA y consulta todos tus canales de marketing en lenguaje natural — sin paneles, sin cambiar de pestaña.

Canal	Lo que puedes preguntar
Instagram	Alcance, tasa de interacción, publicaciones principales, crecimiento de seguidores, rendimiento de hashtags
Google Ads	Gasto, CTR, CPC, conversiones, CPA, ROAS por campaña y palabra clave
Meta Ads	Gasto en anuncios de Facebook e Instagram, alcance, clientes potenciales, mensajes, compras
Google Analytics 4	Sesiones, usuarios, tasa de rebote, páginas principales, fuentes de tráfico
Search Console	Clics orgánicos, impresiones, posiciones, consultas y páginas principales
Microsoft Clarity	Sesiones, interacción, señales de comportamiento, páginas principales y fuentes de tráfico
Reseñas	Calificaciones de Google Business y Facebook, tasa de respuesta, reseñas recientes
CRM / Clientes potenciales	Clientes potenciales del embudo por estado y fuente
Ventas POS	Ventas de restaurante Fudo por canal (en el local, entrega, mostrador)

Ejemplos de consultas

"¿Cómo rindió nuestro Instagram el mes pasado comparado con el mes anterior?"
"¿Qué campaña de Google Ads tiene el mejor ROAS este trimestre?"
"¿Cuáles son nuestras 5 principales consultas de búsqueda orgánica esta semana?"
"Muéstrame todas las reseñas de 1 estrella de los últimos 30 días"
"¿Cuántos clientes potenciales obtuvimos de Meta Ads frente a orgánico en enero?"

Clientes compatibles

Conecta un cliente MCP que admita Streamable HTTP y autorización OAuth con PKCE. Maqui acepta registros de clientes aprobados o Documentos de Metadatos de ID de Cliente de orígenes aprobados. Los clientes no reconocidos y las URL de devolución de llamada son rechazados; contacta a Maqui para solicitar soporte para otro cliente.

Los clientes que aceptan un encabezado Authorization personalizado también pueden usar un token de API por cuenta. Un puente stdio local como mcp-remote admite esta alternativa.

Autenticación

OAuth está disponible en el endpoint público con descubrimiento de recursos, PKCE S256 y consentimiento explícito. Inicia sesión con tu cuenta de Maqui y luego aprueba el acceso de lectura. Los tokens de acceso OAuth expiran después de una hora. Cuando el cliente solicita offline_access, los tokens de actualización rotan y expiran dentro de 30 días; la reutilización revoca la familia de tokens. Las conexiones OAuth más antiguas deben reconectarse.

Metadatos del recurso protegido: https://app.somosmaqui.com/.well-known/oauth-protected-resource/api/mcp. Metadatos del servidor de autorización: https://app.somosmaqui.com/.well-known/oauth-authorization-server.

Los tokens de API bearer existentes siguen disponibles desde el panel de administración de Maqui. Cada token de API está limitado a una cuenta, expira después de un año y puede revocarse de forma independiente. El endpoint requiere un token válido tanto para el descubrimiento de herramientas como para las consultas de datos. El acceso a datos comerciales reales es aprovisionado por Maqui.

Demo sintética

Elige Probar solo con datos sintéticos en la página de consentimiento OAuth para probar las 22 herramientas sin iniciar sesión. Las respuestas de demostración están marcadas explícitamente y usan ejemplos ficticios para septiembre de 2026. Nunca consultan métricas de clientes, y cambiar account_id no puede cambiar un token de demostración a datos reales. El rango de fechas solicitado se muestra por separado del período de muestra fijo; la demostración no aplica todos los filtros.

Las verificaciones de salud del directorio pueden usar un token bearer de demostración separado y revocable emitido por un administrador autenticado de Maqui, válido por 30 días. En el panel, elige Admin → Tokens MCP → Generar token demo para Glama, verifica las respuestas de demostración y luego configura el perfil de prueba del directorio. Nunca publiques esa credencial en un README o repositorio. Usa una credencial separada para cada directorio.

El conector Glama fue verificado Saludable el 9 de octubre de 2026, con 22 herramientas indexadas y una demo sintética en Admin → Test Profile → API Key → Bearer Authentication. Este perfil de prueba usa un token bearer de demostración; no establece compatibilidad OAuth con Glama. Renueva la demo antes de su vencimiento de 30 días para mantener las verificaciones activas.

Streamable HTTP directo

Para clientes que aceptan URL MCP remotas y encabezados personalizados:

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

Puente stdio local

Para clientes que lanzan un proceso MCP local (requiere 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"
      }
    }
  }
}

Mantén los tokens reales fuera de repositorios públicos y ejemplos de configuración compartidos.

Para agencias

Maqui está diseñado para agencias de marketing que gestionan múltiples clientes. Cada cuenta de cliente tiene un conjunto de datos aislado y su propio token de API — no hay acceso a datos entre cuentas.

Si gestionas varios clientes, cada uno recibe su propio token limitado a sus datos. Cuando una relación con un cliente termina, revoca el token de ese cliente desde el panel de administración y su acceso se detiene de inmediato — los tokens de los otros clientes siguen funcionando. Puedes configurar múltiples instancias en tu 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" }
    }
  }
}

Acerca de Maqui

Maqui es una plataforma de analítica de marketing para restaurantes, comercios minoristas y negocios de servicios. Sincroniza datos diariamente desde Instagram, Google Ads, Meta Ads, Google Analytics, Search Console, reseñas de Google Business y sistemas POS — y los hace consultables a través de una interfaz conversacional.

→ somosmaqui.com