Hologrow

Hologrow MCP

La capa de datos comerciales para IA. Conecta Amazon, Google Ads, GA4 y otros sistemas de venta una sola vez. Hologrow mantiene los datos sincronizados, y MCP permite que Claude, Cursor, Codex, ChatGPT y otros agentes los consulten, sin exportaciones CSV ni scripts API puntuales.

Alojado en mcp.hologrow.ai. Consola en connector.hologrow.ai. Documentación en docs.hologrow.ai.

¿Por qué Hologrow?

• Diseñado para las herramientas que ya usas: Conéctate una vez y haz preguntas en Claude, Cursor, Codex, ChatGPT, Doubao o Hermes
• Datos comerciales listos para LLM: Tablas estables para Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza y Lingxing ERP
• Nosotros nos encargamos de lo difícil: OAuth de plataformas, sincronización, actualización y esquema: los agentes solo leen
• Solo lectura por defecto: MCP nunca escribe de vuelta en cuentas publicitarias o tiendas
• Listo para agentes: Cinco herramientas de descubrimiento más habilidades de análisis que puedes instalar con un comando

Resumen de funciones

Herramientas MCP

Más

Inicio rápido

1. Crea un espacio de trabajo en connector.hologrow.ai.
2. Conecta al menos una fuente de datos y espera la primera sincronización.
3. Añade Hologrow MCP a tu agente. Los clientes OAuth se autorizan en la interfaz. Cursor / Claude Code / Hermes usan una clave API desde AI Platforms → Advanced settings.

Crear una clave API no es suficiente. La instalación se completa cuando el agente puede llamar a list_platforms.

MCP

Conecta cualquier cliente compatible con MCP. El transporte es Streamable HTTP.

