Hubungkan DuckDB ke Claude dengan MCP

DuckDBPaket gratisAliran KueriClaude

Tanyakan tentang file DuckDB Anda kepada Claude dengan bahasa sehari-hari: Agent yang sudah berada di dalam jaringan Anda menjalankan SQL dalam mode hanya-baca, dan kata sandi database tidak pernah sampai ke AI. Sekitar sepuluh menit, dan paket Gratis sudah mencakupnya.

Mulai gratis

Inilah hasil akhirnya

Claude yang dapat menjawab pertanyaan tentang file DuckDB Anda dengan kueri baca-saja langsung, menjelaskan arti kolom, dan menindaklanjuti ketika Anda meminta lebih banyak — tanpa perlu masuk ke basis data, dan tanpa perubahan firewall: Agen yang sudah berada di dalam jaringan Anda menjalankan SQL dan hanya mengirimkan kembali baris data. Setelah Agen terpasang, menghubungkan Claude membutuhkan waktu sekitar 90 detik jika Anda terbiasa dengan layar pengaturan. Seperti ini:

Claude ChatGPT Kursor Kode Claude VS Code Selancar angin Gemini CLI JetBrains Naskah kuno+5 lagiHanya baca

Apa yang ada di dalam pesanan Dalam file DuckDB saya? Tunjukkan beberapa baris dan beri tahu saya arti setiap kolomnya.

qs_get_table_schema qs_jalankan_kueri kecerdasan skema

Saya melihat struktur tabel terlebih dahulu, kemudian menjalankan kueri baca saja melalui Agen Anda. Berikut adalah tiga baris pesanan:

ID pesanan	nama_pelanggan	total pesanan
1042	Pedagang Angin Utara	Seattle
1057	Alpine Outfitters	Denver
1063	Makanan Pelabuhan	Halifax

ID pesanan mengidentifikasi baris tersebut. nama_pelanggan dan total pesanan dijelaskan dalam model Kecerdasan Semantik Anda, sehingga saya dapat memfilternya berdasarkan nama.

Yang mana tiga total pesanan Nilai mana yang menghasilkan pendapatan terbesar pada kuartal ini, dan bagaimana perbandingannya dengan kuartal lalu? Adakah hal yang perlu saya perhatikan?

qs_get_relationships qs_jalankan_kueri qs_jalankan_kueri

Saya bergabung pesanan ke pesanan Berdasarkan hubungan yang ditemukan oleh Semantic Intelligence, kemudian dijalankan satu agregasi untuk setiap kuartal. Kedua kueri tersebut bersifat hanya baca dan masing-masing mengembalikan 3 baris:

total pesanan	Kuartal ini	Kuartal terakhir	Mengubah
Denver	184,200	133,900	+38%
Seattle	171,650	168,400	+2%
Halifax	96,300	129,700	-26%

Denver Intinya adalah: pendapatan naik 38% dengan jumlah pelanggan yang hampir sama, sehingga nilai pesanan rata-rata meningkat. Halifax Turun 26%, dan penurunan tersebut berarti dua pelanggan yang memesan setiap bulan pada kuartal lalu dan sama sekali tidak memesan pada kuartal ini — sebaiknya dihubungi sebelum akhir bulan. Seattle stagnan. Ingin tahu nama kedua akun Halifax tersebut?

Hanya PILIH, diperiksa oleh Agen masuk pada tab Aktivitas MCP 9 baris dikembalikan dari 3 kueri Koneksi yang sama di 14 klien MCP

Lebih baik tidak menghubungkan klien AI sama sekali? Pada rencana bisnis, Nova adalah asisten yang terintegrasi langsung ke dalam Query Streams. Ia menggunakan perangkat alat Agen yang sama seperti yang didapatkan klien AI Anda di sini, ditambah fitur yang tidak dimiliki klien eksternal: ia menyusun dan memvalidasi SQL terhadap model Kecerdasan Semantik Anda, mengubah jawabannya menjadi bagan, dan menyimpan hasilnya sebagai kueri yang dapat dijalankan tim Anda dari Excel, Google Sheets, atau REST API — tanpa kunci, tanpa konektor, tanpa perlu instalasi. Gunakan MCP jika tim Anda sudah terbiasa menggunakan Claude, Cursor, atau ChatGPT; gunakan Nova jika Anda menginginkan jawaban di dalam Portal.

DuckDB menyimpan data Anda dalam sebuah file di komputer yang Anda kendalikan. Claude, di sisi lain, berada di browser atau terminal dan tidak mengetahui apa pun tentangnya. Jembatan yang biasa digunakan adalah menempelkan skema ke dalam obrolan dan berharap berhasil, atau memberikan kata sandi DuckDB Anda ke server MCP sumber terbuka. Query Streams melakukannya dengan cara yang berbeda: Agen yang sudah membaca file DuckDB Anda menjalankan SQL yang ditulis Claude, hanya untuk membaca, dan server MCP di antaranya memeriksa siapa yang bertanya, apa yang mungkin mereka lakukan, dan seberapa sering. Claude mendapatkan jawaban. Ia tidak pernah mendapatkan kredensial.

Yang Anda butuhkan

Akun Query Streams

MCP tersedia di semua paket, termasuk paket Gratis. Paket Gratis hanya mengizinkan satu kunci atau satu aplikasi yang terhubung, yang sudah cukup untuk panduan ini. Daftar di sini. my.querystreams.com.

DuckDB terhubung melalui Agen.

Agen diinstal pada komputer yang menyimpan file DuckDB Anda, atau pada komputer yang membacanya dari berbagi jaringan, dengan koneksi yang ditambahkan di Agen Data. Belum selesai? Hubungkan DuckDB terlebih dahulu; prosesnya memakan waktu sekitar sepuluh menit.

MCP sudah diaktifkan untuk Anda.

Para kreator, pemilik, dan admin memilikinya sejak awal. Semua orang lain membutuhkan admin untuk mengubah pengaturannya. MCP beralih di samping nama mereka di bawah Akun → Kontrol AksesSampai saat itu, halaman MCP menampilkan pesan “MCP dinonaktifkan untuk akun Anda”.

Klien AI

Aplikasi obrolan seperti claude.ai, Claude Desktop, dan ChatGPT terhubung tanpa kunci. Claude Code, Cursor, VS Code, dan sekitar sepuluh alat lainnya menggunakan kunci; Portal Hubungkan klien AI Panduan ini mengatur masing-masingnya.

Siapkan dalam empat langkah

1. Buka MCP di portal.

   Masuk di my.querystreams.com dan terbuka Streaming → Langsung → MCPHalaman ini memiliki empat tab: Koneksi, Konteks, Peralatan dan, untuk admin, AktivitasPeriksa panel Kecerdasan Semantik pada Koneksi Selagi Anda di sini: ini mencantumkan konektor DuckDB Anda dan apakah Semantic Intelligence telah dijalankan padanya. Cakupan lengkap inilah yang memungkinkan Claude menulis SQL DuckDB yang benar pada percobaan pertama.

   Buka MCP

   Melihat pesan “MCP dinonaktifkan untuk akun Anda”? Organisasi Anda memiliki MCP tetapi pengguna Anda dinonaktifkan. Seorang admin mengaktifkannya dengan perintah berikut. MCP saklar di samping nama Anda di bawah Akun → Kontrol AksesPara kreator, pemilik, dan admin terlibat sejak awal.

2. Pilih cara Anda akan terhubung

   Ada dua jalan masuk, dan keduanya berakhir di tempat yang sama:

   Aplikasi obrolan · tanpa kunci

   claude.ai, Claude Desktop, ChatGPT

   Di claude.ai dan Claude Desktop, buka Daftar Aliran Kueri Di Direktori Konektor Anthropic, klik Menghubungkan dan menyetujuinya. Menambahkannya melalui URL, https://mcp.querystreams.com/mcp, adalah solusi alternatifnya. Di ChatGPT, Anda menambahkan Query Streams dari aplikasi (mode pengembang untuk saat ini) dan masuk dengan Query Streams. Dengan cara apa pun, halaman Query Streams akan terbuka: pilih organisasi dan izin, lalu klik Setujui koneksiTidak ada yang perlu disalin. Koneksi muncul di Koneksi tab dan dapat dicabut di sana.

   Alat pengembang · sebuah kunci

   Claude Code, Cursor, VS Code dan teman-teman

   Di halaman MCP, klik Hubungkan klien AIPemandu wisata bertanya Bagaimana klien AI Anda akan terhubung?: memilih Gunakan kunci dalam file konfigurasi, pilih alat Anda, lalu Hasilkan kunci untuk aku ta Nama kunci, Membaca dan Jalankan kueri dicentang, sebuah Kedaluwarsa (Tidak pernah, 30 hari, 90 hari, atau 1 tahun). Siapkan menampilkan cuplikan dengan kunci yang sudah terisi, dan Periksa koneksinya menunggu panggilan pertama.

   Kedua cara tersebut menggunakan tiga izin yang sama, yang dapat Anda pilih di layar persetujuan atau pada kunci:

   Membaca

   Menampilkan daftar konektor, menelusuri tabel dan kolom, membaca kueri tersimpan dan aturan peringatan Anda. Tidak pernah mengembalikan data baris.

   Jalankan kueri

   Jalankan SQL baca-saja dan kueri tersimpan melalui Agen Anda dan kembalikan baris-barisnya. Tanpa itu, klien AI Anda dapat mendeskripsikan data Anda tetapi tidak dapat memberikan jawaban berdasarkan data tersebut.

   Menganalisa

   Membuat profil tabel, menemukan relasi, dan mengantrekan eksekusi Kecerdasan Semantik. Proses ini menggunakan kredit dan kuota data Nova AI, sehingga layar persetujuan tidak pernah mencentangnya terlebih dahulu.

   Kuncinya hilang? Itu terdaftar di Koneksi tab: Ungkapkan kunci lengkapnya menunjukkannya lagi dan Salin kunci lengkap Salin file tersebut. Cabut izinnya di sana jika laptop hilang; setiap klien yang menggunakannya akan gagal pada panggilan berikutnya, dalam waktu sekitar lima menit.

3. Hubungi Claude

   Pilih resep Claude yang Anda gunakan. Alamat servernya sama di mana saja: https://mcp.querystreams.com/mcp.

   Claude di web, Claude Desktop dan seluler tidak ada kunci

   1. Buka Daftar Aliran Kueri di Direktori Konektor Anthropic dan klik MenghubungkanDi Desktop, letaknya kemudian berada di bawah... + → Konektor.
   2. Alternatif ini dapat digunakan jika organisasi Anda menyembunyikan konektor direktori: Pengaturan → Konektor → Tambahkan konektor khusus, nama Aliran Kueri, URL https://mcp.querystreams.com/mcp, kolom OAuth kosong, Menambahkanlalu dalam obrolan + → Aliran Kueri → Menghubungkan.
   3. Tab Aliran Kueri terbuka. Masuk jika diminta, pilih organisasi, tinjau. Membaca dan Jalankan kueri, opsional Batasi pada konektor tertentulalu klik Setujui koneksi.
   4. Kembali ke Claude, Anda melihat "Terhubung ke Aliran Kueri". Pertama kali Claude menggunakan alat, ia akan menanyakan; pilih Selalu izinkan.

   Jika Anda menambahkannya secara manual di Claude Desktop, gunakan Pengaturan → Konektor → Tambah, bukan di dalam obrolan Tambahkan pasar Opsi ini mengharapkan repositori Git. Konektor disinkronkan ke akun Claude Anda, sehingga aplikasi seluler dan desktop akan mengambilnya secara otomatis. Nama menu adalah milik Anthropic dan dapat dipindahkan.

   Kode Claude kunci

   Satu perintah, dengan kunci Anda dari tab Koneksi:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   Itu menuliskan proyek saat ini .mcp.json. Menambahkan --cakupan pengguna Untuk memiliki Query Streams di setiap proyek. Jalankan /mcp di dalam Claude Code untuk melihat keterkaitannya.

   Kursor kunci

   Membuka Pengaturan Kursor → MCP → Tambah Server MCP Baruatau edit .cursor/mcp.json di akar ruang kerja Anda:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   Mulai ulang Kursor atau jalankan MCP: Mulai Ulang Server; A aliran kueri Lencana muncul di bilah status MCP.

   Menggunakan sesuatu yang lain? Portalnya Hubungkan klien AI memandu memiliki resep siap pakai untuk ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev dan JetBrains AI, ditambah Tempel & gabungkan alat yang menjatuhkan aliran kueri entri ke dalam file konfigurasi yang sudah Anda miliki. Klien apa pun yang menggunakan MCP melalui HTTP akan berfungsi: server https://mcp.querystreams.com/mcp, header Kunci X-MCP (sebuah Otorisasi: Pembawa (Header dengan kunci yang sama juga berfungsi).

