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 en cuentas publicitarias ni tiendas
• Listo para agentes: Cinco herramientas de descubrimiento y 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.

Verificación

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 también significa que MCP está instalado: el espacio de trabajo simplemente aún no tiene una fuente conectada.

Potencia tu agente

Conecta Hologrow a cualquier agente de IA en minutos.

Skill

Dale a tu agente el flujo de trabajo de consultas 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 skills.

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 skill 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 con las herramientas. Nunca inventes nombres de plataforma, esquema, tabla o columna. Los nombres de campos de middleware suelen diferir 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

Descubre las plataformas de datos disponibles del usuario, el estado de conexión y los nombres de esquema. Úsala durante la incorporación y siempre que la plataforma o el esquema relevante sea desconocido. Devuelve la plataforma y schemas[].schema_name para herramientas posteriores y SQL.

list_platforms()

list_tables

Lista las tablas consultables de una plataforma exacta devuelta por list_platforms. Úsala para encontrar las tablas relevantes para la pregunta del usuario antes de inspeccionar campos o escribir SQL. Devuelve nombres de tabla exactos para get_data_dictionary, get_freshness y query_db; nunca inventes nombres de tabla.

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

Salida:

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

get_data_dictionary

Inspecciona columnas, tipos, claves y significados de campos de 1 a 10 nombres de tabla exactos devueltos por list_tables. Úsala antes de escribir SQL. Estos nombres pueden diferir de los campos de API o informes de la plataforma fuente; usa solo los nombres devueltos.

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

get_freshness

Comprueba la cobertura de sincronización y la actualización antes de sacar conclusiones sensibles al tiempo. schema_name debe provenir de list_platforms schemas[].schema_name; proporciona de 1 a 50 nombres de tabla exactos de list_tables. El scope opcional filtra por identidad de recurso, por ejemplo {"marketplace_id": "ATVPDKIKX0DER"}.

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

query_db

Responde una pregunta de datos concreta con una SELECT SQL de solo lectura después de descubrir el esquema, las tablas y las columnas relevantes. Califica completamente cada tabla como schema_name.table y usa solo identificadores devueltos por list_platforms, list_tables y 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 ni INTERSECT, sin esquema public ni catálogos del sistema
• Prefiere filtros, agregación y LIMIT sobre SELECT *
• El max_rows por defecto es 1000

Skills

Flujos de trabajo de solo lectura y asesoramiento sobre los datos de Hologrow conectados. Instala hologrow-data-middleware primero para que otras skills comprueben 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 skills 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 (de escritorio)
• Hermes

Fuentes de datos

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

Recursos

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

Seguridad

Hologrow MCP está limitado por espacio de trabajo y es de solo lectura. Usa solo las fuentes que el espacio de trabajo haya autorizado. Comprueba la actualización antes de tratar un número como vigente. 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 skills o respuestas del modelo.

Trata los cambios de campaña, listado y presupuesto como propuestas hasta que un humano los apruebe.

Solución de problemas

↑ Volver arriba ↑