Hologrow

resmi

Lapisan data e-commerce untuk AI apa pun

Apa yang bisa Anda lakukan dengan Hologrow MCP?

  • Menemukan platform yang terhubung — Minta asisten Anda untuk memanggil list_platforms guna melihat sumber data mana yang terhubung beserta nama skemanya.
  • Menjelajahi tabel yang tersedia — Gunakan list_tables untuk menemukan tabel yang dapat dikueri untuk platform tertentu seperti Amazon atau Google Ads.
  • Memeriksa skema data — Minta get_data_dictionary untuk menjelaskan kolom, tipe, dan makna bidang sebelum menulis SQL apa pun.
  • Memeriksa kesegaran data — Verifikasi cakupan sinkronisasi dan penyegaran terakhir dengan get_freshness sebelum membuat keputusan yang sensitif terhadap waktu.
  • Menjalankan kueri hanya-baca — Minta query_db untuk menjawab pertanyaan bisnis dengan SQL yang aman dan hanya-baca terhadap data perdagangan yang telah disinkronkan.

Dokumentasi

Hologrow


Hologrow MCP

Lapisan data komersial untuk AI. Hubungkan Amazon, Google Ads, GA4, dan sistem penjualan lainnya sekali saja. Hologrow menjaga data tetap tersinkronisasi, lalu MCP memungkinkan Claude, Cursor, Codex, ChatGPT, dan agen lainnya untuk menanyakannya — tanpa ekspor CSV atau skrip API sekali pakai.

Dihosting di mcp.hologrow.ai. Konsol di connector.hologrow.ai. Dokumentasi di docs.hologrow.ai.

Hologrow connects commerce data sources to AI agents


Mengapa Hologrow?

  • Dibangun untuk alat yang sudah Anda gunakan: Hubungkan sekali, lalu ajukan pertanyaan di Claude, Cursor, Codex, ChatGPT, Doubao, atau Hermes
  • Data komersial siap-LLM: Tabel stabil untuk Amazon SP, Amazon Ads, Google Ads, GA4, Search Console, Shoplazza, dan Lingxing ERP
  • Kami menangani bagian yang sulit: OAuth platform, sinkronisasi, kesegaran, dan skema — agen hanya membaca
  • Hanya-baca secara default: MCP tidak pernah menulis kembali ke akun iklan atau toko
  • Siap untuk agen: Lima alat penemuan plus keterampilan analisis yang dapat Anda instal dengan satu perintah

Ringkasan Fitur

Alat MCP

FiturDeskripsi
list_platformsLihat sumber mana yang terhubung dan skema mana yang dapat Anda kueri
list_tablesDaftar tabel yang dapat dikueri untuk satu platform
get_data_dictionaryKolom, tipe, kunci, dan deskripsi bidang sebelum Anda menulis SQL
get_freshnessCakupan sinkronisasi dan pembaruan terakhir yang berhasil
query_dbSatu SELECT hanya-baca terhadap schema_name.table

Lainnya

FiturDeskripsi
KeterampilanAlur kerja analisis Amazon / Google Ads yang dapat digunakan ulang untuk agen Anda
KlienChatGPT, Claude, Cursor, Doubao, Claude Code, Hermes

Memulai Cepat

  1. Buat ruang kerja di connector.hologrow.ai.
  2. Hubungkan setidaknya satu sumber data dan tunggu sinkronisasi pertama.
  3. Tambahkan Hologrow MCP ke agen Anda. Klien OAuth mengotorisasi di UI. Cursor / Claude Code / Hermes menggunakan kunci API dari AI Platforms → Advanced settings.

Membuat kunci API saja tidak cukup. Instalasi berhasil ketika agen dapat memanggil list_platforms.

MCP

Hubungkan klien yang kompatibel dengan MCP apa pun. Transport menggunakan Streamable HTTP.

