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、Doubao、Hermes で質問できます
• LLM 対応のコマースデータ：Amazon SP、Amazon Ads、Google Ads、GA4、Search Console、Shoplazza、Lingxing ERP 用の安定したテーブルを提供します
• 複雑な作業は Hologrow が担当：プラットフォームの OAuth、同期、データの鮮度、スキーマを管理し、エージェントは読み取りのみを行います
• デフォルトで読み取り専用：MCP が広告アカウントやオンラインストアに書き戻すことはありません
• エージェント対応：5 つの検出ツールと、1 つのコマンドでインストールできる分析スキルを提供します

機能の概要

MCP ツール

その他

クイックスタート

1. connector.hologrow.ai でワークスペースを作成します。
2. 1 つ以上のデータソースを接続し、最初の同期が完了するまで待ちます。
3. Hologrow MCP をエージェントに追加します。OAuth クライアントは UI で認証します。Cursor / Claude Code / Hermes では、AI Platforms → Advanced settings で取得した API キーを使用します。

API キーを作成するだけでは不十分です。エージェントが list_platforms を呼び出せれば、インストールは成功です。

MCP

Streamable HTTP トランスポートを使用して、MCP 対応クライアントを接続します。

{
  "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

ツール

名前は必ずツールから取得してください。プラットフォーム名、スキーマ名、テーブル名、列名を推測で作らないでください。ミドルウェアのフィールド名は、Amazon / Google の UI ラベルと異なることがよくあります。

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

ツールが失敗またはキャンセルされた場合は、その旨を伝えてください。結果がないことから、ゼロ、データなし、または指標を推測しないでください。

list_platforms

ユーザーが利用できるデータプラットフォーム、接続状態、スキーマ名を確認します。オンボーディング時、および関連するプラットフォームやスキーマが不明な場合に使用します。後続のツールや SQL で使うプラットフォームと schemas[].schema_name を返します。

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

list_tables が返した正確なテーブル名を1～10個指定し、列、型、キー、フィールドの意味を確認します。SQL を作成する前に使用してください。これらの名前は、ソースプラットフォームの API やレポートのフィールド名と異なる場合があります。返された名前のみを使用してください。

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

get_freshness

時間に左右される結論を出す前に、同期対象の範囲とデータの鮮度を確認します。schema_name には list_platforms の schemas[].schema_name の値を指定してください。list_tables から取得したテーブル名を、正確に1～50個指定してください。省略可能な scope では、リソースの識別情報で絞り込めます。例：{"marketplace_id": "ATVPDKIKX0DER"}。

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

query_db

関連するスキーマ、テーブル、列を確認したうえで、具体的なデータに関する質問に、読み取り専用の SQL SELECT 文を1つだけ使って回答します。すべてのテーブルを 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> は list_platforms の schema_name に置き換えてください。item_price は注文行の合計金額です。単価が必要な場合に限り、NULLIF(quantity, 0) で割ってください。販売日として _synced_at を使用しないでください。

ルール

• 単一のステートメントのみを使用してください。INSERT、UPDATE、DELETE、DDL、EXCEPT、INTERSECT、public スキーマ、システムカタログは禁止です
• SELECT * よりも、フィルター、集計、LIMIT を優先してください
• 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 web、ChatGPT desktop、Codex
• Claude web、Claude desktop、Claude Code
• Cursor
• Doubao（デスクトップ）
• Hermes

データソース

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

リソース

• ドキュメント
• 製品
• コンソール
• MCP エンドポイント
• スキルカタログ

安全性

Hologrow MCP はテナントごとに適用範囲が制限され、読み取り専用です。ワークスペースで許可されているソースのみを使用してください。数値を最新のものとして扱う前に、データの鮮度を確認してください。重要な結論には必ず、指標の定義、アトリビューション期間、比較対象期間を明記してください。API キーを git、スキルファイル、モデルの返信に決して含めないでください。

キャンペーン、商品リスティング、予算の変更は、人間が承認するまでは提案として扱ってください。

トラブルシューティング

↑ トップに戻る ↑