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 向けの安定したテーブル

• 面倒な部分は当社が担当: プラットフォームの OAuth、同期、鮮度、スキーマ — エージェントは読み取りのみ

• デフォルトで読み取り専用: MCP は広告アカウントやストアフロントに書き戻すことはありません

• エージェント対応: 5 つのディスカバリーツールに加え、1 コマンドでインストールできる分析スキル

Related MCP server: Snowflake MCP Server

機能概要

MCP ツール

その他

クイックスタート

1. connector.hologrow.ai でワークスペースを作成します。

2. データソースを 1 つ以上接続し、最初の同期を待ちます。

3. Hologrow MCP をエージェントに追加します。OAuth クライアントは UI で認証します。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"
      }
    }
  }
}

ChatGPT Web

1. ChatGPT → 設定 → セキュリティとログイン → 開発者モード をオンにします。

2. サイドバー → プラグイン → +。

   • 名前: Hologrow

   • サーバー URL: https://mcp.hologrow.ai/mcp

   • 認証: OAuth

3. Hologrow にサインイン をクリックしてアクセスを許可します。

ChatGPT デスクトップ / Codex

1. 設定 → プラグイン → MCP サーバーを追加。

2. 名前: Hologrow。タイプ: Streamable HTTP。URL: https://mcp.hologrow.ai/mcp。

3. 認証 をクリックして認証を完了します。

Claude Web / デスクトップ

1. 設定 → カスタマイズ → コネクタ → カスタムコネクタを追加。

2. 名前: Hologrow。リモート MCP サーバー URL: https://mcp.hologrow.ai/mcp。

3. サインインして アクセスを許可 をクリックします。

Doubao デスクトップ（デスクトップアプリのみ）

1. スキル・コネクタ・パートナー → 新しいカスタムコネクタ。

2. 名前: Hologrow。トランスポート: HTTP。URL: https://mcp.hologrow.ai/mcp。ヘッダーは空のままにします。

3. 承認 をクリックしてアクセスを許可します。

コンソールから API キーをコピーし、このプロンプトを 新しい Agent の会話に送信します。{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 を数分であらゆる 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

最初にこれを呼び出します。プラットフォーム名、connected、schemas[].schema_name を返します。

list_platforms()

list_tables

list_platforms から、1 つのプラットフォームでクエリ可能なテーブルを一覧表示します。

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 はリソース ID でフィルタリングします。

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

query_db

読み取り専用の SELECT を 1 回実行します。すべてのテーブルを 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 スキーマ、システムカタログは使用不可

• 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 デスクトップ、Codex

• Claude Web、Claude デスクトップ、Claude Code

• Cursor

• Doubao（デスクトップ）

• Hermes

データソース

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

お好みのクライアントまたはソースが見当たりませんか？ contact@hologrow.ai までメールしてください。

リソース

• ドキュメント

• プロダクト

• コンソール

• MCP エンドポイント

• スキルカタログ

安全性

Hologrow MCP はテナントスコープかつ読み取り専用です。ワークスペースが承認したソースのみを使用してください。数値を最新として扱う前に鮮度を確認してください。重要な結論には必ず、メトリクスの定義、アトリビューション期間、比較期間を明記してください。API キーを git、スキルファイル、モデルの応答に入れないでください。

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

トラブルシューティング