4. Ajukan pertanyaan pertama Anda

   Mulailah dengan sesuatu yang jawabannya sudah Anda ketahui, sehingga Anda dapat melihat Claude menggunakan alat yang tepat. Tiga alat yang cocok dengan file DuckDB Anda:

   “Data apa saja yang ada di dalam file DuckDB saya?”

   Claude mencantumkan tabel-tabel yang dapat dilihatnya, memberi tahu Anda mana yang memiliki Kecerdasan Semantik, dan menanyakan apa yang ingin Anda lihat.

   “Tunjukkan sepuluh baris dari pesanan dan jelaskan setiap kolomnya.”

   Claude membaca struktur tabel terlebih dahulu (Read), kemudian menjalankan satu perintah SELECT melalui Agent Anda (Run queries) dan menjelaskan arti dari customer_name dan order_total.

   “Berapa banyak baris yang dimiliki pesanan per total pesanan? Total pesanan mana yang memiliki jumlah baris terbanyak?”

   Claude menulis klausa GROUP BY dalam dialek DuckDB, menjalankannya, dan menjawab dalam sebuah kalimat dengan tabel kecil. Lanjutkan percakapan di obrolan yang sama; ini akan mempertahankan konteksnya.

   Untuk memastikan pemasangan kabel, tanyakan “Konektor Query Streams apa saja yang saya miliki?”Claude menelepon konektor_daftar_qs, panduan Portal Periksa koneksinya langkah mengatakan Terhubung, dan kunci atau aplikasi pada Koneksi tab menunjukkan Terakhir digunakan waktu dalam beberapa detik.

Mengakses file di berbagi jaringan.

Agen membuka file sebagai layanan latar belakang, bukan sebagai Anda, jadi file di komputer lain memerlukan satu langkah tambahan. Langkah mana yang diperlukan bergantung pada komputer tempat Agen dijalankan.

Jika pengujian tidak dapat menemukan bagian tersebut, cari kata-kata berikut dalam hasilnya: tidak terjangkau Artinya, komputer Agen tidak menerima jawaban dari server. Pada Linux atau Mac, tidak terpasang Artinya, share tersebut masih perlu dipasang (mounted), dan pesan tersebut menyertakan perintah pemasangan (mount) yang tepat untuk server Anda.

Apa yang bisa dilakukan Claude setelah terhubung?

Klien AI Anda melihat alat Query Streams; ia memilih alat yang tepat untuk pertanyaan Anda. Portal ini Peralatan tab mencantumkan setiap alat dan mode beserta yang termasuk dalam paket Anda. Query Streams meminta klien AI Anda membaca kolom setiap tabel sebelum menjalankan kueri, agar klien menuliskan nama yang sebenarnya, bukan menebak. Pada semua paket, termasuk Free:

