Hubungkan Folder File CSV ke Claude dengan MCP

Folder CSVPaket gratisAliran KueriClaude

CSV Folder → Claude · dengan Query Streams

Dengan Query Streams, tanyakan tentang file CSV Folder Anda kepada Claude dalam bahasa sehari-hari: Agent yang sudah berada di dalam jaringan Anda menjalankan SQL hanya-baca, dan kata sandi database tidak pernah sampai ke AI. Sekitar sepuluh menit, dan paket Free sudah mencakupnya.

Mulai gratis

Inilah hasil akhirnya

Claude yang dapat menjawab pertanyaan tentang folder berisi file CSV dengan kueri baca-saja langsung pada tabel yang dibangun Agen dari file Anda, dan memberi tahu Anda dari file mana setiap jawaban berasal — tanpa perlu melihat login atau jalur file, dan tanpa perubahan firewall: Agen yang sudah berada di dalam jaringan Anda membaca folder dan hanya mengirimkan kembali baris-barisnya. Setelah Agen terpasang, menghubungkan Claude membutuhkan waktu sekitar 90 detik jika Anda terbiasa dengan layar pengaturan. Seperti ini:

Claude · terhubung ke Aliran Kueri Hanya baca

File mana yang menjadi sumber data untuk fileset.sales, dan berapa banyak baris yang ditambahkan oleh masing-masing file?

qs_get_table_schema qs_jalankan_kueri kecerdasan skema

Tiga file CSV sebagai sumber data fileset.penjualanEkspor bulan September adalah yang terbesar, dengan lebih dari 18.000 baris.

berkas sumber	jumlah_baris	id_baris_pertama
ekspor/penjualan_2026_09.csv	18422	ekspor/penjualan_2026_09.csv:0000000
ekspor/penjualan_2026_08.csv	17305	ekspor/penjualan_2026_08.csv:0000000
ekspor/penjualan_2026_07.csv	16988	ekspor/penjualan_2026_07.csv:0000000

Apakah Anda ingin saya menjumlahkan total penjualan per bulan di ketiga file tersebut?

Wilayah mana saja yang mengalami pertumbuhan terbesar bulan ini dibandingkan bulan lalu, dan apakah ada wilayah yang mengalami penurunan?

qs_jalankan_kueri qs_jalankan_kueri

Setiap file CSV sudah merupakan satu tabel, jadi saya menjumlahkannya. jumlah oleh wilayah untuk setiap bulan langsung dari fileset.penjualanDua kueri hanya baca:

wilayah	Bulan ini	Bulan lalu	Mengubah
Barat	412,300	348,900	+18%
Tengah	388,120	391,000	−1%
Timur	201,450	262,800	-23%

Barat Meningkat karena lebih banyak pesanan, bukan pesanan yang lebih besar. Timur Turun 23%, dan itu hanya dari satu akun: Harbour Foods memesan setiap minggu bulan lalu dan tidak sekali pun bulan ini. Wilayah tengah stagnan. Ingin tahu pesanan wilayah timur berdasarkan pelanggan?

Hanya PILIH, diperiksa oleh Agen masuk pada tab Aktivitas MCP 6 baris dikembalikan dari 3 kueri

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.

Itu Folder CSV Kartu ini menggabungkan setiap file CSV dalam sebuah folder ke dalam satu tabel SQL yang dapat diakses Claude, dan menandai setiap baris dengan file asalnya. Anda tidak mengunggah file ke obrolan. Anda cukup mengarahkan Agen ke folder tersebut sekali, Agen akan menyalin baris-baris tersebut ke dalam cache lokal di komputernya, dan menjaga agar tabel tetap mutakhir saat file datang atau berubah.

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.

Agen pada komputer yang dapat membuka folder tersebut

Versi 2.6.0 atau lebih baru. Folder tersebut dapat berada di komputer tersebut atau di berbagi file yang dapat diaksesnya. Agen berjalan sebagai layanan, jadi ketik shares sebagai \\server\share\folder, bukan sebagai huruf drive yang dipetakan. Di Windows, Anda dapat masuk ke share dengan login yang Anda simpan; di Linux atau Mac, pasang share terlebih dahulu (Linux di bawah /mnt atau /media, sebuah Mac di bawah /Jilid). Baru mengenal Agen ini? Instal di Windows, macOS atau Linux.

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

