Hologrow

Hologrow MCP

面向 AI 的商业数据层。 一次连接 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、豆包或 Hermes 中提问
• 面向 LLM 的商业数据：为 Amazon SP、Amazon Ads、Google Ads、GA4、Search Console、Shoplazza 和领星 ERP 提供稳定的数据表
• 复杂工作交给我们：平台 OAuth、同步、数据新鲜度和表结构——智能体只读
• 默认只读：MCP 从不写回广告账户或店铺
• 智能体就绪：五个发现工具，外加一条命令即可安装的分析技能

功能概览

MCP 工具

更多

快速开始

1. 在 connector.hologrow.ai 创建工作区。
2. 至少连接一个数据源，等待首次同步完成。
3. 将 Hologrow MCP 添加到你的智能体。OAuth 客户端在界面中授权。Cursor / Claude Code / Hermes 使用 AI 平台 → 高级设置 中的 API 密钥。

仅创建 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 连接到任何 AI 智能体。

技能

为你的智能体提供查询工作流以及 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

智能体接入

你是 AI 智能体吗？获取此技能，然后调用 list_platforms。

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

工具

始终从工具中发现名称。切勿自行编造平台、schema、表或列名称。中间件字段名称通常与 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

获取列、类型、键和描述。传入来自 list_tables 的 1–10 个精确表名。

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> 替换为来自 list_platforms 的 schema_name。item_price 是订单行总计；仅当需要单价时才除以 NULLIF(quantity, 0)。不要将 _synced_at 用作销售日期。

规则

• 仅限单条语句。不支持 INSERT / UPDATE / DELETE / DDL，不支持 EXCEPT 或 INTERSECT，不支持 public schema 或系统目录
• 优先使用过滤、聚合和 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 的技能。

集成

智能体与 AI 工具

• ChatGPT 网页版、ChatGPT 桌面版、Codex
• Claude 网页版、Claude 桌面版、Claude Code
• Cursor
• 豆包（桌面版）
• Hermes

数据源

Amazon SP Seller、Amazon SP Vendor、Amazon Ads、Google Ads、GA4、Google Search Console、Shoplazza、领星 ERP。

缺少你喜欢的客户端或数据源？发送邮件至 contact@hologrow.ai。

资源

• 文档
• 产品
• 控制台
• MCP 端点
• 技能目录

安全

Hologrow MCP 是租户隔离且只读的。仅使用工作区已授权的数据源。在将某个数字视为当前值之前，先检查新鲜度。在得出每个重要结论时，说明指标定义、归因窗口和对比周期。切勿将 API 密钥放入 git、技能文件或模型回复中。

将广告活动、listing 和预算变更视为提案，直到人工批准。

故障排查

↑ 返回顶部 ↑