{
  "mcpServers": {
    "Hologrow": {
      "url": "https://mcp.hologrow.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
ChatGPT / Claude / Doubao (OAuth)

ChatGPT web

  1. ChatGPT → Settings → Security and login → aktifkan Developer mode.
  2. Sidebar → Plugins → +.
    • Nama: Hologrow
    • URL Server: https://mcp.hologrow.ai/mcp
    • Autentikasi: OAuth
  3. Klik Sign in with Hologrow dan izinkan akses.

ChatGPT desktop / Codex

  1. Settings → Plugins → Add MCP server.
  2. Nama: Hologrow. Tipe: Streamable HTTP. URL: https://mcp.hologrow.ai/mcp.
  3. Klik Authenticate dan selesaikan otorisasi.

Claude web / desktop

  1. Settings → Customize → Connectors → Add custom connector.
  2. Nama: Hologrow. URL server MCP jarak jauh: https://mcp.hologrow.ai/mcp.
  3. Masuk dan klik Allow access.

Doubao desktop (hanya aplikasi desktop)

  1. Skills · Connectors · Partners → New custom connector.
  2. Nama: Hologrow. Transport: HTTP. URL: https://mcp.hologrow.ai/mcp. Biarkan header kosong.
  3. Klik Authorize dan izinkan akses.
Cursor / Claude Code / Hermes (kunci API)

Salin kunci API dari konsol, lalu kirim prompt ini ke percakapan Agen baru. Ganti {apiKey}. Jangan minta agen untuk mengulangi kunci tersebut.

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.

Verifikasi

Mulai percakapan baru dan kirim:

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

Output:

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

Daftar kosong tetap berarti MCP terinstal — ruang kerja hanya belum memiliki sumber yang terhubung.


Berdayakan Agen Anda

Hubungkan Hologrow ke agen AI mana pun dalam hitungan menit.

Keterampilan

Berikan agen Anda alur kerja kueri dan buku pedoman Amazon / Google Ads.

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

Mulai ulang agen setelah menginstal. Berfungsi dengan Claude Code, Cursor, Codex, dan klien lain yang kompatibel dengan keterampilan.

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

Orientasi agen

Apakah Anda agen AI? Ambil keterampilan ini, lalu panggil list_platforms.

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

Alat

AlatDeskripsi
list_platformsTemukan platform data yang tersedia, status koneksi, dan nama skema. Panggil ini terlebih dahulu.
list_tablesDaftar tabel yang dapat dikueri untuk platform persis yang dikembalikan oleh list_platforms.
get_data_dictionaryPeriksa kolom, tipe, kunci, dan makna bidang untuk 1 hingga 10 nama tabel persis dari list_tables.
get_freshnessPeriksa cakupan sinkronisasi dan kesegaran. schema_name berasal dari list_platforms; berikan 1 hingga 50 nama tabel dari list_tables.
query_dbJawab pertanyaan data dengan satu SQL SELECT hanya-baca terhadap schema_name.table.

Selalu temukan nama dari alat. Jangan pernah menciptakan nama platform, skema, tabel, atau kolom. Nama bidang middleware sering berbeda dari label UI Amazon / Google.

list_platforms → list_tables → get_data_dictionary → get_freshness → query_db

Jika alat gagal atau dibatalkan, sampaikan hal itu. Jangan pernah menyimpulkan nol, tidak ada data, atau metrik dari hasil yang hilang.

list_platforms

Temukan platform data yang tersedia, status koneksi, dan nama skema pengguna. Gunakan selama orientasi dan kapan pun platform atau skema yang relevan tidak diketahui. Mengembalikan platform plus schemas[].schema_name untuk alat dan SQL selanjutnya.

list_platforms()

list_tables

Daftar tabel yang dapat dikueri untuk platform persis yang dikembalikan oleh list_platforms. Gunakan ini untuk menemukan tabel yang relevan dengan pertanyaan pengguna sebelum memeriksa bidang atau menulis SQL. Mengembalikan nama tabel persis untuk get_data_dictionary, get_freshness, dan query_db; jangan pernah menciptakan nama tabel.

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

Output:

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

get_data_dictionary

Periksa kolom, tipe, kunci, dan makna bidang untuk 1 hingga 10 nama tabel persis yang dikembalikan oleh list_tables. Gunakan sebelum menulis SQL. Nama-nama ini mungkin berbeda dari API platform sumber atau bidang laporan; gunakan hanya nama yang dikembalikan.

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

get_freshness

Periksa cakupan sinkronisasi dan kesegaran sebelum membuat kesimpulan yang sensitif terhadap waktu. schema_name harus berasal dari list_platforms schemas[].schema_name; berikan 1 hingga 50 nama tabel persis dari list_tables. Opsional scope memfilter berdasarkan identitas sumber daya, misalnya {"marketplace_id": "ATVPDKIKX0DER"}.

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

query_db

Jawab pertanyaan data konkret dengan satu SQL SELECT hanya-baca setelah menemukan skema, tabel, dan kolom yang relevan. Kualifikasikan sepenuhnya setiap tabel sebagai schema_name.table dan gunakan hanya pengidentifikasi yang dikembalikan oleh list_platforms, list_tables, dan 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
})

Ganti <schema> dengan schema_name dari list_platforms. item_price adalah total per baris pesanan; bagi dengan NULLIF(quantity, 0) hanya saat Anda membutuhkan harga per unit. Jangan gunakan _synced_at sebagai tanggal penjualan.

Aturan

  • Hanya satu pernyataan. Tanpa INSERT / UPDATE / DELETE / DDL, tanpa EXCEPT atau INTERSECT, tanpa skema public atau katalog sistem
  • Utamakan filter, agregasi, dan LIMIT daripada SELECT *
  • Default max_rows adalah 1000

Keterampilan

Alur kerja penasihat, hanya-baca di atas data Hologrow yang terhubung. Instal hologrow-data-middleware terlebih dahulu agar keterampilan lain memeriksa cakupan dan kesegaran sebelum menafsirkan kinerja.

npx skills@latest add hologrow/hologrow-mcp --skill SKILL_NAME
KeterampilanDeskripsi
hologrow-data-middlewareTemukan cakupan, kesegaran, skema, dan cakupan SQL yang aman
amazon-ppc-campaignBangun atau optimalkan Amazon Sponsored Products / Brands
amazon-display-adsRencanakan audiens Sponsored Display, retargeting, dan pengukuran
amazon-listing-optimizationAudit salinan daftar terhadap bukti pencarian dan konversi
google-ads-auditTetapkan dasar kesehatan akun Google Ads
google-ads-anomaly-detectionJelaskan pergeseran belanja, CPA, CVR, CTR, atau ROAS
google-ads-utm-generatorStandarkan konvensi UTM / ValueTrack Google Ads
ads-performance-analyticsRekonsiliasi atribusi, ROAS, dan CAC gabungan
21-ads-audit-globalNilai akun media berbayar yang terhubung dan prioritaskan perbaikan

Contoh prompt setelah instalasi:

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.

Katalog yang lebih besar (SEO, konektor riset, dan lainnya) tersedia di hologrow/hologrow-ai-skills. Repositori ini menyimpan keterampilan yang bergantung pada Hologrow MCP.


Integrasi

Agen & alat AI

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

Sumber data

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


Sumber Daya


Keamanan

Hologrow MCP bersifat terbatas-tenant dan hanya-baca. Gunakan hanya sumber yang telah diotorisasi oleh ruang kerja. Periksa kesegaran sebelum memperlakukan angka sebagai terkini. Nyatakan definisi metrik, jendela atribusi, dan periode perbandingan dengan setiap kesimpulan penting. Jangan pernah menaruh kunci API ke dalam git, file keterampilan, atau balasan model.

Perlakukan perubahan kampanye, daftar, dan anggaran sebagai proposal sampai manusia menyetujuinya.


Pemecahan Masalah

GejalaYang dapat dicoba
Tidak dapat menemukan UI plugin / konektorKonfirmasi versi klien dan izin. ChatGPT memerlukan Developer mode. Doubao memerlukan aplikasi desktop.
OAuth dibatalkanMulai ulang otorisasi. Jangan diam-diam beralih ke kunci API.
Obrolan baru tidak melihat HologrowSegarkan atau mulai ulang klien, lalu coba lagi list_platforms.
Agen tidak pernah memanggil HologrowKirim pesan verifikasi lagi, sebutkan list_platforms.
list_platforms mengembalikan []MCP berfungsi; hubungkan sumber data dan tunggu sinkronisasi pertama.
Kesalahan SQL pada kolom yang tidak dikenalJalankan ulang get_data_dictionary. Jangan gunakan kembali nama bidang platform sumber.

↑ Kembali ke atas ↑