View Categories

Cara Mengakses Google Ads dengan Claude/Cursor melalui MCP (Pengaturan Server MCP Google Ads)

Waktu baca 25 menit

SERVER MCP IKLAN GOOGLE

Lakukan kueri Google Ads dengan Claude atau Kursor melalui server MCP Google Ads.

Pengaturan MCP Google Ads 5 menit yang memungkinkan alat AI Anda mengajukan pertanyaan dalam bahasa Inggris sederhana tentang kampanye, grup iklan, dan istilah pencarian Anda. Agen Query Streams menyimpan API Google Ads ke dalam permukaan SQL lokal, sehingga LLM melihat tabel nyata alih-alih titik akhir REST — dan Schema Intelligence menangani kosakata metrik (biaya dalam mikro, enum status, pembagian perangkat) sehingga SQL tepat pada percobaan pertama.

Tidak ada lubang firewall. Satu kunci, setiap konektor Data langsung, tanpa jeda cache. Bawa alat AI Anda sendiri

Query Streams adalah platform integrasi data real-time yang aman yang membawa setiap basis data dan API SaaS di akun Anda ke Claude, Cursor, ChatGPT, dan Grok — melalui satu kunci MCP tanpa perubahan firewall. Panduan ini akan menjelaskan secara detail tentang... Google Ads MCP Secara spesifik, alat AI Anda dapat menjawab pertanyaan dalam bahasa Inggris sederhana tentang kampanye, grup iklan, istilah pencarian, dan konversi tanpa perlu mengekspor laporan dari UI Google Ads atau membuat kueri GAQL lain di Editor Iklan. Agen Jaringan menarik data API Iklan ke dalam cache DuckDB lokal, sehingga LLM melihat antarmuka SQL yang bersih (kampanye, kata kunci, istilah pencarian, konversi) alih-alih REST dan GAQL mentah. Pelajari selengkapnya di QueryStreams.com dan Daftar gratis untuk mulai mengajukan pertanyaan Google Ads yang sebenarnya kepada alat AI Anda.

Apa yang diberikan oleh server Query Streams Google Ads MCP kepada Anda?

Server “Google Ads MCP” lainnya di ranah open-source menghubungkan alat AI langsung ke API Iklan dan mengirimkan GAQL mentah ke sana. Itu berhasil, tetapi mengirimkan token Google OAuth ke konfigurasi klien AI Anda, membuat LLM hanya melihat sumber daya REST dan pemilih bidang alih-alih SQL, membatasi alat AI hanya untuk Google Ads, dan tidak memberi Anda jejak audit tentang apa yang sebenarnya diminta oleh AI. Server Query Streams google ads mcp memecahkan masalah yang lebih luas: satu kunci, setiap konektor, jejak audit lengkap, agen menormalisasi data Iklan ke permukaan SQL, dan alat AI tidak pernah menyimpan kredensial Google Anda.

Tidak ada celah firewall masuk.

Network Agent membuka satu tautan cloud terenkripsi keluar ke Query Streams. Klien AI Anda terhubung ke cloud, tidak pernah ke Google Ads OAuth atau jaringan Anda. Tidak perlu membuka port, tidak perlu menambahkan IP ke daftar izin, tidak perlu VPN.

Satu kunci, setiap konektor

Kunci MCP yang sama akan sampai ke Google Ads bersamaan dengan setiap basis data dan API SaaS lain yang terhubung ke akun Anda. Tambahkan konektor Stripe atau PostgreSQL besok dan alat AI akan melihatnya di samping kampanye Anda tanpa perlu memasukkan kunci ulang.

Kecerdasan Skema terintegrasi

AI tersebut melihat deskripsi yang dikurasi AI, tipe semantik (mata uang dalam mikro, enum status, pemisahan perangkat), nilai sampel, dan kunci asing yang ditemukan untuk setiap bidang Google Ads — bukan hanya nama bidang GAQL. AI tersebut menulis SQL yang akurat pada percobaan pertama, termasuk biaya_mikro / 1000000 konversi yang terlewatkan oleh LLM skema dasar.

Mode baca saja diberlakukan di agen.

Bahkan seorang LLM yang sedang berhalusinasi pun tidak dapat menghentikan sementara kampanye, mengubah tawaran, atau mengubah grup iklan melalui Query Streams MCP. Agen Jaringan menolak apa pun yang tidak sesuai. PILIH, DENGAN, atau MENJELASKAN sebelum mencapai tabel Iklan yang di-cache — dan operasi mutate Google Ads tidak pernah terekspos ke permukaan MCP sejak awal.

Batasan laju per tombol

Secara default, 60 permintaan per menit dan 10 panggilan eksekusi per menit, dapat dikonfigurasi per kunci. Perulangan panggilan alat AI yang tak terkendali akan mengenai token bucket, bukan kuota API Google Ads Anda, pembatasan token pengembang Anda, atau dompet Anda.

Cara kerjanya tanpa membuka port firewall

Agen Jaringan Query Streams diinstal sekali pada host mana pun dengan akses internet (API Iklan dapat diakses dari mana saja) dan melakukan satu panggilan tautan TLS keluar ke cloud — ia memanggil API Google Ads dengan GAQL di baliknya, menyimpan respons dalam DuckDB lokal sehingga AI melihat permukaan SQL yang bersih (kinerja iklan Google, kata kunci, istilah_pencarian, konversi, penonton) sebagai pengganti amplop REST, dan alat AI tersebut tidak pernah melihat token Google OAuth, ID pelanggan, atau token pengembang Anda. Cara kerja koneksi khusus keluar →

Klien AI

Kursor, Claude,
ChatGPT, Grok

Server QS MCP

Streaming HTTP
Otentikasi X-MCP-Key

Agen Jaringan

Di jaringan Anda
Tautan awan keluar

API Google Ads

disimpan dalam cache sebagai SQL
melalui DuckDB

Tidak diperlukan port masuk — agen melakukan panggilan keluar, bukan sebaliknya.

Kunci MCP yang Anda berikan kepada Cursor atau Claude bersifat terbatas (scoped).membaca / menganalisa / menjalankan), dapat dicabut kapan saja, dan dibatasi laju per kunci. Alat AI memanggil alat MCP ini untuk melakukan pekerjaannya:

querystreams-mcp · katalog alat
qs_daftar_organisasimembaca
Mengembalikan organisasi yang terikat pada kunci pemanggil.
qs_list_agentsmembaca
Mencantumkan agen jaringan dan status online.
konektor_daftar_qsmembaca
Menampilkan daftar konektor data (satu entri per server basis data atau API).
qs_get_connector_schemamembaca
Mengembalikan tabel dan kolom Google Ads yang di-cache yang dapat diakses oleh AI (kampanye, grup iklan, istilah pencarian, konversi, audiens), dengan pengayaan Schema Intelligence jika tersedia.
tabel_profil_qsmenganalisa
Nilai sampel, distribusi, deteksi enum, tipe semantik — sesuai permintaan.
qs_list_saved_queriesmembaca
Template SQL berparameter siap pakai yang dipercaya oleh tim. AI menjalankannya tanpa pernah melihat kode SQL-nya.
qs_run_saved_querymenjalankan
Menjalankan kueri yang tersimpan dengan kunci pola dengan penggantian parameter opsional.
qs_jalankan_kuerimenjalankan
Menjalankan perintah SELECT terhadap konektor. Validator baca-saja berjalan di agen, sebelum basis data melihat SQL tersebut.

Mengapa Schema Intelligence membuat Query Streams MCP berbeda?

Sebagian besar server “MCP for Google Ads” di ranah sumber terbuka memberikan alat AI Anda referensi bidang GAQL yang sama dengan yang diterbitkan Google untuk pengembang — atau lebih buruk lagi, data mentahnya. skema_informasi dari apa pun yang mereka simpan dalam cache. Nama kolom. Tipe data. Mungkin kunci utama. LLM dibiarkan menebak-nebak. biaya_mikro perlu dibagi dengan 1.000.000, yaitu status_kampanye adalah enum dari DIAKTIFKAN / DIJEDA / DIHAPUS, atau bahwa tanggal_segmen adalah kolom partisi yang tepat untuk “30 hari terakhir.” Itulah mengapa SQL pertama yang ditulis sebagian besar LLM terhadap skema Iklan kosong salah — bukan karena LLM-nya buruk, tetapi karena tidak memiliki data yang dibutuhkan agar benar (dan kesalahan sebesar 1.000.000 dalam biaya adalah jenis kesalahan yang menjadi pesan kesalahan).

Query Streams MCP mengembalikan skema Iklan yang sama yang di-cache, diperkaya dengan apa yang kami sebut... Kecerdasan Skema (SI) — Metadata yang dikurasi AI yang dihasilkan dengan menjalankan kueri pembuatan profil terhadap data Anda sebenarnya Data Google Ads sebelum klien AI memintanya. Saat SI diaktifkan pada konektor Google Ads, setiap alat skema yang dipanggil AI (qs_get_connector_schema, qs_get_table_schema, tabel_profil_qs, qs_get_relationships) mengembalikan skema cache mentah ditambah enam lapisan pengetahuan yang telah dikurasi. LLM berhenti menebak-nebak.

Untuk memperjelas hal ini, berikut adalah apa yang diterima klien AI dari satu permintaan saja. qs_get_table_schema seruan menentang konektor Google Ads kinerja iklan Google Tabel — tampilan kampanye + grup iklan + tanggal yang dinormalisasi yang menjadi dasar 90% pertanyaan pelaporan — pertama tanpa Schema Intelligence, lalu dengan Schema Intelligence.

