Hubungkan Query Streams ke Claude dan ajukan pertanyaan tentang basis data Anda dalam bahasa yang mudah dipahami. Claude membaca skema Anda, kueri tersimpan Anda, dan model Schema Intelligence Anda secara langsung, menjalankan SQL hanya baca melalui Network Agent Anda, dan tidak pernah melihat kata sandi basis data. Panduan ini mencakup claude.ai, Claude Desktop, dan Claude Code, serta semua klien MCP lainnya.
Versi singkat. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, menemukan Aliran Kueri, klik Menghubungkan, setujui izin pada layar persetujuan Query Streams, dan tanyakan kepada Claude. “Saya dapat mengakses basis data apa saja?” That’s it.
Sebelum Anda mulai
Anda membutuhkan empat hal. Sebagian besar akun sudah memiliki tiga hal pertama.
Rencana yang mencakup MCP
MCP tersedia di semua paket, termasuk paket Gratis. Yang berbeda tergantung paket adalah jumlah kunci atau aplikasi terhubung yang dapat Anda simpan dan jumlah panggilan per menit yang dapat dilakukan Claude; paket Gratis memungkinkan satu kunci atau satu aplikasi terhubung dan 30 panggilan per menit.
Agen Jaringan yang sedang online
Agen adalah layanan kecil yang berada di samping basis data Anda dan membuat satu koneksi keluar ke Query Streams. Jika tim Anda sudah menjalankan kueri di Portal, Excel, atau Google Sheets, agen ini sudah terpasang. Panduan instalasi →
Setidaknya satu konektor
Konektor adalah basis data atau sumber API yang terdaftar di Portal. Claude dapat melihat setiap konektor yang dapat dilihat oleh akun Anda, sesuai dengan izin yang Anda berikan.
Akses MCP pada pengguna Anda
Pembuat dan pemilik organisasi secara otomatis memiliki akses MCP. Pengguna lain memerlukan persetujuan admin. MCP di samping nama mereka di Akun → Kontrol Akses.
Cara kerjanya
Claude tidak pernah terhubung ke basis data Anda. Ia berkomunikasi dengan server Query Streams MCP di cloud kami, yang meneruskan setiap permintaan melalui satu koneksi keluar yang sudah dibuka oleh Agen Jaringan Anda. Agen menjalankan kueri secara lokal dan mengirimkan kembali baris data dengan cara yang sama. Permintaan dan hasil mengalir ke kedua arah melalui satu saluran yang diinisiasi oleh agen tersebut, sehingga tidak perlu membuka apa pun di firewall Anda.
OAuth, cakupan, audit, batasan laju
satu koneksi TLS keluar
Tiga sifat muncul dari desain tersebut:
- Claude tidak memiliki kredensial. String koneksi basis data Anda tersimpan di agen. Claude hanya memegang izin OAuth atau kunci MCP, yang keduanya dapat Anda cabut dari Portal hanya dengan satu klik.
- Hanya baca, diberlakukan di agen. Hanya
PILIH,DENGANdanMENJELASKANPernyataan diterima. Pemeriksaan terjadi di sisi koneksi Anda, bukan di cloud dan bukan di Claude. - Semua hal dicatat. Setiap panggilan alat muncul di halaman MCP. Aktivitas tab dan setiap kueri dalam Riwayat Kueri, yang dikaitkan dengan pengguna yang terhubung.
Hubungi Claude
Ada dua cara untuk mengaksesnya. Aplikasi obrolan menggunakan OAuth dan tidak memerlukan kunci. Alat pengembang menggunakan kunci MCP. Keduanya terhubung ke server dan alat yang sama.
Opsi A: claude.ai dan Claude Desktop (OAuth, tanpa kunci)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from Telusuri konektor; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- Pada claude.ai membuka Settings → Connectors → Browse connectors, cari Aliran Kueri lalu klik Menghubungkan (or open the directory listing directly). In Claude Desktop the same option is under Pengaturan → Konektor. Can’t see it? Your organization may restrict directory connectors: click Tambahkan konektor khusus instead, name it Aliran Kueri and paste
https://mcp.querystreams.com/mcp. - Buka obrolan apa pun, klik + tombol di samping kotak pesan, pilih Aliran Kueri lalu klik Menghubungkan.
- Tab browser baru akan membuka layar persetujuan Query Streams. Masuk jika diminta, pilih organisasi, tinjau izin (lihat di bawah), dan klik. Setujui koneksi.
- Kembali di Claude, Anda akan melihat Terhubung ke Aliran KueriSaat Claude pertama kali menggunakan suatu alat, alat tersebut akan meminta izin. Pilih Selalu izinkan sehingga dapat berfungsi tanpa perlu meminta konfirmasi di setiap panggilan.
Konektor ini terhubung ke akun Claude Anda, bukan ke satu perangkat, sehingga akan muncul secara otomatis di aplikasi seluler Claude dan Claude Desktop. Kelola atau cabut konektor ini kapan saja dari Portal. MCP → Aplikasi Terhubung tab.
Tidak sama dengan “Tambahkan marketplace”. Di Claude Desktop, obrolan dalam aplikasi + → Jelajahi konektor → Tambahkan marketplace Opsi ini menginginkan repositori Git untuk pasar plugin, bukan URL server MCP. Gunakan Pengaturan → Konektor → Tambah.
Opsi B: Claude Code, Cursor, dan alat pengembang lainnya (kunci MCP)
Alat pengembang melakukan autentikasi dengan kunci yang Anda hasilkan di Portal dan meneruskannya. Kunci X-MCP Judul.
- Masuk di my.querystreams.com, membuka MCP → Kunci Saya lalu klik Hasilkan kunciBeri nama sesuai dengan alat dan mesinnya, misalnya... laptop claude code, dan pilih cakupannya.
- Salin kuncinya sekarang. Anda dapat menampilkan dan menyalinnya lagi nanti dari Kunci SayaKuncinya terlihat seperti...
qsmcp_diikuti oleh 43 karakter. - Untuk Claude Code, jalankan:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Untuk Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue dan Cline, buka MCP → Terhubung tab di Portal. Ini menampilkan konfigurasi siap tempel untuk setiap klien dengan kunci Anda yang sudah terisi.
Untuk memverifikasi, tanyakan “Konektor Query Streams apa saja yang saya miliki?” Klien harus menelepon konektor_daftar_qs dan kuncinya terakhir digunakan Waktu diperbarui pada tab Kunci Saya dalam hitungan detik.
Izin
Baik Anda terhubung melalui OAuth atau kunci, akses dikendalikan oleh tiga cakupan. Layar persetujuan menunjukkannya; kunci dibuat dengan menggunakan cakupan tersebut.
| Cakupan | Apa yang bisa dilakukan Claude | Kapan harus memberikannya? |
|---|---|---|
| membaca | Daftar konektor dan agen, telusuri skema, baca deskripsi Schema Intelligence, daftar kueri tersimpan, dan aturan peringatan. | Selalu. Segala sesuatu lainnya dibangun di atasnya. |
| menganalisa | Membuat profil tabel (nilai sampel, distribusi, tipe semantik), menemukan hubungan implisit, dan mengantrekan eksekusi Schema Intelligence. | Disarankan. Inilah yang memungkinkan Claude memahami bentuk data Anda sebelum menulis perintah join. |
| menjalankan | Jalankan SQL hanya baca dan kueri yang tersimpan, lalu alirkan kembali baris-baris data. | Bagi siapa pun yang seharusnya mendapatkan jawaban, bukan hanya sekadar menelusuri struktur. Biarkan opsi ini nonaktif untuk kunci yang hanya memungkinkan penelusuran. |
Aplikasi yang terhubung dapat dibatasi pada konektor tertentu saat Anda menyetujuinya; kunci yang dihasilkan akan menjangkau setiap konektor di organisasi. Pencabutan izin atau kunci akan berlaku dalam waktu sekitar lima menit. Admin dapat melihat setiap izin dan kunci aktif untuk organisasi di halaman MCP.
Apa yang bisa dilakukan Claude setelah terhubung?
Claude melihat seperangkat alat kecil. Anda tidak pernah menyebutkan alat-alat itu sendiri; Claude memilih alat yang tepat untuk pertanyaan Anda. Sederhananya:
Pahami data Anda
Cantumkan konektor, basis data, dan agen. Baca pohon skema untuk basis data apa pun dengan deskripsi tabel dan kolom, tipe semantik, nilai sampel, label enum, dan relasi yang dideklarasikan dan ditemukan.
Profil dan jelajahi
Lakukan profiling pada sebuah tabel untuk melihat distribusi nilai sebenarnya sebelum menulis filter. Temukan join antar tabel yang tidak memiliki foreign key yang dideklarasikan.
Gunakan kueri yang telah Anda simpan.
Cantumkan kueri berparameter yang tersimpan di organisasi Anda dan jalankan dengan parameter yang berbeda. Kueri terfederasi yang mencakup beberapa sumber dijalankan di sisi server dan mengembalikan baris yang sudah digabungkan.
Jalankan SQL ad-hoc
Tulis dan jalankan SQL hanya baca dalam dialek yang tepat untuk konektor. Hasil default adalah 1.000 baris dan batas waktu 60 detik, keduanya dapat disesuaikan.
Periksa peringatan
Daftar aturan peringatan, lihat status terkini dan aktivasi terbarunya. Claude dapat mengusulkan aturan baru dalam mode uji coba; seseorang akan mengaktifkannya di halaman Peringatan.
Perbaiki modelnya
Periksa cakupan Schema Intelligence per basis data dan, dengan persetujuan Anda, antrekan proses analisis agar jawaban di masa mendatang lebih baik.
Mengapa Kecerdasan Skema penting di sini?
Setiap respons yang diterima Claude diberi label dari tingkat mana dari tiga tingkatan tersebut berasal, dan Claude menyesuaikan seberapa besar kepercayaannya terhadap apa yang dilihatnya.
| Tingkat | Apa yang dilihat Claude | Hasil |
|---|---|---|
| Kecerdasan Skema | Deskripsi untuk setiap tabel dan kolom, tipe semantik, label enum, nilai sampel, klasifikasi fakta dan dimensi, penggabungan yang dideklarasikan dan ditemukan. | Claude menulis kode SQL berkualitas produksi pada percobaan pertama dan menjelaskan data tersebut dalam istilah bisnis Anda. |
| Skema yang diambil | Nama tabel dan kolom, tipe data, kunci utama, indeks, dan deklarasi kunci asing. | Claude berhasil, tetapi harus menyimpulkan makna dari nama-nama dan mungkin memerlukan pertanyaan lanjutan. |
| Skema langsung | Basis data tidak termasuk dalam pilihan pengambilan data konektor, sehingga struktur dibaca langsung dari katalog pada setiap permintaan. | Kueri masih berjalan. Claude melakukan eksplorasi dengan contoh perintah SELECT jika diperlukan. |
Jika sebuah basis data penting bagi tim Anda, jalankan Schema Intelligence sekali saja. Untuk basis data yang besar, batasi jalankan hanya pada tabel yang benar-benar digunakan oleh kueri Anda. Cara kerja Schema Intelligence →
Contoh perintah
Mulailah dengan sesuatu yang jawabannya sudah Anda ketahui. Kemudian ajukan pertanyaan lanjutan; Claude tetap memperhatikan konteksnya.
Basis data dan tabel apa saja yang dapat saya akses, dan mana di antaranya yang memiliki Schema Intelligence?Memetakan koneksi Anda dan memberi tahu Anda di mana respons akan paling kuat. Tunjukkan bagaimana pelanggan berhubungan dengan pesanan dalam basis data penjualan, dan buat profil kolom status pesanan.Menggunakan relasi dan profil kolom. Claude akan menunjukkan kepada Anda kode status sebenarnya dan artinya. Jalankan kueri tersimpan “Pendapatan bulanan berdasarkan wilayah” untuk kuartal kedua tahun ini.Menjalankan kueri tersimpan tepercaya dengan parameter, alih-alih membuat SQL sendiri. 10 produk teratas berdasarkan pendapatan dalam 90 hari terakhir. Kemudian uraikan berdasarkan saluran penjualan.SQL ad-hoc dalam dialek konektor, kemudian tindak lanjut pada thread yang sama. Aturan peringatan apa saja yang dikonfigurasi, dan apakah ada di antaranya yang aktif minggu ini?Membaca aturan peringatan dan status terbarunya.Tips untuk jawaban yang lebih baik
- Gunakan Proyek Claude. Hubungkan konektor Query Streams ke Proyek dan masukkan aturan bisnis Anda ke dalam instruksi proyek: basis data mana yang akan digunakan secara default, kueri tersimpan mana yang merupakan definisi resmi, dan konvensi penamaan. Claude masih membaca skema secara langsung, sehingga instruksinya tetap singkat.
- Simpan kueri yang Anda anggap kanonik. Claude akan mencari kueri yang tersimpan terlebih dahulu, jadi "pelanggan aktif" berarti apa yang tim Anda maksudkan.
- Berikan izin untuk menganalisis. Melakukan profiling pada sebuah kolom sebelum memfilternya adalah perbedaan antara menebak kode status dan menggunakan kode status yang tepat.
- Mintalah bagan. claude.ai menampilkan grafik dari baris yang diterima Claude.
Berapa biayanya?
MCP sendiri tidak mengenakan biaya terpisah pada paket apa pun. Dua hal yang diukur berdasarkan penggunaan adalah:
- Volume data. Hasil kueri yang dikembalikan ke Claude dihitung terhadap anggaran ranah data yang sama yang digunakan oleh Excel, Google Sheets, Portal, dan Nova Anda. Karena MCP berjalan melalui HTTP tanpa kompresi ujung-ke-ujung, ukurannya diukur dalam byte yang tidak terkompresi, sehingga hasil 1 MB membutuhkan sekitar 1 MB, sedangkan hasil yang sama untuk Excel biasanya membutuhkan 150 hingga 250 KB. Teruslah menyimpan
batas pratinjaucocok untuk pertanyaan eksploratif. - Schema Intelligence berjalan. Mengantrekan analisis melalui Claude akan membebankan kredit AI ke organisasi Anda, sama seperti menjalankannya dari Portal. Claude akan meminta persetujuan sebelum melakukan hal ini.
Penyelesaian Masalah
| Apa yang Anda lihat | Apa artinya | Memperbaiki |
|---|---|---|
| Claude tidak menampilkan alat Query Streams. | Konektor telah ditambahkan tetapi tidak terhubung dari obrolan, atau persetujuan OAuth tidak pernah diselesaikan. | Buka obrolan, klik +, pilih Aliran Kueri, Menghubungkan, dan selesaikan layar persetujuan. |
MCP_KEY_REQUIRED atau 401 | Tidak ada kunci atau izin yang sampai ke server. Bagi klien kunci, ini biasanya kesalahan salin-tempel seperti baris baru di akhir, atau kunci di header yang salah. | Salin ulang kunci ke dalam Kunci X-MCP Header. Untuk claude.ai, sambungkan kembali dari menu +. |
MCP_TOKEN_KADALUARSA | Token OAuth telah kedaluwarsa setelah periode tidak aktif. | Claude biasanya akan memperbarui dirinya sendiri. Jika tidak, cabut dan sambungkan kembali konektornya. |
KUNCI MCP DICABUT atau MCP_USER_DISABLED | Kunci tersebut telah dicabut, atau akses MCP telah dimatikan untuk pengguna Anda. | Buat kunci baru, atau minta admin untuk mengaktifkan kembali MCP. Akun → Kontrol Akses. |
MCP_SCOPE_REQUIRED | Hibah atau kunci tersebut paling sering tidak memiliki ruang lingkup untuk tindakan tersebut. menjalankan. | Hubungkan kembali dan setujui cakupan yang hilang, atau buat kunci yang menyertakannya. |
MCP_PLAN_LAPSED | Langganan organisasi Anda telah berakhir. | Halaman MCP di Portal menampilkan status rencana saat ini dan langkah selanjutnya. |
AGEN MCP TIDAK TERHUBUNG | Agen Jaringan yang memiliki konektor tersebut saat ini tidak terhubung. | Memeriksa Agen Data di Portal. Mulai layanan agen pada host-nya. |
KONEKTOR MCP TIDAK DIIZINKAN | Kunci tersebut terbatas pada konektor tertentu dan ini bukan salah satunya. | Edit daftar konektor yang diizinkan untuk kunci tersebut di bagian Kunci Saya, atau gunakan kunci yang berbeda. |
MCP_DATABASE_TIDAK_TERTANGKAP | Basis data tidak termasuk dalam pilihan pengambilan skema konektor, sehingga tidak ada Kecerdasan Skema atau relasi tersimpan yang dapat dibaca. Kueri tetap berfungsi. | Tambahkan basis data ke pilihan pengambilan data pada konektor di Portal, lalu secara opsional jalankan Schema Intelligence. |
MCP_RATE_LIMITED | Jumlah panggilan per menit terlalu banyak untuk paket Anda. | Tunggu sebentar. Sesi yang padat mendapat manfaat dari Schema Intelligence, yang memungkinkan Claude menjawab dalam jumlah panggilan yang lebih sedikit. |
MCP_QUERY_TIMEOUT | Kueri tersebut berjalan melebihi batas waktu default-nya, yaitu 60 detik. | Minta Claude untuk menambahkan filter atau batas bawah baris, atau menaikkan batas waktu_detik hingga 300. |
MCP_OUTPUT_TERLALU_BESAR | Hasilnya terlalu besar untuk disampaikan kepada Claude dalam satu jawaban. | Mintalah jumlah kolom atau baris yang lebih sedikit. Claude biasanya akan menyarankan hal ini sendiri. |
| Pelanggaran akses baca saja | SQL tersebut berisi sesuatu selain PILIH, DENGAN atau MENJELASKAN. | Sesuai rancangan. Penulisan tidak pernah diterima melalui MCP. |
Masih mengalami kesulitan? Buka tiket di my.querystreams.com/support atau email [email protected].
Keamanan dan privasi
- Claude menerima metadata skema, deskripsi Kecerdasan Skema termasuk nilai sampel, dan hasil kueri yang Anda ajukan. Hasil tersebut dikirimkan ke penyedia AI yang Anda pilih untuk dihubungkan, sesuai dengan ketentuan penyedia tersebut.
- Query Streams tidak menerima atau menyimpan percakapan Anda dengan Claude.
- Izin dan kunci OAuth berlaku per pengguna dan per organisasi. Administrator dapat melihat dan mencabut setiap izin dan kunci dari halaman MCP.
- Rincian lengkapnya ada di dalam Kebijakan Privasi dan Ketentuan Layanan.
Pertanyaan yang sering diajukan
Apakah saya perlu membuka port atau menjalankan VPN?
Tidak. Agen membuat satu koneksi TLS keluar pada port 443. Jika HTTPS keluar berfungsi, MCP juga berfungsi.
Bisakah Claude mengubah data saya?
Tidak. Agen hanya menerima pernyataan baca. Claude dapat mengantrekan eksekusi Schema Intelligence dan mengusulkan aturan peringatan dalam mode uji coba; keduanya menulis ke metadata Query Streams, tidak pernah ke basis data Anda.
Alat AI lain apa saja yang berfungsi?
Apa pun yang mendukung MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline, dan banyak lagi. Halaman MCP di Portal memiliki konfigurasi siap pakai untuk masing-masing.
Apakah ini berfungsi dengan beberapa organisasi?
Setiap hibah atau kunci terikat pada satu organisasi. Hubungkan sekali untuk setiap organisasi yang Anda butuhkan.
Apa perbedaan antara ini dan Nova?
Nova adalah asisten yang terintegrasi ke dalam Query Streams Portal dan menggunakan model Schema Intelligence yang sama. Gunakan Nova jika Anda menginginkan jawaban di dalam Query Streams; gunakan MCP jika Anda menginginkan data Anda di dalam Claude bersamaan dengan semua hal lain yang Anda lakukan di sana.
Panduan khusus konektor
Setiap panduan menjelaskan hubungan yang sama dengan contoh untuk sumber tersebut.
Basis data: Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oracle · Kepingan salju · Google BigQuery · SQLite · Microsoft Access · DuckDB · Supabase
Lebah: Stripe · Shopify · HubSpot · Google Ads · Google Analytics 4 · Konsol Pencarian Google · ShipStation · iTick
Folder berisi file dan log (Agen memindai folder dan mengubah file menjadi tabel): Sistem Berkas · Folder CSV · Folder Parket · Folder Excel · Folder SQLite · Folder JSONL · CSV multi-rekaman · Catatan Mesin · Log Server Web · Log Kontainer · Log Aplikasi · Log Sistem · Log Kustom
Basis data yang dihosting (mengelola PostgreSQL, MySQL, MariaDB, dan SQL Server, yang diakses oleh Agen melalui TLS): Neon · Amazon RDS · Azure Database untuk PostgreSQL · Azure Database untuk MySQL · Azure SQL · Google Cloud SQL · Google AlloyDB · Basis Data Terkelola DigitalOcean · Aiven · Jembatan Renyah · Heroku Postgres · Memberikan · Kereta Api · Fly.io Postgres · Basis Data Terkelola Vultr · Basis Data Terkelola OVHcloud · Basis Data Terkelola Scaleway · Basis Data OCI dengan PostgreSQL · Gelombang Panas MySQL · Basis Data Cloud IBM untuk PostgreSQL · MariaDB SkySQL · Xata · Timescale Cloud · PlanetScale Postgres · Prisma Postgres · Koyeb · Sungai Nil
Hubungkan Claude ke data Anda dalam waktu sekitar satu menit.
Tidak ada kunci, tidak ada file konfigurasi, tidak ada VPN. Hanya baca sesuai desain.
Buka halaman MCP Cara kerja MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish