Hologrow

Hologrow MCP

La couche de données commerciales pour l'IA. Connectez Amazon, Google Ads, GA4 et d'autres systèmes de vente une seule fois. Hologrow maintient les données synchronisées, puis MCP permet à Claude, Cursor, Codex, ChatGPT et d'autres agents de les interroger — sans exports CSV ni scripts API ponctuels.

Hébergé sur mcp.hologrow.ai. Console sur connector.hologrow.ai. Documentation sur docs.hologrow.ai.

Pourquoi Hologrow ?

• Conçu pour les outils que vous utilisez déjà : Connectez-vous une fois, puis posez des questions dans Claude, Cursor, Codex, ChatGPT, Doubao ou Hermes
• Données commerciales prêtes pour les LLM : Tables stables pour Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza et Lingxing ERP
• Nous gérons les aspects complexes : OAuth des plateformes, synchronisation, fraîcheur et schéma — les agents ne font que lire
• Lecture seule par défaut : MCP n'écrit jamais dans les comptes publicitaires ou les boutiques en ligne
• Prêt pour les agents : Cinq outils de découverte plus des compétences d'analyse installables en une seule commande

Aperçu des fonctionnalités

Outils MCP

Plus

Démarrage rapide

1. Créez un espace de travail sur connector.hologrow.ai.
2. Connectez au moins une source de données et attendez la première synchronisation.
3. Ajoutez Hologrow MCP à votre agent. Les clients OAuth s'autorisent dans l'interface. Cursor / Claude Code / Hermes utilisent une clé API depuis AI Platforms → Advanced settings.

Créer une clé API ne suffit pas. L'installation réussit lorsque l'agent peut appeler list_platforms.

MCP

Connectez n'importe quel client compatible MCP. Le transport est 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.

Vérification

Démarrez une conversation nouvelle et envoyez :

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

Sortie :

{
  "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": []
    }
  ]
}

Une liste vide signifie toujours que MCP est installé — l'espace de travail n'a simplement pas encore de source connectée.

Renforcez votre agent

Connectez Hologrow à n'importe quel agent IA en quelques minutes.

Compétence

Donnez à votre agent le workflow de requête et les playbooks Amazon / Google Ads.

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

Redémarrez l'agent après l'installation. Fonctionne avec Claude Code, Cursor, Codex et d'autres clients compatibles avec les compétences.

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

Intégration de l'agent

Êtes-vous un agent IA ? Récupérez cette compétence, puis appelez list_platforms.

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

Outils

Découvrez toujours les noms à partir des outils. N'inventez jamais de noms de plateforme, de schéma, de table ou de colonne. Les noms de champs middleware diffèrent souvent des libellés Amazon / Google.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Si un outil échoue ou est annulé, dites-le. Ne déduisez jamais zéro, absence de données ou une métrique d'un résultat manquant.

list_platforms

Appelez ceci en premier. Renvoie les noms de plateformes, connected et schemas[].schema_name.

list_platforms()

list_tables

Listez les tables interrogeables pour une plateforme depuis list_platforms.

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

Sortie :

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

get_data_dictionary

Obtenez les colonnes, types, clés et descriptions. Passez 1 à 10 noms de tables exacts depuis list_tables.

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

get_freshness

Vérifiez la couverture de synchronisation avant de considérer un nombre comme actuel. schema_name provient de list_platforms. scope optionnel filtre par identité de ressource.

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

query_db

Exécutez un SELECT en lecture seule. Qualifiez chaque table comme schema_name.table. Utilisez uniquement les colonnes 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
})

Remplacez <schema> par schema_name depuis list_platforms. item_price est le total de la ligne de commande ; divisez par NULLIF(quantity, 0) uniquement lorsque vous avez besoin du prix unitaire. N'utilisez pas _synced_at comme date de vente.

Règles

• Une seule instruction. Pas de INSERT / UPDATE / DELETE / DDL, pas de EXCEPT ni INTERSECT, pas de schéma public ni de catalogues système
• Privilégiez les filtres, l'agrégation et LIMIT plutôt que SELECT *
• La valeur par défaut de max_rows est 1000

Compétences

Workflows consultatifs en lecture seule sur les données Hologrow connectées. Installez hologrow-data-middleware d'abord pour que les autres compétences vérifient la couverture et la fraîcheur avant d'interpréter les performances.

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

Exemple d'invite après installation :

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 catalogue plus large (SEO, connecteurs de recherche, etc.) se trouve dans hologrow/hologrow-ai-skills. Ce dépôt conserve les compétences qui dépendent de Hologrow MCP.

Intégrations

Agents et outils IA

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

Sources de données

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

Un client ou une source manquante ? Écrivez à contact@hologrow.ai.

Ressources

• Documentation
• Produit
• Console
• Point de terminaison MCP
• Catalogue de compétences

Sécurité

Hologrow MCP est limité au locataire et en lecture seule. Utilisez uniquement les sources autorisées par l'espace de travail. Vérifiez la fraîcheur avant de considérer un nombre comme actuel. Indiquez la définition de la métrique, la fenêtre d'attribution et la période de comparaison avec chaque conclusion importante. Ne mettez jamais de clés API dans git, les fichiers de compétences ou les réponses du modèle.

Traitez les modifications de campagne, de fiche produit et de budget comme des propositions jusqu'à ce qu'un humain les approuve.

Dépannage

↑ Retour en haut ↑