Hologrow
официальныйУровень данных электронной коммерции для любого ИИ
Что можно делать с Hologrow MCP?
- Discover connected platforms — Попросите вашего ассистента вызвать
list_platforms, чтобы увидеть, какие источники данных подключены и как называются их схемы. - Explore queryable tables — Используйте
list_tables, чтобы просмотреть доступные таблицы для такой платформы, как Amazon SP Seller или Google Ads. - Inspect table schemas — Вызовите
get_data_dictionaryс точными именами таблиц, чтобы получить столбцы, типы, ключи и описания полей перед написанием SQL. - Check data freshness — Используйте
get_freshness, чтобы проверить покрытие синхронизации и время последнего успешного обновления, прежде чем доверять любым числам. - Run read-only SQL queries — Запросите оператор
query_dbSELECT дляschema_name.table, чтобы анализировать данные коммерции без записи обратно. - Install analysis skills — Добавляйте рабочие процессы, такие как
amazon-ppc-campaignилиgoogle-ads-audit, черезnpx skills@latestдля управляемого анализа только для чтения.
Документация
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
| Функция | Описание |
|---|---|
| list_platforms | Посмотрите, какие источники подключены и какие схемы доступны для запросов |
| list_tables | Список таблиц, доступных для запросов, для одной платформы |
| get_data_dictionary | Колонки, типы, ключи и описания полей перед написанием SQL |
| get_freshness | Покрытие синхронизации и время последнего успешного обновления |
| query_db | Один запрос только для чтения SELECT к schema_name.table |
Дополнительно
| Функция | Описание |
|---|---|
| Навыки | Многоразовые рабочие процессы анализа Amazon / Google Ads для вашего агента |
| Клиенты | ChatGPT, Claude, Cursor, Doubao, Claude Code, Hermes |
Быстрый старт
- Создайте рабочее пространство на connector.hologrow.ai.
- Подключите хотя бы один источник данных и дождитесь первой синхронизации.
- Добавьте 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"
}
}
}
}
ChatGPT / Claude / Doubao (OAuth)
ChatGPT web
- ChatGPT → Settings → Security and login → включите Developer mode.
- Боковая панель → Plugins → +.
- Имя:
Hologrow - URL сервера:
https://mcp.hologrow.ai/mcp - Аутентификация:
OAuth
- Имя:
- Нажмите Sign in with Hologrow и разрешите доступ.
ChatGPT desktop / Codex
- Settings → Plugins → Add MCP server.
- Имя:
Hologrow. Тип: Streamable HTTP. URL:https://mcp.hologrow.ai/mcp. - Нажмите Authenticate и завершите авторизацию.
Claude web / desktop
- Settings → Customize → Connectors → Add custom connector.
- Имя:
Hologrow. URL удалённого MCP-сервера:https://mcp.hologrow.ai/mcp. - Войдите и нажмите Allow access.
Doubao desktop (только настольное приложение)
- Skills · Connectors · Partners → New custom connector.
- Имя:
Hologrow. Транспорт: HTTP. URL:https://mcp.hologrow.ai/mcp. Оставьте заголовки пустыми. - Нажмите Authorize и разрешите доступ.
Cursor / Claude Code / Hermes (API-ключ)
Скопируйте API-ключ из консоли, затем отправьте этот запрос в новый разговор с агентом. Замените {apiKey}. Не просите агента повторять ключ.
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
Инструменты
Всегда определяйте названия из инструментов. Никогда не выдумывайте названия платформ, схем, таблиц или колонок. Названия полей в промежуточном ПО часто отличаются от меток в интерфейсе Amazon / Google.
list_platforms → list_tables → get_data_dictionary → get_freshness → query_db
Если инструмент завершился ошибкой или был отменён, сообщите об этом. Никогда не делайте вывод о нуле, отсутствии данных или метрике из отсутствующего результата.
list_platforms
Вызывайте это первым. Возвращает названия платформ, connected и schemas[].schema_name.
list_platforms()
list_tables
Список таблиц, доступных для запросов, для одной платформы из list_platforms.
list_tables({ "platform": "amazon_sp_seller" })
Результат:
{
"tables": ["order_items", "sales_and_traffic_daily", "fba_inventory_summaries"]
}
get_data_dictionary
Получите колонки, типы, ключи и описания. Передайте 1–10 точных названий таблиц из list_tables.
get_data_dictionary({
"platform": "amazon_sp_seller",
"table_names": ["orders", "order_items"]
})
get_freshness
Проверьте покрытие синхронизации, прежде чем считать число актуальным. schema_name берётся из list_platforms. Необязательный scope фильтрует по идентификатору ресурса.
get_freshness({
"schema_name": "amazon_sp_seller_xxxxxxxx",
"table_names": ["orders"],
"scope": { "marketplace_id": "ATVPDKIKX0DER" }
})
query_db
Выполните один запрос только для чтения SELECT. Указывайте каждую таблицу как schema_name.table. Используйте только колонки из 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
| Навык | Описание |
|---|---|
hologrow-data-middleware | Обнаружение покрытия, актуальности, схемы и безопасной области SQL |
amazon-ppc-campaign | Создание или оптимизация Amazon Sponsored Products / Brands |
amazon-display-ads | Планирование аудиторий Sponsored Display, ретаргетинга и измерений |
amazon-listing-optimization | Аудит текста листинга на основе поисковых и конверсионных данных |
google-ads-audit | Базовый аудит здоровья аккаунта Google Ads |
google-ads-anomaly-detection | Объяснение изменений в расходах, CPA, CVR, CTR или ROAS |
google-ads-utm-generator | Стандартизация соглашений UTM / ValueTrack в Google Ads |
ads-performance-analytics | Сверка атрибуции, ROAS и смешанного CAC |
21-ads-audit-global | Оценка подключённых аккаунтов платного трафика и приоритизация исправлений |
Пример запроса после установки:
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.
Не нашли нужный клиент или источник? Напишите на contact@hologrow.ai.
Ресурсы
Безопасность
Hologrow MCP ограничен рабочим пространством и работает только на чтение. Используйте только те источники, которые авторизованы в рабочем пространстве. Проверяйте актуальность, прежде чем считать число текущим. Указывайте определение метрики, окно атрибуции и период сравнения с каждым важным выводом. Никогда не помещайте API-ключи в git, файлы навыков или ответы модели.
Относитесь к изменениям кампаний, листингов и бюджетов как к предложениям, пока человек не одобрит их.
Устранение неполадок
| Симптом | Что попробовать |
|---|---|
| Не удаётся найти интерфейс плагина / коннектора | Проверьте версию клиента и права доступа. ChatGPT требует Developer mode. Doubao требует настольное приложение. |
| OAuth отменён | Перезапустите авторизацию. Не переключайтесь молча на API-ключ. |
| Новый чат не видит Hologrow | Обновите или перезапустите клиент, затем повторите list_platforms. |
| Агент никогда не вызывает Hologrow | Отправьте проверочное сообщение ещё раз, указав list_platforms. |
list_platforms возвращает [] | MCP работает; подключите источник данных и дождитесь первой синхронизации. |
| Ошибки SQL из-за неизвестных колонок | Повторно запустите get_data_dictionary. Не используйте названия полей исходной платформы. |