Hologrow

Hologrow MCP

Уровень данных для ИИ в коммерции. Подключите Amazon, Google Ads, GA4 и другие системы продаж один раз. Hologrow синхронизирует данные, а MCP позволяет Claude, Cursor, Codex, ChatGPT и другим агентам запрашивать их — без экспорта в CSV или разовых API-скриптов.

Размещено на mcp.hologrow.ai. Консоль на connector.hologrow.ai. Документация на docs.hologrow.ai.

Зачем Hologrow?

• Создан для инструментов, которые вы уже используете: Подключитесь один раз, затем задавайте вопросы в Claude, Cursor, Codex, ChatGPT, Doubao или Hermes
• Данные для LLM: Стабильные таблицы для Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza и Lingxing ERP
• Мы берём на себя сложное: OAuth платформ, синхронизация, актуальность и схема — агенты только читают
• Только чтение по умолчанию: MCP никогда не записывает обратно в рекламные аккаунты или магазины
• Готов для агентов: Пять инструментов обнаружения плюс навыки анализа, которые можно установить одной командой

Обзор функций

Инструменты MCP

Дополнительно

Быстрый старт

1. Создайте рабочее пространство на connector.hologrow.ai.
2. Подключите хотя бы один источник данных и дождитесь первой синхронизации.
3. Добавьте Hologrow MCP в вашего агента. OAuth-клиенты авторизуются в интерфейсе. Cursor / Claude Code / Hermes используют API-ключ из AI Platforms → Advanced settings.

Создания API-ключа недостаточно. Установка завершается успешно, когда агент может вызвать list_platforms.

MCP

Подключите любой MCP-совместимый клиент. Транспорт — 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.

Проверка

Начните новый разговор и отправьте:

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

Вывод:

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

Пустой список всё равно означает, что MCP установлен — просто в рабочем пространстве ещё нет подключённого источника.

Расширьте возможности вашего агента

Подключите Hologrow к любому ИИ-агенту за считанные минуты.

Навык

Дайте вашему агенту рабочий процесс запросов и плейбуки Amazon / Google Ads.

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

Перезапустите агента после установки. Работает с Claude Code, Cursor, Codex и другими клиентами, поддерживающими навыки.

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

Онбординг агента

Вы ИИ-агент? Загрузите этот навык, затем вызовите list_platforms.

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

Инструменты

Всегда получайте имена из инструментов. Никогда не выдумывайте имена платформ, схем, таблиц или колонок. Имена полей в middleware часто отличаются от меток в интерфейсе Amazon / Google.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Если инструмент не сработал или был отменён, сообщите об этом. Никогда не делайте вывод о нуле, отсутствии данных или метрике из отсутствующего результата.

list_platforms

Обнаружение доступных платформ данных пользователя, состояния подключения и имён схем. Используйте во время онбординга и когда нужная платформа или схема неизвестна. Возвращает платформу и schemas[].schema_name для последующих инструментов и SQL.

list_platforms()

list_tables

Список запрашиваемых таблиц для точной платформы, возвращённой list_platforms. Используйте, чтобы найти таблицы, релевантные вопросу пользователя, перед просмотром полей или написанием SQL. Возвращает точные имена таблиц для get_data_dictionary, get_freshness и query_db; никогда не выдумывайте имена таблиц.

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

Вывод:

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

get_data_dictionary

Просмотр колонок, типов, ключей и значений полей для 1–10 точных имён таблиц, возвращённых list_tables. Используйте перед написанием SQL. Эти имена могут отличаться от полей API или отчётов исходной платформы; используйте только возвращённые имена.

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

get_freshness

Проверка покрытия синхронизации и актуальности перед выводами, зависящими от времени. schema_name должен быть из list_platforms schemas[].schema_name; укажите 1–50 точных имён таблиц из list_tables. Необязательный scope фильтрует по идентификатору ресурса, например {"marketplace_id": "ATVPDKIKX0DER"}.

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

query_db

Ответ на конкретный вопрос о данных с помощью одного read-only SQL SELECT после обнаружения нужной схемы, таблиц и колонок. Полностью квалифицируйте каждую таблицу как schema_name.table и используйте только идентификаторы, возвращённые list_platforms, list_tables и 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
})

Замените <schema> на schema_name из list_platforms. item_price — это итог по строке заказа; делите на NULLIF(quantity, 0) только когда нужна цена за единицу. Не используйте _synced_at как дату продажи.

Правила

• Только один оператор. Без INSERT / UPDATE / DELETE / DDL, без EXCEPT или INTERSECT, без схемы public или системных каталогов
• Предпочитайте фильтры, агрегацию и LIMIT вместо SELECT *
• По умолчанию max_rows равен 1000

Навыки

Консультационные рабочие процессы только для чтения поверх подключённых данных Hologrow. Установите hologrow-data-middleware первым, чтобы другие навыки проверяли покрытие и актуальность перед интерпретацией производительности.

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

Пример промпта после установки:

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.

Более крупный каталог (SEO, коннекторы для исследований и другое) находится в hologrow/hologrow-ai-skills. В этом репозитории хранятся навыки, зависящие от Hologrow MCP.

Интеграции

Агенты и ИИ-инструменты

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

Источники данных

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

Ресурсы

• Документация
• Продукт
• Консоль
• MCP endpoint
• Каталог навыков

Безопасность

Hologrow MCP ограничен тенантом и работает только на чтение. Используйте только источники, авторизованные в рабочем пространстве. Проверяйте актуальность, прежде чем считать число текущим. Указывайте определение метрики, окно атрибуции и период сравнения с каждым важным выводом. Никогда не помещайте API-ключи в git, файлы навыков или ответы модели.

Относитесь к изменениям кампаний, листингов и бюджетов как к предложениям, пока человек не одобрит их.

Устранение неполадок

↑ К началу ↑