Hubungkan Query Streams ke Claude dan ajukan pertanyaan tentang basis data Anda dalam bahasa yang mudah dipahami. Claude membaca skema Anda, kueri yang telah Anda simpan, dan Kecerdasan Semantik Model berjalan secara langsung, menjalankan SQL hanya baca melalui Agen Jaringan Anda, dan tidak pernah melihat kata sandi basis data. Klien AI Anda meminta; Agen Jaringan, mitranya di dalam jaringan Anda, melakukan pekerjaan berat di tempat data berada. Panduan ini mencakup claude.ai, Claude Desktop, ChatGPT, dan Claude Code, serta setiap klien MCP lainnya.
Versi singkat. Instal Agen Jaringan Di samping basis data Anda, tunggu beberapa menit, lalu tambahkan konektor. Kemudian buka Daftar Aliran Kueri Di Direktori Konektor Anthropic, klik Menghubungkan, setujui izin pada layar persetujuan Query Streams, dan tanyakan kepada Claude. “Saya dapat mengakses basis data apa saja?” Claude hanya dapat melihat data yang disajikan oleh Agen: lewati Agen tersebut dan ia akan memberi tahu Anda bahwa tidak ada konektor.
Sebelum Anda mulai
Anda membutuhkan empat hal. Jika Anda menemukan Query Streams dari dalam Claude, Agent dan connector adalah dua hal yang masih perlu Anda siapkan.
Rencana yang mencakup MCP
MCP tersedia di semua paket, termasuk paket Gratis. Paket Anda menentukan berapa banyak kunci atau aplikasi terhubung yang dapat Anda pegang, berapa banyak panggilan per menit yang dapat dilakukan klien AI Anda, dan berapa banyak baris yang dikembalikan oleh satu kueri, serta apakah perangkat alat Analitik disertakan. Apa yang termasuk dalam setiap paket?.
Agen Jaringan yang sedang online
Agen adalah layanan kecil yang berada di samping basis data Anda dan membuat satu koneksi keluar ke Query Streams. Akun baru? Instal sekarang dari my.querystreams.com/download, beberapa menit kemudian Windows, macOS atau LinuxJika tim Anda sudah menjalankan kueri di Portal, Excel, atau Google Sheets, maka fitur ini sudah terpasang.
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.
Hubungkan klien AI Anda
Halaman MCP di Portal (Streaming → Langsung → MCP) memiliki empat tab: Koneksi, Konteks, Peralatan dan, untuk admin, Aktivitas. Di Connections, itu Hubungkan klien AI Tombol ini membuka panduan empat langkah: Bagaimana klien AI Anda akan terhubung?, Pilih klien AI Anda, Siapkan dan Periksa koneksinyaAda dua cara untuk mengaksesnya. Aplikasi obrolan menyetujui dari dalam aplikasi dan tidak memerlukan kunci. Alat pengembang menggunakan kunci MCP. Keduanya terhubung ke server dan alat yang sama.
Opsi A: claude.ai, Claude Desktop dan ChatGPT (persetujuan dari aplikasi, tanpa kunci)
Terdaftar dalam Direktori Penghubung Antropik. Query Streams adalah konektor yang disetujui: claude.ai/direktori/query-streamsBuka daftar tersebut, klik Menghubungkan dan menyetujui; tidak perlu URL server. Menambahkannya melalui URL adalah solusi alternatif untuk organisasi Claude yang membatasi konektor direktori.
- Buka Daftar Aliran Kueri lalu klik MenghubungkanKonektor ini tersinkronisasi dengan akun Claude Anda, sehingga Claude Desktop menampilkannya di bawah... + → Konektor. Tidak dapat melihat daftarnya? Organisasi Anda mungkin membatasi konektor direktori: di Pengaturan → Konektor klik Tambahkan konektor khusus, sebutkan itu Aliran Kueri, tempel
https://mcp.querystreams.com/mcp, lalu di obrolan klik +, memilih 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 → Koneksi tab.
ChatGPT. Tambahkan Aliran Kueri dari aplikasi itu sendiri: untuk saat ini, itu berarti mengaktifkan mode pengembang di pengaturan ChatGPT dan membuat koneksi di sana, lalu mengklik Masuk dengan Query Streams dan menyetujuinya pada layar persetujuan yang sama. Panduan Portal menunjukkan langkah-langkah ChatGPT saat ini; daftar resmi ChatGPT sedang dalam proses pembuatan.
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 yang ada di daftar. Menghubungkan tombol, atau Pengaturan → Konektor → Tambah untuk rute URL.
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 lalu klik Hubungkan klien AI. Memilih Gunakan kunci dalam file konfigurasi dan pilihlah alat Anda.
- Klik Hasilkan kunci untuk alat Anda. Beri nama sesuai dengan alat dan mesinnya, misalnya... laptop claude code, menyimpan Membaca dan Jalankan kueri, dan pilih tanggal kedaluwarsa. Anda dapat menampilkan dan menyalin kunci tersebut lagi nanti dari Koneksi tab. Tombol-tombolnya terlihat seperti
qsmcp_diikuti oleh 43 karakter. - Siapkan Menampilkan konfigurasi siap tempel untuk Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline, dan lainnya, dengan kunci Anda sudah terisi. Untuk Claude Code, hanya perlu satu perintah:
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Periksa koneksinya menunggu panggilan pertama dari tombol itu dan berkata Terhubung.
Untuk memverifikasi kapan saja, tanyakan “Konektor Query Streams apa saja yang saya miliki?” Klien harus menelepon konektor_daftar_qs, dan kuncinya Terakhir digunakan Waktu pada tab Koneksi diperbarui 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 Semantic Intelligence serta profil kolom dan relasi yang tersimpan, lalu daftar kueri tersimpan dan aturan peringatan. | Selalu. Segala sesuatu lainnya dibangun di atasnya. |
| menganalisa | Buat profil tabel atau temukan relasi implisit secara langsung di Network Agent, lalu antrekan proses Semantic Intelligence. Tanpanya, klien AI Anda tidak dapat melihat alat untuk memulai proses Semantic Intelligence. | Disarankan. Inilah yang memungkinkan Claude memahami bentuk data Anda sebelum menulis perintah join. |
| menjalankan | Ditampilkan sebagai Jalankan kueri (hanya baca). Jalankan SQL hanya baca dan kueri yang tersimpan serta alirkan kembali baris; simpan hasilnya dan jalankan alat tindak lanjut dan analisis di atasnya. | 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 tab Koneksi.
Apa yang dapat dilakukan klien AI Anda setelah terhubung
Klien AI Anda melihat alat Query Streams dan memilih yang tepat untuk pertanyaan Anda; Anda tidak pernah memanggilnya sendiri. Portal ini Tab Alat mencantumkan setiap alat dan mode, fungsi masing-masing, serta yang disertakan dalam paket Anda.
Untuk pertanyaan tentang data Anda, Query Streams memandu klien AI Anda melalui empat langkah: daftar konektor Anda, baca tabel dalam database, baca kolom setiap tabel yang akan dikuerinya, lalu jalankan kueri hanya-baca. Membaca kolom terlebih dahulu mencegahnya menebak nama. Tersedia di semua paket, termasuk Free:
Petakan 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.
Jalankan SQL hanya baca
Tulis dan jalankan SQL hanya baca dalam dialek yang tepat untuk konektor. Batas waktu default 60 detik, hingga lima menit; rencana Anda menentukan berapa banyak baris yang dikembalikan oleh satu kueri.
Kueri tersimpan, terfederasi, dan peringatan
Jalankan kueri berparameter yang tersimpan di organisasi Anda dengan nilai baru; kueri gabungan yang mencakup beberapa sumber akan dikembalikan dalam keadaan sudah digabungkan. Baca aturan peringatan dan pemicuan terbarunya, serta usulkan aturan baru dalam mode uji coba.
Perangkat alat analitik
Pada paket berbayar, Network Agent melakukan pekerjaan dasar di mana data Anda berada: ia mengukur, membuat profil, menyimpan, dan menganalisis hasilnya, sehingga klien AI Anda memasuki setiap pertanyaan dengan konteks yang sudah disiapkan dan memusatkan perhatiannya pada proses berpikir. Paket Gratis berfungsi seperti biasa, dengan hasil standar. Panduan lengkapnya ada di Analisis data Anda dengan klien AI Anda..
Manajemen konteks
Personal Core dan seterusnya. Periksa ukuran hasil sebelum membacanya (membentuk): kolom, perkiraan baris dan biaya token, tidak ada baris. Telusuri basis data besar area demi area (tingkat skema). Batasi jumlah token dalam jawaban, hanya dengan kolom dan panjang sel teks yang dibutuhkannya.
Analisis hasil
Personal Core dan seterusnya. A profil dari keseluruhan hasil, bukan per baris. Hasil yang dipertahankan, dengan label, jawab pertanyaan lanjutan seperti “uraikan berdasarkan wilayah” atau “50 baris berikutnya” tanpa kueri basis data kedua. Kesegaran data dan berubah sejak Bacalah hanya yang terbaru.
Analisis lebih mendalam
Bisnis Inti dan ke atas. Sebuah data kualitas laporan, anomali, segmen, statistik membandingkan dan sebuah perbedaan di antara dua hasil yang telah ditentukan.
Anda tetap memegang kendali. Itu Tab konteks Mengatur nilai default: batas sel teks, tampilan skema untuk basis data besar, ukuran hasil, dan nilai default analisis, serta menunjukkan apa yang diterima klien AI Anda. Ini juga mencantumkan hasil yang dipegang setiap Agen. Setiap kunci dapat menimpa nilai default, setiap panggilan ada di tab Aktivitas, dan admin dapat mengaktifkannya. Analisis lokal libur untuk seorang Agen di bawah Data → Agen Data.
Apa yang termasuk dalam rencana Anda?
MCP tersedia di semua paket, termasuk paket Gratis, dan paket Gratis tidak pernah kedaluwarsa.
| Rencana | Kunci per pengguna | Kunci per organisasi | Panggilan per menit | Jumlah baris per kueri | Perangkat alat analisis | Hasil yang dipertahankan |
|---|---|---|---|---|---|---|
| Gratis | 1 | 1 | 30 | 1,000 | Hasil standar | Tidak ada |
| Inti Pribadi | 1 | 1 | 60 | 2,500 | Manajemen konteks, Analisis hasil | 15 menit, 128 MB |
| Personal Plus | 1 | 1 | 90 | 5,000 | Manajemen konteks, Analisis hasil | 15 menit, 128 MB |
| Inti Bisnis | 2 | 3 | 120 | 10,000 | Manajemen konteks, Analisis hasil, Analisis lebih mendalam | 60 menit, 512 MB |
| Bisnis Plus | 3 | 5 | 150 | 25,000 | Ketiganya | 60 menit, 512 MB |
| Bisnis Max | 5 | 10 | 240 | 50,000 | Ketiganya | 60 menit, 512 MB |
| Inti Perusahaan | 5 | 25 | 300 | 100,000 | Ketiganya | 8 jam, 4.096 MB |
| Perusahaan Plus | 8 | 50 | 450 | 100,000 | Ketiganya | 8 jam, 4.096 MB |
| Enterprise Max | 10 | 100 | 600 | 100,000 | Ketiganya | 8 jam, 4.096 MB |
Aplikasi yang terhubung dihitung sebagai kunci. Pada setiap paket, setiap kunci juga menjalankan paling banyak 10 kueri per menit. Baris per kueri adalah jumlah baris terbanyak yang dikembalikan satu kueri ke klien AI Anda; meminta lebih banyak akan mengembalikan batas paket Anda dan memberi tahu Anda, bukan kesalahan. Hasil yang ditahan disimpan untuk pertanyaan lanjutan hingga waktu dan ukuran paket, sesuai dengan kemampuan komputer Agen. Setiap paket berdampingan: penetapan harga.
Mengapa Kecerdasan Semantik 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 Semantik | 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 Semantic Intelligence sekali saja. Untuk basis data yang besar, batasi jalankan hanya pada tabel yang benar-benar digunakan oleh kueri Anda. Bagaimana cara kerja Kecerdasan Semantik →
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 Kecerdasan Semantik?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 diikuti dengan kueri lanjutan pada thread yang sama. Pada rencana dengan analisis hasil, kueri lanjutan dapat berasal dari hasil yang ditahan, tanpa kueri kedua. 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 dikirim ke Claude dihitung dalam anggaran data realm yang sama dengan penggunaan Excel, Google Sheets, Portal, dan Nova. Melalui MCP, hasil diukur berdasarkan setiap byte yang dikirim ke Claude—hasil, pembacaan skema, dan halaman hasil yang ditahan—sebelum kompresi transportasi apa pun, karena klien AI menerimanya tanpa kompresi; hasil spreadsheet, Portal, dan API dihitung berdasarkan hasil terkompresi yang dikirim oleh Network Agent Anda. Balasan yang gagal tidak pernah dihitung. Ajukan pertanyaan eksploratif dalam skala kecil; pada paket dengan Context management, meminta Claude mengukur ukuran hasil terlebih dahulu (mode: shape) menghindari pengambilan baris yang tidak diperlukan.
- Kecerdasan Semantik 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 mengatakan tidak ada konektor, atau tidak ada Agen Jaringan. | Akun Anda belum memiliki Agen yang berjalan, atau Agen tersebut belum memiliki sumber data yang ditambahkan. | Instal Agen dari my.querystreams.com/download, tambahkan konektor di bawah Data → Agen Data → Tambahkan konektor, lalu tanyakan lagi. |
| 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 (Jalankan kueri). | 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 | Aplikasi yang terhubung tersebut terbatas pada konektor tertentu saat disetujui, dan ini bukan salah satunya. | Hubungkan kembali aplikasi dan setujui akses yang lebih luas di layar persetujuan Query Streams. |
MCP_DATABASE_TIDAK_TERTANGKAP | Basis data tidak termasuk dalam pilihan pengambilan skema konektor, sehingga tidak ada Kecerdasan Semantik atau relasi tersimpan yang dapat dibaca. Kueri tetap berfungsi. | Tambahkan basis data ke pilihan pengambilan data pada konektor di Portal, lalu secara opsional jalankan Kecerdasan Semantik. |
MCP_RATE_LIMITED | Jumlah panggilan per menit terlalu banyak untuk paket Anda. | Tunggu sebentar. Sesi yang padat akan lebih efektif dengan Kecerdasan Semantik, yang memungkinkan Claude menjawab panggilan dalam jumlah 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 diberikan kepada klien AI Anda dalam satu respons. | Minta agar jumlah kolom atau baris dikurangi. Pada paket dengan manajemen konteks, minta agar ukurannya ditentukan terlebih dahulu. |
FITUR MCP TIDAK TERMASUK | “Rencana Anda tidak mencakup manajemen konteks”, analisis hasil, atau analisis mendalam; atau alat tersebut dinonaktifkan untuk kunci atau organisasi ini. | Minta klien AI Anda untuk melanjutkan tanpa fitur tersebut, tingkatkan paket langganan, atau minta administrator untuk mengaktifkan fitur tersebut. |
HASIL MCP_KADALUARSA | Hasil yang ditahan tersebut tidak lagi ditahan: hasilnya telah kedaluwarsa, telah dirilis (kadang-kadang lebih awal, untuk memberi ruang bagi hasil yang lebih baru) atau Agen telah dimulai ulang. | Minta klien AI Anda untuk menjalankan kueri lagi dengan menahannya. |
MCP_WINDOW_BUDGET | Agen tidak dapat menyimpan hasil sebesar itu saat ini, atau tindak lanjut membutuhkan lebih banyak memori daripada yang diizinkan untuk hasil yang disimpan. | Lepaskan hasil yang ditahan, atau persempit kueri dengan filter atau jumlah kolom yang lebih sedikit. |
ANALISIS AGEN MCP DINONAKTIFKAN | Hasil dan analisis yang ditahan dimatikan pada Agen tersebut, atau untuk konektor tersebut. | Minta admin untuk mengaktifkannya Analisis lokal untuk Agen di halaman Agen Data, atau izinkan analisis pada konektor. |
MCP_WINDOW_SQL_DITOLAK | Tindak lanjut tersebut bukanlah perintah SELECT baca saja pada tabel hasil yang disimpan, atau perintah tersebut menyebutkan kolom yang tidak dimiliki oleh hasil tersebut. | Minta satu perintah SELECT pada hasil tersebut, menggunakan nama kolomnya. |
VERSI_AGENT_MCP_TERLALU_LAMA | Agen tersebut perlu diperbarui sebelum dapat membentuk, membuat profil, menyimpan, atau menganalisis hasil. | Perbarui Agen dari Data → Agen DataSementara itu, kueri biasa tetap berfungsi. |
| Kueri gagal karena nama kolom atau tabel | Klien AI Anda menebak nama alih-alih membaca tabel terlebih dahulu. | Biasanya tidak ada. Pesan kesalahan yang diterimanya mencantumkan kolom sebenarnya dalam tabel tersebut, atau tabel dengan nama serupa, sehingga klien dapat memperbaiki kueri pada percobaan berikutnya. Jika terus menebak, minta klien membaca kolom tabel terlebih dahulu. |
| Pelanggaran akses baca saja | SQL tersebut berisi sesuatu selain PILIH, DENGAN atau MENJELASKAN. | Sesuai rancangan. Penulisan tidak pernah diterima melalui MCP. |
Masih bingung? Kirim email [email protected].
Keamanan dan privasi
- Claude menerima metadata skema, deskripsi Kecerdasan Semantik termasuk nilai sampel, dan hasil kueri yang Anda ajukan. Dengan perangkat Analitik, ia sering kali menerima perkiraan ukuran, profil, atau jawaban hasil sementara, dan hasil lengkapnya tetap berada di Agen. Apa yang diterimanya kemudian 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 Semantic 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 menggunakan MCP: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline, dan banyak lagi. Portalnya Hubungkan klien AI Panduan ini memiliki konfigurasi siap pakai untuk masing-masing.
Apa yang dimaksud dengan hasil yang ditahan?
Pada paket dengan analisis hasil, klien AI Anda dapat meminta Agen untuk menyimpan hasil lengkap untuk sementara waktu. Pertanyaan lanjutan, seperti rincian berdasarkan wilayah atau halaman baris berikutnya, kemudian dijawab dari salinan tersebut tanpa kueri basis data kedua. Lamanya dan besarnya ukuran hasil yang disimpan akan bertambah seiring dengan paket yang digunakan.
Paket mana yang mencakup perangkat analitik?
Manajemen konteks dan analisis hasil tersedia pada paket Personal Core ke atas; analisis yang lebih mendalam tersedia pada paket Business Core ke atas. Tabel rencana memiliki detailnya.
Apakah ini mengubah paket gratis?
Tidak. Paket gratis berfungsi seperti biasanya, dengan hasil standar.
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 Semantic 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
Instal Agen sekali saja, hanya beberapa menit. Setelah itu, menghubungkan Claude hanya dengan satu klik: tanpa kunci, tanpa file konfigurasi, tanpa VPN. Dirancang hanya untuk dibaca.
Instal Agen Buka halaman MCP Cara kerja MCP
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish