Hologrow

Hologrow MCP

Lớp dữ liệu thương mại cho AI. Kết nối Amazon, Google Ads, GA4 và các hệ thống bán hàng khác một lần. Hologrow giữ dữ liệu đồng bộ, sau đó MCP cho phép Claude, Cursor, Codex, ChatGPT và các agent khác truy vấn dữ liệu — không cần xuất CSV hay viết script API riêng lẻ.

Được lưu trữ tại mcp.hologrow.ai. Bảng điều khiển tại connector.hologrow.ai. Tài liệu tại docs.hologrow.ai.

Tại sao chọn Hologrow?

• Được xây dựng cho các công cụ bạn đang dùng: Kết nối một lần, sau đó đặt câu hỏi trong Claude, Cursor, Codex, ChatGPT, Doubao hoặc Hermes
• Dữ liệu thương mại sẵn sàng cho LLM: Các bảng ổn định cho Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza và Lingxing ERP
• Chúng tôi xử lý phần khó: OAuth nền tảng, đồng bộ, độ mới và schema — agent chỉ đọc
• Chỉ đọc theo mặc định: MCP không bao giờ ghi ngược về tài khoản quảng cáo hoặc cửa hàng
• Sẵn sàng cho agent: Năm công cụ khám phá cùng các kỹ năng phân tích bạn có thể cài đặt bằng một lệnh

Tổng quan tính năng

Công cụ MCP

Thêm

Bắt đầu nhanh

1. Tạo không gian làm việc tại connector.hologrow.ai.
2. Kết nối ít nhất một nguồn dữ liệu và chờ đồng bộ đầu tiên.
3. Thêm Hologrow MCP vào agent của bạn. Ứng dụng khách OAuth ủy quyền trong giao diện. Cursor / Claude Code / Hermes dùng khóa API từ AI Platforms → Advanced settings.

Việc tạo khóa API là chưa đủ. Cài đặt thành công khi agent có thể gọi list_platforms.

MCP

Kết nối bất kỳ ứng dụng khách tương thích MCP nào. Giao thức vận chuyển là 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.

Xác minh

Bắt đầu một cuộc trò chuyện mới và gửi:

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

Đầu ra:

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

Danh sách trống vẫn có nghĩa là MCP đã được cài đặt — không gian làm việc chỉ chưa có nguồn kết nối nào.

Tăng cường sức mạnh cho Agent

Kết nối Hologrow với bất kỳ agent AI nào trong vài phút.

Kỹ năng

Cung cấp cho agent quy trình truy vấn và các kịch bản Amazon / Google Ads.

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

Khởi động lại agent sau khi cài đặt. Hoạt động với Claude Code, Cursor, Codex và các ứng dụng khách tương thích kỹ năng khác.

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

Tiếp nhận agent

Bạn là agent AI? Tải kỹ năng này, sau đó gọi list_platforms.

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

Công cụ

Luôn khám phá tên từ các công cụ. Không bao giờ tự bịa tên nền tảng, schema, bảng hoặc cột. Tên trường middleware thường khác với nhãn giao diện Amazon / Google.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Nếu một công cụ thất bại hoặc bị hủy, hãy nói rõ. Không bao giờ suy luận số không, không có dữ liệu hoặc một chỉ số từ kết quả thiếu.

list_platforms

Khám phá các nền tảng dữ liệu khả dụng, trạng thái kết nối và tên schema của người dùng. Sử dụng trong quá trình tiếp nhận và bất cứ khi nào nền tảng hoặc schema liên quan chưa rõ. Trả về nền tảng cùng schemas[].schema_name cho các công cụ và SQL sau này.

list_platforms()

list_tables

Liệt kê các bảng có thể truy vấn cho một nền tảng chính xác do list_platforms trả về. Sử dụng công cụ này để tìm các bảng liên quan đến câu hỏi của người dùng trước khi kiểm tra trường hoặc viết SQL. Trả về tên bảng chính xác cho get_data_dictionary, get_freshness và query_db; không bao giờ tự bịa tên bảng.

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

Đầu ra:

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

get_data_dictionary

Kiểm tra cột, kiểu dữ liệu, khóa và ý nghĩa trường cho 1 đến 10 tên bảng chính xác do list_tables trả về. Sử dụng trước khi viết SQL. Các tên này có thể khác với trường API hoặc báo cáo của nền tảng nguồn; chỉ sử dụng các tên được trả về.

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

get_freshness

Kiểm tra phạm vi đồng bộ và độ mới trước khi đưa ra kết luận nhạy cảm về thời gian. schema_name phải đến từ list_platforms schemas[].schema_name; cung cấp 1 đến 50 tên bảng chính xác từ list_tables. scope tùy chọn lọc theo danh tính tài nguyên, ví dụ {"marketplace_id": "ATVPDKIKX0DER"}.

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

query_db

Trả lời một câu hỏi dữ liệu cụ thể bằng một SELECT SQL chỉ đọc sau khi khám phá schema, bảng và cột liên quan. Định danh đầy đủ mọi bảng là schema_name.table và chỉ sử dụng các định danh do list_platforms, list_tables và get_data_dictionary trả về.

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
})

Thay thế <schema> bằng schema_name từ list_platforms. item_price là tổng dòng đơn hàng; chia cho NULLIF(quantity, 0) chỉ khi bạn cần giá trên mỗi đơn vị. Không sử dụng _synced_at làm ngày bán hàng.

Quy tắc

• Chỉ một câu lệnh. Không INSERT / UPDATE / DELETE / DDL, không EXCEPT hoặc INTERSECT, không public schema hoặc danh mục hệ thống
• Ưu tiên bộ lọc, tổng hợp và LIMIT hơn SELECT *
• max_rows mặc định là 1000

Kỹ năng

Quy trình tư vấn, chỉ đọc trên dữ liệu Hologrow đã kết nối. Cài đặt hologrow-data-middleware trước tiên để các kỹ năng khác kiểm tra phạm vi và độ mới trước khi diễn giải hiệu suất.

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

Ví dụ lời nhắc sau khi cài đặt:

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.

Danh mục lớn hơn (SEO, trình kết nối nghiên cứu và nhiều hơn) nằm tại hologrow/hologrow-ai-skills. Kho này giữ các kỹ năng phụ thuộc vào Hologrow MCP.

Tích hợp

Agent & công cụ AI

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

Nguồn dữ liệu

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

Tài nguyên

• Tài liệu
• Sản phẩm
• Bảng điều khiển
• Điểm cuối MCP
• Danh mục kỹ năng

An toàn

Hologrow MCP được giới hạn theo không gian làm việc và chỉ đọc. Chỉ sử dụng các nguồn mà không gian làm việc đã ủy quyền. Kiểm tra độ mới trước khi coi một con số là hiện tại. Nêu rõ định nghĩa chỉ số, cửa sổ phân bổ và khoảng thời gian so sánh với mọi kết luận quan trọng. Không bao giờ đưa khóa API vào git, tệp kỹ năng hoặc phản hồi của mô hình.

Coi các thay đổi chiến dịch, danh sách và ngân sách là đề xuất cho đến khi con người phê duyệt.

Khắc phục sự cố

↑ Lên đầu trang ↑