Hologrow
resmiLapisan 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_platformsguna melihat sumber data mana yang terhubung beserta nama skemanya. - Menjelajahi tabel yang tersedia — Gunakan
list_tablesuntuk menemukan tabel yang dapat dikueri untuk platform tertentu seperti Amazon atau Google Ads. - Memeriksa skema data — Minta
get_data_dictionaryuntuk menjelaskan kolom, tipe, dan makna bidang sebelum menulis SQL apa pun. - Memeriksa kesegaran data — Verifikasi cakupan sinkronisasi dan penyegaran terakhir dengan
get_freshnesssebelum membuat keputusan yang sensitif terhadap waktu. - Menjalankan kueri hanya-baca — Minta
query_dbuntuk menjawab pertanyaan bisnis dengan SQL yang aman dan hanya-baca terhadap data perdagangan yang telah disinkronkan.
Dokumentasi
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.
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
| Fitur | Deskripsi |
|---|---|
| list_platforms | Lihat sumber mana yang terhubung dan skema mana yang dapat Anda kueri |
| list_tables | Daftar tabel yang dapat dikueri untuk satu platform |
| get_data_dictionary | Kolom, tipe, kunci, dan deskripsi bidang sebelum Anda menulis SQL |
| get_freshness | Cakupan sinkronisasi dan pembaruan terakhir yang berhasil |
| query_db | Satu SELECT hanya-baca terhadap schema_name.table |
Lainnya
| Fitur | Deskripsi |
|---|---|
| Keterampilan | Alur kerja analisis Amazon / Google Ads yang dapat digunakan ulang untuk agen Anda |
| Klien | ChatGPT, Claude, Cursor, Doubao, Claude Code, Hermes |
Memulai Cepat
- Buat ruang kerja di connector.hologrow.ai.
- Hubungkan setidaknya satu sumber data dan tunggu sinkronisasi pertama.
- 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
- ChatGPT → Settings → Security and login → aktifkan Developer mode.
- Sidebar → Plugins → +.
- Nama:
Hologrow - URL Server:
https://mcp.hologrow.ai/mcp - Autentikasi:
OAuth
- Nama:
- Klik Sign in with Hologrow dan izinkan akses.
ChatGPT desktop / Codex
- Settings → Plugins → Add MCP server.
- Nama:
Hologrow. Tipe: Streamable HTTP. URL:https://mcp.hologrow.ai/mcp. - Klik Authenticate dan selesaikan otorisasi.
Claude web / desktop
- Settings → Customize → Connectors → Add custom connector.
- Nama:
Hologrow. URL server MCP jarak jauh:https://mcp.hologrow.ai/mcp. - Masuk dan klik Allow access.
Doubao desktop (hanya aplikasi desktop)
- Skills · Connectors · Partners → New custom connector.
- Nama:
Hologrow. Transport: HTTP. URL:https://mcp.hologrow.ai/mcp. Biarkan header kosong. - 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
| Alat | Deskripsi |
|---|---|
list_platforms | Temukan platform data yang tersedia, status koneksi, dan nama skema. Panggil ini terlebih dahulu. |
list_tables | Daftar tabel yang dapat dikueri untuk platform persis yang dikembalikan oleh list_platforms. |
get_data_dictionary | Periksa kolom, tipe, kunci, dan makna bidang untuk 1 hingga 10 nama tabel persis dari list_tables. |
get_freshness | Periksa cakupan sinkronisasi dan kesegaran. schema_name berasal dari list_platforms; berikan 1 hingga 50 nama tabel dari list_tables. |
query_db | Jawab 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, tanpaEXCEPTatauINTERSECT, tanpa skemapublicatau katalog sistem - Utamakan filter, agregasi, dan
LIMITdaripadaSELECT * - Default
max_rowsadalah 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
| Keterampilan | Deskripsi |
|---|---|
hologrow-data-middleware | Temukan cakupan, kesegaran, skema, dan cakupan SQL yang aman |
amazon-ppc-campaign | Bangun atau optimalkan Amazon Sponsored Products / Brands |
amazon-display-ads | Rencanakan audiens Sponsored Display, retargeting, dan pengukuran |
amazon-listing-optimization | Audit salinan daftar terhadap bukti pencarian dan konversi |
google-ads-audit | Tetapkan dasar kesehatan akun Google Ads |
google-ads-anomaly-detection | Jelaskan pergeseran belanja, CPA, CVR, CTR, atau ROAS |
google-ads-utm-generator | Standarkan konvensi UTM / ValueTrack Google Ads |
ads-performance-analytics | Rekonsiliasi atribusi, ROAS, dan CAC gabungan |
21-ads-audit-global | Nilai 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
| Gejala | Yang dapat dicoba |
|---|---|
| Tidak dapat menemukan UI plugin / konektor | Konfirmasi versi klien dan izin. ChatGPT memerlukan Developer mode. Doubao memerlukan aplikasi desktop. |
| OAuth dibatalkan | Mulai ulang otorisasi. Jangan diam-diam beralih ke kunci API. |
| Obrolan baru tidak melihat Hologrow | Segarkan atau mulai ulang klien, lalu coba lagi list_platforms. |
| Agen tidak pernah memanggil Hologrow | Kirim pesan verifikasi lagi, sebutkan list_platforms. |
list_platforms mengembalikan [] | MCP berfungsi; hubungkan sumber data dan tunggu sinkronisasi pertama. |
| Kesalahan SQL pada kolom yang tidak dikenal | Jalankan ulang get_data_dictionary. Jangan gunakan kembali nama bidang platform sumber. |