Tanpa Kecerdasan Skema sumber_data: skema_tertangkap
// apa yang dilihat LLM == TABEL: kinerja_google_ads == Kolom: – ID pelanggan bilangan bulat besar BUKAN NULL – campaign_id bilangan bulat besar BUKAN NULL – nama_kampanye varchar(500) – status_kampanye varchar(20) – ad_group_id bigint – nama_grup_iklan varchar(500) - perangkat varchar(20) – tanggal_segmen tanggal TIDAK NULL – klik bilangan bulat besar BUKAN NULL – kesan bilangan bulat besar BUKAN NULL – biaya_mikro bilangan bulat besar BUKAN NULL – konversi desimal(18,4) Indeks: ix_segments_date, ix_campaign_id Kunci Asing: (tidak ada yang dideklarasikan dalam cache) rekomendasi si: negara: “tidak_dijalankan” Yang Anda lewatkan untuk panggilan ini: – tipe semantik cost_micros (mata uang dalam mikro) – daftar nilai enum campaign_status / device – Contoh nilai + penandaan domain bisnis – Deskripsi tabel dan kolom – Hubungan yang ditemukan AI di seluruh tabel Iklan yang di-cache
Dengan Kecerdasan Skema sumber_data: kecerdasan_skema
// apa yang dilihat LLM == TABEL: kinerja_google_ads [FAKTA, domain:pemasaran] == “Performa Google Ads harian yang dinormalisasi per pelanggan, kampanye, grup iklan, perangkat, dan tanggal. cost_micros adalah mata uang dalam mikro (1.000.000 = $1).” ai_analyzed_at: 2026-05-05 · ~512,840 baris Kolom: – ID pelanggan bigint pengidentifikasi FK -> ad_accounts.customer_id (100%, conf 0.99) – campaign_id bigint pengidentifikasi – nama_kampanye varchar(500) konten teks Contoh: “Merek – AS – Pencarian”, “Performance Max – Liburan” – status_kampanye varchar(20) kode_status (enum) DIAKTIFKAN (78%) | DIJEDA (19%) | DIHAPUS (3%) - perangkat varchar(20) kode_status (enum) PERANGKAT SELULER (54%) | KOMPUTER DESKTOP (38%) | TABLET (8%) – tanggal_segmen tanggal tanggal_iso Contoh: 2026-05-05, 2026-05-04, 2026-05-03 – klik bigint menangkal Rentang: 0 – 18.744 – kesan bigint menangkal Rentang: 0 – 412.338 – biaya_mikro bigint mata uang mikro ⚠ Bagi dengan 1.000.000 untuk mendapatkan USD Contoh: 56640000 (= $56,64), 1284000 (= $1,28) – konversi desimal(18,4) penghitung (pecahan) Rentang: 0,00 – 184,50 · rata-rata 1,84

Kecerdasan Skema enam lapisan menambahkan

Setiap lapisan membahas kelas pertanyaan spesifik yang jika tidak, LLM harus menebak jawabannya. SI bersifat opsional. (konektor, basis data) Proses ini berjalan sebagai satu kali proses pembuatan profil terhadap data Anda — proses ini tidak mengubah skema Anda, tidak menulis ke basis data Anda, dan memperbarui secara bertahap ketika skema Anda berubah.

Deskripsi yang dikurasi oleh AI

Penjelasan sederhana dan mudah dipahami untuk setiap basis data, skema, tabel, dan kolom — dibuat sekali, diperbarui saat skema Anda berubah. Dinilai berdasarkan tingkat kepercayaan; deskripsi yang dibuat pengguna selalu diutamakan.

google_ads_performance: “Dinormalisasi harian
Performa iklan per kampanye + perangkat.”

Klasifikasi tabel

Setiap tabel diberi tag FACT (peristiwa transaksional), DIM (referensi deskriptif), atau LOOKUP (peta kode kecil), ditambah domain bisnis — pemasaran, penjualan, SDM, SEO, keuangan, dukungan, dan 14 lainnya.

google_ads_performance [FAKTA, domain:marketing]
akun_iklan [DIM, domain:pemasaran]

Tipe semantik per kolom

Delapan belas tipe — mata uang, mata uang mikro, email, tanggal_iso, kode_status, persentase, posisi_peringkat, pengidentifikasi, url, dan banyak lagi. AI menghasilkan SQL yang sesuai dengan dialek masing-masing tipe, termasuk biaya_mikro / 1000000 Konversi yang tidak dilakukan dengan benar oleh skema dasar LLM.

biaya_mikro: mata uang_mikro
konversi: penghitung · segmen_tanggal: tanggal_iso

Nilai sampel dari data nyata

Baris-baris acak ditampilkan ke LLM sehingga dapat mengenali pola yang tidak dapat ditunjukkan oleh skema apa pun — konvensi pemformatan, nilai yang dikodekan, gaya penamaan, dan bentuk sebenarnya dari nama kampanye Anda.

nama_kampanye: [“Merek – AS – Pencarian”,
“Performance Max – Liburan”, “RLSA – LTV Tinggi”]

Deteksi enum dengan distribusi

Kolom dengan kardinalitas rendah (50 nilai berbeda atau kurang, paling banyak 5% baris unik) dipetakan ke daftar nilai lengkapnya dengan jumlah baris. AI tidak pernah menebak huruf besar/kecil atau ejaan pada enum Google Ads.

status_kampanye: DIAKTIFKAN (78%) |
DIJEDA (19%) | DIHAPUS (3%)

Penemuan kunci asing implisit

Analisis tumpang tindih data lintas tabel menemukan penggabungan yang tidak dideklarasikan sebagai batasan DDL. Disimpan bersama dengan kunci asing formal dengan skor kepercayaan, dikembalikan oleh qs_get_relationships.

google_ads_performance.customer_id ->
ad_accounts.customer_id (tumpang tindih 100%, conf 0.99)

Perintah yang sama, SQL yang berbeda.