Perangkat alat analitik. Pada paket berbayar, Agent melakukan pekerjaan dasar di tempat file DuckDB Anda berada, sehingga klien AI Anda dapat memfokuskan perhatiannya pada proses berpikir. Versi gratis berfungsi seperti biasanya.

Pengaturan default ada di Konteks tab: batas sel teks, tampilan skema, ukuran hasil, pengaturan default analisis, dan hasil yang ditahan.

Mengapa Kecerdasan Semantik Penting di Sini

Setiap jawaban yang diterima Claude diberi label dari mana struktur tersebut berasal, dan Claude menyesuaikan seberapa besar kepercayaannya terhadap apa yang dilihatnya.

Jika basis data penting, jalankan Kecerdasan Semantik pada basis data tersebut sekali saja. Nova → Kecerdasan. Itu Koneksi Tab tersebut menampilkan panel cakupan per konektor. Bagaimana cara kerja Kecerdasan Semantik?.

Apa yang diizinkan oleh rencana tersebut

MCP tersedia di semua paket, termasuk paket Gratis, tanpa biaya tambahan. Yang ditentukan oleh setiap paket adalah berapa banyak tombol atau aplikasi terhubung yang dapat Anda simpan dan berapa banyak panggilan per menit yang dapat dilakukan oleh klien AI Anda:

Aplikasi yang terhubung dihitung sebagai kunci. Selain angka per menit, setiap kunci dapat menjalankan paling banyak 10 kueri per menit. Sebuah kueri berjalan hingga 60 detik kecuali klien AI Anda meminta lebih, hingga lima menit. Rencana Anda juga menentukan berapa banyak baris yang dikembalikan oleh satu kueri dan, dengan perangkat alat Analitik, berapa lama dan seberapa besar hasil yang disimpan; panduan MCP lengkap mencantumkan setiap paket. Apa yang diterima klien AI Anda dihitung dalam kuota Data Realm Anda, kumpulan yang sama dengan yang digunakan kueri Excel dan Sheets: penggunaan AI-agent (MCP) menghitung setiap byte yang dikirimkan ke klien AI Anda, baik hasil, pembacaan skema, maupun halaman hasil yang ditahan, sebelum kompresi transportasi apa pun yang dinegosiasikan oleh klien Anda; sedangkan kueri spreadsheet menghitung hasil terkompresi yang dikirimkan Network Agent Anda. Proses Semantic Intelligence yang dimulai dari klien AI Anda menggunakan kredit Nova AI, persis seperti halnya dari Portal. Lihat halaman harga. untuk tunjangan.

Menjaganya tetap aman

Langkah selanjutnya yang bagus

• Simpan kueri yang Anda anggap kanonik. di Query Builder. Claude akan mencari kueri yang tersimpan terlebih dahulu, jadi "pelanggan aktif" berarti apa yang tim Anda maksudkan.
• Gunakan Proyek Claude dengan Query Streams terpasang dan masukkan aturan internal Anda dalam instruksinya: basis data DuckDB mana yang akan digunakan secara default, dan kueri tersimpan mana yang merupakan definisi resmi.
• Berikan masukan untuk menganalisis jika Anda menginginkan jawaban yang lebih mendalam. Menganalisis profil kolom sebelum memfilternya adalah perbedaan antara menebak kode status dan menggunakan kode yang tepat. Proses ini menggunakan kredit Nova AI, jadi akan nonaktif sampai Anda mengizinkannya.
• Mintalah bagan. claude.ai menggambar grafik dari baris yang diterima Claude.

Ketika sesuatu tidak berfungsi

Pertanyaan yang diajukan orang

Panduan terkait

• Hubungkan Microsoft SQL Server ke Claude dengan MCP.
• Hubungkan PostgreSQL ke Claude dengan MCP
• Hubungkan MySQL ke Claude dengan MCP
• Hubungkan Microsoft Access ke Claude dengan MCP.
• Menghubungkan Query Streams ke Claude melalui MCP: pengaturan, izin, dan pemecahan masalah
• Cara menghubungkan DuckDB ke Google Sheets
• Semua panduan MCP