{
  "mcpServers": {
    "Hologrow": {
      "url": "https://mcp.hologrow.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Install the Hologrow MCP server and test the connection.

Connection details:
- Name: Hologrow
- URL: https://mcp.hologrow.ai/mcp
- Transport: Streamable HTTP
- Authentication: API Key
- Header: Authorization: Bearer {apiKey}

Requirements:
1. Add Hologrow using this client's native MCP configuration. Use API Key authentication only; do not use OAuth.
2. Make only the changes required for installation. Keep the API key secret and do not repeat, log, or include it in your response.
3. After installation, call Hologrow's list_platforms tool once. Do not call any other tools.
4. If successful, list the connected data platforms exactly as returned. If installation, authentication, connection, or the tool call fails, stop and explain the error.

Verificar

Inicia una conversación nueva y envía:

Use Hologrow’s list_platforms tool to list my connected data platforms. Do not call any other tools.

Salida:

{
  "items": [
    {
      "platform": "amazon_sp_seller",
      "connected": true,
      "table_count": 30,
      "schemas": [
        {
          "schema_name": "amazon_sp_seller_xxxxxxxx",
          "display_name": "US Seller",
          "connection_status": "healthy"
        }
      ]
    },
    {
      "platform": "google_ads",
      "connected": false,
      "table_count": 15,
      "schemas": []
    }
  ]
}

Una lista vacía aún significa que MCP está instalado: el espacio de trabajo simplemente no tiene ninguna fuente conectada todavía.

Potencia tu agente

Conecta Hologrow a cualquier agente de IA en minutos.

Habilidad

Dale a tu agente el flujo de trabajo de consulta y los manuales de Amazon / Google Ads.

npx skills@latest add hologrow/hologrow-mcp --skill hologrow-data-middleware --global --yes

Reinicia el agente después de instalar. Funciona con Claude Code, Cursor, Codex y otros clientes compatibles con habilidades.

npx skills@latest add hologrow/hologrow-mcp --skill amazon-ppc-campaign --agent cursor --global --yes
npx skills@latest add hologrow/hologrow-mcp --skill google-ads-audit --agent claude-code --global --yes

Incorporación de agentes

¿Eres un agente de IA? Obtén esta habilidad y luego llama a list_platforms.

curl -s https://raw.githubusercontent.com/hologrow/hologrow-mcp/main/skills/hologrow-data-middleware/SKILL.md

Herramientas

Descubre siempre los nombres desde las herramientas. Nunca inventes nombres de plataformas, esquemas, tablas o columnas. Los nombres de campos de middleware a menudo difieren de las etiquetas de Amazon / Google.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Si una herramienta falla o se cancela, dilo. Nunca infieras cero, ausencia de datos o una métrica a partir de un resultado faltante.

list_platforms

Llama a esta primero. Devuelve nombres de plataformas, connected y schemas[].schema_name.

list_platforms()

list_tables

Lista tablas consultables para una plataforma desde list_platforms.

list_tables({ "platform": "amazon_sp_seller" })

Salida:

{
  "tables": ["order_items", "sales_and_traffic_daily", "fba_inventory_summaries"]
}

get_data_dictionary

Obtén columnas, tipos, claves y descripciones. Pasa de 1 a 10 nombres de tabla exactos desde list_tables.

get_data_dictionary({
  "platform": "amazon_sp_seller",
  "table_names": ["orders", "order_items"]
})

get_freshness

Verifica la cobertura de sincronización antes de tratar un número como actual. schema_name proviene de list_platforms. El scope opcional filtra por identidad de recurso.

get_freshness({
  "schema_name": "amazon_sp_seller_xxxxxxxx",
  "table_names": ["orders"],
  "scope": { "marketplace_id": "ATVPDKIKX0DER" }
})

query_db

Ejecuta una SELECT de solo lectura. Califica cada tabla como schema_name.table. Usa solo columnas de get_data_dictionary.

query_db({
  "query": "SELECT purchase_date::date AS day, order_status, COUNT(*) AS order_items, SUM(quantity) AS units FROM amazon_sp_seller_<schema>.order_items WHERE purchase_date >= CURRENT_DATE - INTERVAL '7 days' GROUP BY 1, 2 ORDER BY 1 DESC LIMIT 100",
  "max_rows": 100
})

Reemplaza <schema> con schema_name de list_platforms. item_price es el total de la línea de pedido; divide por NULLIF(quantity, 0) solo cuando necesites el precio por unidad. No uses _synced_at como fecha de venta.

Reglas

• Solo una declaración. Sin INSERT / UPDATE / DELETE / DDL, sin EXCEPT o INTERSECT, sin esquema public ni catálogos del sistema
• Prefiere filtros, agregación y LIMIT sobre SELECT *
• El max_rows predeterminado es 1000

Habilidades

Flujos de trabajo de solo lectura y asesoramiento sobre datos de Hologrow conectados. Instala hologrow-data-middleware primero para que otras habilidades verifiquen cobertura y actualización antes de interpretar el rendimiento.

npx skills@latest add hologrow/hologrow-mcp --skill SKILL_NAME

Ejemplo de mensaje después de instalar:

Use $hologrow-data-middleware, then $google-ads-audit.
Audit my connected Google Ads account for the last 30 days. Show evidence, caveats, and the next action.

Un catálogo más amplio (SEO, conectores de investigación y más) vive en hologrow/hologrow-ai-skills. Este repositorio mantiene las habilidades que dependen de Hologrow MCP.

Integraciones

Agentes y herramientas de IA

• ChatGPT web, ChatGPT de escritorio, Codex
• Claude web, Claude de escritorio, Claude Code
• Cursor
• Doubao (escritorio)
• Hermes

Fuentes de datos

Amazon SP Seller, Amazon SP Vendor, Amazon Ads, Google Ads, GA4, Google Search Console, Shoplazza, Lingxing ERP.

¿Te falta tu cliente o fuente favorita? Envía un correo a contact@hologrow.ai.

Recursos

• Documentación
• Producto
• Consola
• Endpoint MCP
• Catálogo de habilidades

Seguridad

Hologrow MCP está limitado por espacio de trabajo y es de solo lectura. Usa solo fuentes que el espacio de trabajo haya autorizado. Verifica la actualización antes de tratar un número como actual. Indica la definición de la métrica, la ventana de atribución y el período de comparación con cada conclusión importante. Nunca pongas claves API en git, archivos de habilidades o respuestas del modelo.

Trata los cambios de campañas, listados y presupuestos como propuestas hasta que un humano los apruebe.

Solución de problemas

↑ Volver arriba ↑