Buktinya ada pada SQL yang sebenarnya ditulis oleh alat AI tersebut. Sesi Cursor yang sama, model Claude yang sama, perintah yang sama — “Kampanye mana yang paling banyak menghabiskan anggaran dalam 30 hari terakhir, dengan rasio konversi saja, hanya untuk kampanye yang diaktifkan?” Tanpa Schema Intelligence, LLM harus menebak. Dengan itu, LLM mengetahui bahwa biayanya dalam mikron, enum status perlu difilter, dan diperlukan pengaman NULLIF.

Tanpa Kecerdasan Skema
— Upaya pertama LLM melawan skema dasar: PILIH nama_kampanye, JUMLAH(biaya_mikro) AS biaya, JUMLAH(konversi) AS percakapan, JUMLAH(konversi) / JUMLAH(klik) AS tingkat_konversi DARI kinerja iklan Google DI MANA segments_date >= '2026-04-06' KELOMPOKKAN BERDASARKAN nama_kampanye PESAN OLEH biaya DESC BATAS 10 Biaya yang dilaporkan sebesar $56.640.000 — selisih 1.000.000 biaya_mikro disimpan dalam mikro (1M = $1) tidak ada filter status kampanye — termasuk DIJEDA + DIHAPUS risiko pembagian dengan nol pada baris tanpa klik Tanggal yang dikodekan secara permanen — “30 hari terakhir” seharusnya dinamis.
Dengan Kecerdasan Skema
— Upaya pertama LLM dengan SI diaktifkan: PILIH nama_kampanye, JUMLAH(biaya_mikro) / 1000000 AS biaya_usd, JUMLAH(konversi) AS percakapan, PUTARAN(JUMLAH(konversi) * 100.0 / NULL(JUMLAH(klik), 0), 2) AS tingkat_konversi_persen DARI kinerja iklan Google DI MANA segments_date >= TANGGAL('Sekarang', '-30 hari') DAN status_kampanye = 'DIAKTIFKAN' KELOMPOKKAN BERDASARKAN nama_kampanye PESAN OLEH biaya_usd DESC BATAS 10 10 baris. Benar pada percobaan pertama. cost_micros melihat tipe semantik = currency_micros status_kampanye difilter ke nilai enum 'ENABLED' NULLIF melindungi dari kampanye tanpa klik. DATE('now', '-30 days') adalah dialek yang benar
Tidak ingin menjalankan Schema Intelligence? MCP masih berfungsi — alat skema mengembalikan metadata mentah (tipe, kunci utama, kunci asing formal, indeks) dan setiap respons yang terdegradasi membawa sebuah rekomendasi si Memblokir dan memberi tahu AI apa yang kurang, termasuk opsi satu kali panggilan untuk mengaktifkan SI di tengah percakapan melalui qs_request_si_analysis. Bagaimana Schema Intelligence bekerja dan berapa lama waktu yang dibutuhkan →
Nova AI

MCP tidak cocok untuk Anda? Coba Nova AI sebagai gantinya.

Lewati konfigurasi JSON sepenuhnya: Nova AI terintegrasi ke dalam portal web Query Streams. dan mengajukan pertanyaan Google Ads yang sama dalam bahasa Inggris sederhana (“Kata kunci mana yang menghabiskan anggaran bulan ini?”) di setiap konektor yang telah Anda tambahkan — agen yang sama, penegakan baca-saja yang sama, Kecerdasan Skema yang sama, tanpa infrastruktur MCP.

Temui Nova AI

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

  1. Akun Query Streams gratis di my.querystreams.com.
  2. Agen Jaringan Query Streams diinstal pada mesin dengan akses internet — lihat Unduh Agen Query StreamsAPI Google Ads dapat diakses dari mana saja, sehingga agen tidak perlu berada di jaringan tertentu.
  3. Konektor Google Ads yang dikonfigurasi terhadap agen — lihat yang sudah ada. Pengaturan Konektor API Panduan untuk pemasangan OAuth (akun tunggal atau pengelola MCC). Agen memegang token Google OAuth, ID pelanggan Anda, dan token pengembang Anda; alat AI tidak pernah menyentuh salah satu dari token tersebut.
  4. Klien AI apa pun yang kompatibel dengan MCP. Kami akan menunjukkan Cursor, Claude Desktop, ChatGPT, dan Grok dalam panduan ini; jika Anda menggunakan Windsurf, Zed, Continue, Cline, VS Code Copilot, Codex, atau Goose, blok konfigurasinya pada dasarnya sama.
  5. Lima menit.
Anda hanya perlu mengatur agen sekali saja. Agen yang sama yang mendukung add-on Excel dan Google Sheets Query Streams, Query Builder web, dan Nova AI juga melayani MCP. Menambahkan MCP ke akun Query Streams yang sudah ada hanya menghasilkan kunci — agen dan konektor sudah berjalan.
1

Hasilkan kunci MCP

Dari /mcp Di halaman Query Streams, buat kunci dengan cakupan yang Anda inginkan.

2

Masukkan ke dalam klien AI Anda.

Satu cuplikan JSON untuk Cursor, Claude, ChatGPT, atau Grok. Kunci yang sama di mana pun.

3

Ajukan pertanyaan

“Kampanye mana yang memiliki ROI terbaik bulan ini?” — AI akan memilih alat yang tepat, dan Anda akan mendapatkan jawabannya.