Claude versi web, Claude Desktop, atau aplikasi seluler Claude terhubung tanpa kunci. Claude Code, Cursor, ChatGPT, dan sekitar sepuluh alat lainnya juga berfungsi; Portal memiliki resep siap pakai untuk masing-masing alat tersebut.

Siapkan dalam empat langkah

1. Arahkan Agen ke folder tersebut

   Di portal terbuka Data → Agen DataCari Agen yang dapat membuka folder tersebut dan klik Agen tersebut. Tambahkan konektor tombol. Di bawah Berkas & Folder klik pil Folder CSV kartu. Penyihir kemudian memandu Anda melalui Folder, Memeriksa, Pengaturan, Dunia dan Tinjauan:

   Folder

   Ketik Folder akar, satu per baris, sebagai jalur pada komputer Agen. Pindai subfolder sedang menyala, Kedalaman maksimum adalah 8. Sertakan pola dimulai dengan pola pencocokan yang tepat untuk tipe file ini; tambahkan Kecualikan pola Jika folder tersebut berisi file yang tidak Anda inginkan. Huruf drive yang dipetakan menunjukkan peringatan berwarna kuning: Agen tidak dapat melihatnya, jadi gunakan \\server\share jalur sebagai gantinya.

   Memeriksa

   Agen tersebut membaca sampel hingga 64 file dan menunjukkan apa yang akan dibangun. Belum ada yang dibuat. Siap untuk membuat Artinya, setiap berkas yang diambil sampelnya cocok. Sebuah spanduk berwarna kuning, "{n} dari {m} berkas akan disisihkan", mencantumkan berkas-berkas yang tidak cocok. Tunjukkan file mana dan mengapa.Anda tetap dapat membuat konektor dan memperbaikinya nanti. Jika folder tersebut mencampur tata letak, panel biru akan menawarkan Beralih ke satu tabel per tata letak..

   Pengaturan

   Interval pemindaian (Secara default setiap jam, mulai dari setiap 5 menit hingga harian) adalah seberapa sering Agen mencari file baru, yang diubah, dan yang hilang. Pantau folder untuk perubahan. Bereaksi dalam hitungan detik pada disk lokal. Ketika sebuah file hilang adalah Hilangkan barisnya secara default.

   Alam, Ulasan

   Pilih Data Realm tempat jumlah baris dihitung, periksa ringkasannya, lalu klik. Buat konektorPemindaian pertama dimulai segera; konektornya Tampak Tab tersebut menunjukkan apa yang telah dibangun dan file apa saja yang telah disisihkan.

   • Ketik a Nama tabel, Misalnya penjualanIni wajib dicantumkan pada kartu ini.
   • Sertakan pola dimulai sebagai **/*.csv.
   • Pilih Tata letak tabel. Satu tata letak yang disematkan (default) sesuai untuk ekspor berulang yang semuanya memiliki satu header yang sama. Satu meja per tata letak Map dokumen yang dirakit secara manual, dapat memuat hingga 25 tata letak.
   • Pada MemeriksaAgen akan membaca sampel dan menampilkan jumlah file, perkiraan baris, dan tabel yang akan dibuat. Jika folder tersebut mencampur tata letak, panel biru akan menunjukkannya. Klik Beralih ke satu tabel per tata letak..
   • Sebuah spanduk berwarna kuning menampilkan daftar file yang akan disisihkan. Buka Tunjukkan file mana dan mengapa. untuk memahami alasan di balik masing-masing hal tersebut.

2. Lihat meja apa yang Anda dapatkan.

   Semuanya berada di dalam kumpulan file skema. Tabel data mengambil nama yang Anda ketikkan Nama tabelKolom-kolomnya berasal dari header CSV, ditambah berkas sumber dan _id_baris di setiap baris.

   Meja	Apa yang terkandung di dalamnya
   fileset.penjualan	Dengan Satu tata letak yang disematkan, satu tabel yang diberi nama oleh Anda Nama tabel, yang menyimpan baris-baris dari setiap CSV yang cocok.
   kumpulan file pesanan, kumpulan file.mengembalikan	Dengan Satu meja per tata letak, satu tabel per tata letak, diberi nama sesuai dengan bagian nama file yang sama. orders_2026_01.csv ke orders_2026_03.csv menjadi pesanan.
   kumpulan file.file	Satu baris untuk setiap file CSV yang ada saat ini, beserta jalur, ukuran, dan waktu modifikasinya.
   kumpulan file.file_kejadian	Riwayat perubahan, termasuk melayang baris untuk setiap file yang disisihkan, dengan alasan di detail.

   Setiap konektor folder juga memberi Claude tabel pembukuan yang sama, semuanya dalam satu tempat. kumpulan file skema:

   Meja	Apa yang terkandung di dalamnya
   berkas	Setiap file yang saat ini ada di dalam folder: jalur, nama, ekstensi, ukuran, waktu pembuatan dan modifikasi. Tanyakan "apa yang ada di dalam folder ini?" dan Claude akan membacanya.
   file_kejadian	Riwayat perubahan: satu baris per file yang muncul, dimodifikasi, hilang, atau disisihkan (melayang), dengan waktu di acara_pada dan alasannya detail.
   direktori, volume	Ukuran dan jumlah folder, serta disk atau share tempat root berada.
   berkas sumber, _id_baris	Dua kolom pada setiap baris data: dari file mana baris tersebut berasal, dan ID baris tetap di dalam file tersebut. Kelompokkan berdasarkan berkas sumber untuk membandingkan file.

3. Hubungi Claude

   Membuka Streaming → Langsung → MCPAda 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

   Buat profil tabel, temukan relasi, dan antrekan proses Semantic Intelligence. Pembuatan profil dan penemuan tidak dikenai biaya; proses Semantic Intelligence menggunakan kredit Nova AI dan kuota data, sehingga layar persetujuan tidak pernah mencentangnya secara default.

   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.

   Kemudian 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 dapat Anda periksa dengan membuka folder, sehingga Anda dapat melihat Claude meraih tabel yang tepat. Tiga hal yang cocok untuk folder berisi file CSV:

   “File CSV mana saja yang ada di dalam folder tersebut, dan kapan terakhir kali masing-masing file tersebut diubah?”

   Claude mengajukan pertanyaan kumpulan file.file (Jalankan kueri) dan mencantumkan setiap file dengan ukuran_byte dan UTC yang dimodifikasi, yang terbaru terlebih dahulu.

   “Jumlahkan total kolom jumlah dalam fileset.sales berdasarkan bulan.”

   Claude membaca skema tabel terlebih dahulu untuk menemukan nama kolom yang sebenarnya (Read), kemudian menjalankan perintah DuckDB. KELOMPOKKAN BERDASARKAN Melalui Agen Anda (Jalankan kueri). Anda akan mendapatkan tabel kecil berisi total bulanan.

   “Apakah ada file CSV yang disisihkan, dan mengapa?”

   Claude mengajukan pertanyaan kumpulan file.file_kejadian untuk melayang dan ditolak baris, diurutkan berdasarkan acara_pada (Jalankan kueri). Anda akan mendapatkan setiap file dan alasannya di detail.

   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.

Bagaimana file baru, yang diubah, dan yang dihapus ditampilkan

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, Agen melakukan pekerjaan dasar di tempat file Folder CSV Anda berada, sehingga klien AI Anda dapat memfokuskan perhatiannya pada proses berpikir. Versi gratis berfungsi seperti biasa.

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

• Jalankan Kecerdasan Semantik pada konektor sehingga Claude dapat melihat deskripsi kolom CSV Anda sendiri, bukan hanya tabel file.
• Tambahkan konektor kedua pada folder yang sama. jika juga menyimpan file Parquet atau Excel. Satu konektor hanya membaca satu jenis file.
• Baca panduan Folder CSV pada Gabungkan beberapa file CSV menjadi satu tabel. untuk setiap pengaturan.

Ketika sesuatu tidak berfungsi

Pertanyaan yang diajukan orang

Panduan terkait

• Hubungkan Folder File Excel ke Claude dengan MCP
• Hubungkan Folder Basis Data SQLite ke Claude dengan MCP
• Hubungkan Folder File Parquet ke Claude dengan MCP
• Hubungkan Folder File JSONL ke Claude dengan MCP
• Panduan konektor Folder CSV
• Menghubungkan Query Streams ke Claude melalui MCP: pengaturan, izin, dan pemecahan masalah
• Semua panduan MCP