Langkah 1: Hasilkan kunci MCP di Query Streams

Masuk ke Query Streams dan buka Halaman MCP (atau masuk terlebih dahulu di my.querystreams.com lalu klik MCP (di navigasi sebelah kiri). Klik Hasilkan kunci, beri nama yang mudah dikenali pada kunci tersebut (sesuatu seperti kursor-laptop atau claude-desktop), dan pilih cakupan yang Anda inginkan untuk tombol ini:

  • membaca — AI dapat menelusuri konektor dan membaca skema. Diperlukan untuk semua hal lainnya.
  • menganalisa — AI dapat membuat profil tabel dan menemukan hubungan (nilai sampel, distribusi, tipe semantik). Opsional tetapi sangat disarankan untuk pekerjaan pencarian berbayar, di mana pemahaman tentang bentuk data kampanye Anda dan semantik metrik (biaya dalam mikro, enum status) sangat penting.
  • menjalankan — AI tersebut sebenarnya dapat menjalankan SQL. Tanpa ini, AI hanya dapat membaca metadata skema saja.

Untuk alur kerja tipikal "biarkan Claude menganalisis data Google Ads saya", ketiga cakupan tersebut sesuai. Untuk kunci yang Anda berikan kepada rekan tim atau klien yang kurang tepercaya, hilangkan menjalankan dan biarkan mereka hanya melihat-lihat. Anda dapat mencabut kunci apa pun kapan saja dari halaman yang sama; klien AI akan melihat KUNCI MCP DICABUT pada panggilan berikutnya dan berhenti bekerja seketika. Tidak ada penundaan propagasi.

Salin kuncinya sekarang — Query Streams menampilkannya sekali, lalu hanya menyimpan hash-nya. Jika Anda kehilangannya, buat yang baru. Kuncinya terlihat seperti ini: qsmcp_ diikuti oleh 48 karakter acak dan itulah yang dikirimkan oleh klien AI Anda. Kunci X-MCP Header permintaan.

Langkah 2: Tambahkan Query Streams MCP ke klien AI Anda

Konfigurasinya memiliki bentuk yang sama di setiap klien yang mendukung MCP — entri server MCP yang mengarah ke https://mcp.querystreams.com dengan kunci Anda di Kunci X-MCP Header. Pilih klien Anda di bawah ini.

Kursor
Kursor ~/.cursor/mcp.json
// Edit ~/.cursor/mcp.json
{
  "mcpServers": {
    "aliran kueri": {
      "url": "https://mcp.querystreams.com",
      "header": {
        "Kunci X-MCP": "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}
Claude Desktop
Claude Desktop claude_desktop_config.json
// Pengaturan → Pengembang → Edit Konfigurasi
{
  "mcpServers": {
    "aliran kueri": {
      "url": "https://mcp.querystreams.com",
      "header": {
        "Kunci X-MCP": "qsmcp_PASTE_KEY_HERE"
      }
    }
  }
}
ChatGPT
ChatGPT Aplikasi & Konektor
// Pengaturan → Aplikasi & Konektor → Tambahkan MCP
URL Server  https://mcp.querystreams.com
Header otentikasi Kunci X-MCP
Nilai header qsmcp_PASTE_KEY_HERE

// Membutuhkan paket ChatGPT berbayar
// (Plus / Pro / Team / Enterprise).
Grok
Grok Alat MCP Jarak Jauh
// Grok → Pengaturan → Alat
{
  "server mcp": [{
    "nama": "aliran kueri",
    "url": "https://mcp.querystreams.com",
    "header otentikasi": "Kunci X-MCP",
    "nilai_otorisasi": "qsmcp_..."
  }]
}

Restart klien AI Anda. Pada saat dijalankan berikutnya, klien akan menemukan delapan alat Query Streams MCP yang tercantum di atas dan menampilkannya di palet alatnya. Di Cursor dan Claude Desktop, Anda dapat memverifikasinya dengan mengetik “konektor daftar” — AI harus menelepon konektor_daftar_qs dan kembalikan konektor Google Ads Anda (atau setiap akun anak jika Anda memasangkan MCC) beserta semua hal lain yang telah Anda konfigurasi.

Langkah 3: Ajukan pertanyaan Google Ads kepada AI

Anda tidak perlu menulis SQL — AI yang melakukannya. Anda mengajukan pertanyaan, AI memilih alat MCP yang tepat, agen menjalankan kueri terhadap data Google Ads yang tersimpan dalam cache Anda, dan jawabannya akan dikembalikan berupa teks beserta tabel. Tiga contoh perintah yang dapat dicoba terlebih dahulu:

“Kampanye mana yang memiliki ROI terbaik dalam 30 hari terakhir — biaya vs konversi, hanya yang diaktifkan?”
ROI
AI akan menelepon qs_get_connector_schema untuk menemukan tabel Iklan yang di-cache, lalu qs_jalankan_kueri dengan perintah SELECT terhadap kinerja iklan Google yang membagi biaya_mikro per 1.000.000, menjumlahkan konversi dan pendapatan, memfilter status_kampanye = 'DIAKTIFKAN' dan tanggal_segmen hingga 30 hari terakhir, kemudian menghitung ROAS atau CPA per kampanye. Anda akan melihat tabel hasil secara langsung beserta interpretasi tertulis — kampanye mana yang berkembang secara efisien, mana yang tidak efisien dengan pengeluaran saat ini, dan mana yang terjebak di zona "biaya rendah, konversi rendah" di mana deteksi enum Schema Intelligence memandu agen untuk menyaringnya. DIJEDA + DIHAPUS secara otomatis.
“Tunjukkan kepada saya istilah pencarian yang menghasilkan konversi tetapi belum menjadi kata kunci — kita harus menambahkannya.”
Penemuan Kata Kunci Negatif
AI bergabung dengan data yang tersimpan dalam cache. istilah_pencarian meja untuk kata kunci Pada teks search_term, filter akan menampilkan istilah dengan konversi dalam 30 hari terakhir yang tidak memiliki kata kunci yang persis sama, dan mengurutkan berdasarkan konversi secara menurun. Di bawah tabel, AI biasanya akan memberi anotasi pada istilah mana yang terlihat seperti maksud berkualitas tinggi (long-tail, bermerek, berfokus pada masalah) dan mengusulkan untuk menambahkannya sebagai kata kunci yang persis sama. Kueri kebalikannya — “Kata kunci pencarian mana yang membuang anggaran dengan nol konversi setelah pengeluaran lebih dari $50?” — adalah bagian kata kunci negatif dari alur kerja yang sama dan AI menanganinya dengan cara yang sama.
“Berapa biaya per akuisisi kita berdasarkan grup iklan pada kuartal ini, berdasarkan perangkat?”
CPA Perangkat
Sebuah titik tumpuan oleh nama_grup_iklan dan perangkat dengan biaya dalam USD, konversi, dan CPA (biaya / konversi). Alat AI biasanya akan menyoroti pembagian perangkat yang paling menyimpang dari rata-rata kampanye — outlier CPA seluler umum terjadi pada Performance Max dan grup kata kunci pencocokan luas — dan mengusulkan tindak lanjut: “Apakah Anda ingin saya merincinya berdasarkan jam dalam sehari untuk grup iklan dengan kinerja terburuk?” Deteksi enum Schema Intelligence pada perangkat memastikan AI tidak pernah menghasilkan pemisahan “Mobile” / “mobile” / “mobile_phones” ketika Google Ads hanya memancarkan PONSEL, DESKTOP, TABLET.

Saat AI pertama kali memanggil suatu alat, klien Anda mungkin akan menampilkan prompt konfirmasi yang meminta Anda untuk menyetujui panggilan alat tersebut — itu adalah alur persetujuan standar MCP, bukan sesuatu yang ditambahkan oleh Query Streams. Setujui sekali dan AI akan melanjutkan percakapan selanjutnya dengan bebas. Anda dapat meninjau kembali persetujuan tersebut kapan saja di pengaturan klien Anda.

Pemberitahuan tagihan yang jujur: Penggunaan MCP dikenakan biaya berdasarkan byte yang tidak terkompresi.

Add-in Excel Query Streams, add-on Google Sheets, Query Builder web, dan Nova AI semuanya berjalan melalui tautan cloud terkompresi kami — kami mengukur dan menagihnya. byte terkompresi terhadap ranah data Anda. Transportasi MCP (Streamable HTTP sesuai spesifikasi resmi MCP) tidak secara andal mendukung kompresi ujung-ke-ujung di setiap klien dan proxy perantara, jadi kami mengukur dan menagihnya. Byte yang tidak dikompresi untuk lalu lintas MCP.

  • Artinya: Sebuah kueri agregat harian Google Ads sebesar 2 MB (kampanye + grup iklan + hari selama 90 hari, semua akun Anda) membutuhkan sekitar 2 MB data Anda saat diambil melalui MCP, dibandingkan dengan sekitar 300–400 KB melalui Excel/Sheets/Nova/Query Builder. Data Google Ads dapat dikompresi dengan baik — nama kampanye, enum status, dan label perangkat berulang di seluruh baris, sehingga LZ4 melalui tautan cloud biasanya mencapai pengurangan 5–7 kali lipat dibandingkan dengan metode transportasi lainnya. Data yang sama, transportasi yang berbeda, ukuran yang dapat ditagih berbeda.
  • Ini bukan: Apakah ini semacam markup atau hukuman karena menggunakan MCP? Kami hanya meneruskan byte aktual yang dikirim. Klien lain lebih murah karena kompresi bekerja dengan andal pada transport tersebut; kami tidak menghukum Anda karena pilihan protokol, tetapi kami harus transparan tentang bentuk biayanya.
  • Yang dapat Anda lakukan: Untuk ekspor berulang yang sangat besar (misalnya, kampanye multi-tahun + kata kunci + tabel silang istilah pencarian), lebih baik gunakan Excel/Sheets/Nova. Untuk panggilan alat AI interaktif (agregat Google Ads tipikal 100–5.000 baris yang sesuai dalam konteks LLM), MCP adalah pilihan yang tepat dan perbedaan biayanya hanya beberapa sen.

Pertanyaan yang sering diajukan

Apakah saya perlu membuka port atau menjalankan VPN untuk menggunakannya? +
Tidak — Agen Jaringan melakukan satu koneksi TLS keluar (port 443) dan klien AI Anda terhubung. https://mcp.querystreams.com dari internet publik, jadi jika HTTPS keluar berfungsi pada host agen, MCP berfungsi tanpa aturan masuk, penerusan port, atau VPN. Lihat cara kerja koneksi khusus keluar →
Alat AI apa saja yang dapat saya gunakan dengan Query Streams MCP? +
Klien apa pun yang mendukung protokol Model Context terbuka — Claude Desktop, Claude Code, Cursor, ChatGPT (berbayar), Grok, Gemini CLI, Windsurf, Zed, dan 500+ lainnya. Bawa alat AI Anda sendiri; Anda tidak perlu beralih. Daftar lengkap klien AI yang didukung →
Bisakah saya mencabut kunci MCP? +
Ya — tiga sakelar pemutus independen (per tombol dari /mcp halaman, per-organisasi melalui pengaturan paket, dan tingkat platform), yang semuanya tidak memerlukan rotasi kata sandi basis data atau memulai ulang agen. Selengkapnya tentang keamanan kunci MCP →
Bagaimana penggunaan MCP ditagihkan ke dalam data realm saya? +
Panggilan eksekusi MCP mengurangi anggaran ranah data yang sama dengan yang sudah digunakan oleh Excel, Google Sheets, Web Query Builder, dan Nova AI Anda — satu anggaran konsumsi di setiap metode akses. Ukuran yang diukur untuk MCP berbeda-beda. Klien lainnya menggunakan tautan cloud terkompresi kami (kami yang menagih). byte terkompresi); MCP berjalan melalui Streamable HTTP, yang tidak secara andal mendukung kompresi ujung-ke-ujung melalui setiap klien dan proxy, jadi kami menagih Byte yang tidak dikompresiAgregat harian Google Ads sebesar 2 MB yang dikembalikan ke Excel biasanya membutuhkan sekitar 300–400 KB dari data realm Anda (data iklan dengan nama kampanye berulang + enum status dikompresi 5–7 kali lipat melalui LZ4); hasil 2 MB yang sama yang dikembalikan ke Cursor melalui MCP membutuhkan sekitar 2 MB. Kami transparan tentang hal ini karena kami lebih suka Anda mengetahuinya di muka daripada terkejut di akhir siklus penagihan.
Apakah Query Streams MCP berfungsi dengan akun Google Ads MCC (manajer) saya? Bagaimana dengan pelaporan lintas akun? +
Ya — Agen Jaringan mendukung otentikasi Google Ads akun tunggal dan MCC (Manajer). Untuk MCC, Anda memberikan akses OAuth kepada agen ke manajer sekali saja dan agen akan menampilkan setiap akun anak yang dapat diakses sebagai konektor terpisah (atau sebagai tampilan terpadu tunggal jika Anda mau). Pelaporan lintas akun bekerja melalui denormalisasi agen kinerja iklan Google tabel: LLM dapat menulis satu perintah SELECT dengan DI MANA customer_id DALAM (...) Di banyak akun anak dan mendapatkan satu hasil gabungan. Itulah alur kerja yang sulit dilakukan di UI Google Ads (yang mengharuskan Anda beralih akun secara manual) dan mustahil dilakukan secara efisien di GAQL mentah (yang per-ID pelanggan) — agen melakukan fan-out per-pelanggan di balik layar, menyimpan respons per-akun dalam cache, dan mengekspos gabungan tersebut sebagai satu antarmuka SQL. Satu MCC + set anak adalah satu pemberian OAuth pada agen; token penyegaran berputar secara otomatis. Jika agensi Anda mengelola beberapa MCC yang tidak terkait, setiap MCC adalah konektor terpisah dan LLM memilih yang tepat berdasarkan nama.
Apa perbedaannya dengan menjalankan server Google Ads MCP sumber terbuka sendiri? +
Server MCP Google Ads langsung (proyek komunitas di GitHub memang ada, sebagian besar berupa pembungkus GAQL tipis) adalah satu MCP per sumber data — dan sebagian besar membuang bidang REST atau GAQL mentah di LLM, tanpa permukaan SQL, tanpa lapisan semantik metrik. Untuk membuat Claude membaca dari Google Ads + PostgreSQL Anda + akun Stripe Anda + gudang data Snowflake Anda, Anda memerlukan empat server MCP yang dikonfigurasi secara terpisah di setiap klien AI, masing-masing dengan kredensialnya sendiri, masing-masing dengan model cakupannya sendiri, masing-masing dengan cerita auditnya sendiri. Query Streams MCP adalah satu kunci yang menjangkau setiap konektor yang telah dipasangkan akun Anda, dan agen menormalisasi data Iklan ke permukaan SQL yang bersih dengan biaya_mikro Pengetikan semantik terintegrasi. Anda juga mendapatkan Kecerdasan Skema, penegakan baca-saja lapisan agen, batasan laju per kunci, jejak audit. log_peristiwa, dan alur penagihan ranah data yang sama yang sudah Anda gunakan — yang semuanya tidak diberikan oleh MCP langsung kepada Anda.
Apa yang terjadi jika AI mencoba menulis atau menghapus data? +
Permintaan tersebut ditolak di agen sebelum data Iklan yang tersimpan dalam cache melihat SQL. Setiap qs_jalankan_kueri Panggilan tersebut diuraikan oleh validator baca-saja yang dikodekan secara permanen yang hanya mengizinkan PILIH, DENGAN, dan MENJELASKAN pernyataan; hal lain apa pun akan dikembalikan PELANGGARAN HANYA BACA dan tidak pernah mencapai tabel Google Ads yang di-cache. Validator berjalan dalam proses agen, bukan di cloud, sehingga permukaan cloud yang disusupi tidak dapat melewatinya. Ada lapisan keamanan kedua di atasnya: operasi tulis/mutasi Google Ads (menghentikan sementara kampanye, mengubah tawaran, menyesuaikan anggaran) sama sekali tidak terekspos ke permukaan MCP sejak awal — agen hanya pernah mengeluarkan GAQL yang berbentuk baca ke API Google Ads. Jadi, bahkan jika validator entah bagaimana dilewati, LLM tidak memiliki apa pun yang dapat dipanggil untuk memodifikasi akun Anda.
Bisakah saya melihat apa yang sebenarnya ditanyakan oleh AI? +
Ya. Setiap panggilan alat MCP menulis satu baris ke log_peristiwa dengan informasi organisasi, pengguna, kunci, cakupan, latensi, dan kode hasil. Admin organisasi dapat menjawab pertanyaan “siapa yang menggunakan MCP minggu lalu, konektor mana, dan apa yang mereka tanyakan?” hanya dengan satu kueri. Perhatikan bahwa kami mencatatnya. nama alat dan metadata, bukan teks SQL atau baris yang dikembalikan — itu mengalir melalui tautan cloud dan tidak pernah masuk ke log cloud. API Google Ads tidak mengekspos permukaan riwayat perubahan yang dapat dibaca aplikasi OAuth kepada pemanggil pihak ketiga, jadi untuk Google Ads, agen tersebut log_peristiwa Ini adalah audit paling bersih yang bisa Anda dapatkan tentang "apa yang ditanyakan AI, terhadap akun anak mana, dan kapan?" — jawabannya ada di basis data Anda sendiri, bukan terkunci di balik konsol admin Google yang mungkin bukan milik Anda.
Apakah saya harus menjalankan Schema Intelligence untuk menggunakan Query Streams MCP? +
Tidak — SI bersifat sukarela (opt-in) (konektor, basis data) pasangan dan MCP berfungsi tanpanya (AI mendapatkan skema dasar dan sebuah rekomendasi si blok, dan dapat mengaktifkan SI di tengah percakapan melalui qs_request_si_analysis); dengan mengaktifkannya, AI mendapatkan enam lapisan metadata yang telah dikurasi sehingga dapat menulis SQL Google Ads yang benar — termasuk biaya_mikro / 1000000 konversi dan status_kampanye Penyaringan enum — pada percobaan pertama. Enam lapisan dan detail waktu eksekusi dibahas di atas dalam "Enam lapisan yang ditambahkan oleh Schema Intelligence." Bagaimana Schema Intelligence mendukung server MCP →
Bagaimana jika saya menambahkan konektor lain nanti, seperti Stripe atau PostgreSQL? +
Tidak ada yang berubah di sisi klien — kunci yang sama mencapai konektor baru pada saat agen memasangkannya (konektor_daftar_qs (diambil secara otomatis). Satu blok konfigurasi membeli seluruh akun Anda, saat ini dan di masa mendatang. Mengapa satu kunci mencakup semua konektor →
Apakah saya harus mengatur MCP hanya untuk mengobrol dengan data saya? +
TIDAK - Nova AI terintegrasi ke dalam portal Query Streams. dan berfungsi dengan setiap konektor (termasuk Google Ads) tanpa pengaturan MCP atau file konfigurasi. Gunakan Nova untuk berinteraksi dengan data Anda di dalam Query Streams; gunakan MCP saat Anda ingin klien AI Anda sendiri (Claude, Cursor, ChatGPT, …) mengakses data yang sama — agen yang sama, konektor yang sama, dan Schema Intelligence yang sama di baliknya. Pelajari lebih lanjut tentang Nova AI →

Mulai

Hubungkan alat AI Anda ke data Google Ads Anda dalam lima menit.

Satu kunci MCP menjangkau Google Ads, setiap basis data, dan setiap konektor API lainnya di akun Query Streams Anda — dengan jejak audit lengkap, batasan laju per kunci, pelaporan lintas akun yang sadar MCC, dan tanpa perubahan firewall. Claude, Cursor, ChatGPT, dan Grok semuanya berfungsi tanpa perlu konfigurasi tambahan.

Panduan terkait: Unduh Agen Query Streams | Pengaturan Konektor API | Semua panduan Server MCP | Konversi teks ke SQL Nova AI

Kategori: Server MCP

Tag: mcp, claude, kursor, google-ads, pencarian berbayar, ppc, analitik pemasaran, konektor api

Deskripsi Meta: Lakukan kueri Google Ads dengan Claude atau Cursor melalui MCP. Antarmuka SQL yang di-cache, dukungan MCC, tanpa celah firewall. Gratis.

Updated on 16 Juni 2026

Powered by BetterDocs