Hubungkan Folder File CSV ke Claude dengan MCP

MCP · Folder CSV ke Claude

Bertanya Claude tentang file folder CSV Anda, dalam bahasa Inggris sederhana

Hubungkan Claude, Claude Code, Cursor, atau klien MCP apa pun ke Query Streams sekali saja. Claude membaca struktur file Folder CSV Anda, menulis SQL, menjalankannya dalam mode baca saja melalui Agen yang sudah ada dengan data Anda, dan memberikan jawaban berupa baris data. Tidak ada kata sandi basis data yang pernah sampai ke AI. Sekitar sepuluh menit, dan paket Gratis sudah mencakupnya.

Sekitar 10 menit Claude, ChatGPT, Cursor + 11 klien lainnya File tetap di tempatnya Hanya baca, selalu

Inilah hasil akhirnya

A Claude that can answer questions about a folder of CSV files with live, read-only queries over the tables the Agent builds from your files, and tell you which file each answer came from — without ever seeing a login or a file path, and without a firewall change: the Agent already inside your network reads the folder and sends back only the rows. Once the Agent is in place, connecting Claude takes about 90 seconds if you are comfortable with a settings screen. Like this:

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?

Which regions grew the most this month against last month, and did anything drop?

qs_jalankan_kueri qs_jalankan_kueri

Every CSV is already one table, so I summed jumlah oleh wilayah for each month straight from fileset.penjualan. Two read-only queries:

wilayah	This month	Last month	Change
Barat	412,300	348,900	+18%
Tengah	388,120	391,000	−1%
Timur	201,450	262,800	−23%

Barat is up on more orders, not bigger ones. Timur fell 23%, and it is one account: Harbour Foods ordered every week last month and not once this month. Central is flat. Want the East orders by customer?

Hanya PILIH, diperiksa oleh Agen masuk pada tab Aktivitas MCP 6 rows returned across 3 queries

Rather not wire up an AI client at all? On the Business plan, Nova is the assistant built into Query Streams itself. It has every tool Claude gets here, plus the ones Claude does not: it drafts and validates the SQL against your Schema Intelligence model, turns the answer into a chart, and saves the result as a query your team can run from Excel, Google Sheets or the REST API — no key, no connector, nothing to install. Use MCP when your people already live in Claude, Cursor or ChatGPT; use Nova when you want the answers inside the 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. Baru menggunakan Agent 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

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click Menghubungkan. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcp, dan terhubung melalui obrolan. Halaman Query Streams terbuka, Anda memilih organisasi dan izin, lalu klik. Setujui koneksiTidak ada yang perlu disalin, tidak ada yang perlu dirahasiakan. Koneksi tersebut muncul di bawah ini. Aplikasi Terhubung dan dapat dicabut di sana.

   Alat pengembang · sebuah kunci

   Claude Code, Cursor, VS Code dan teman-teman

   Pada Kunci Saya klik Hasilkan kunciBerikan itu Nama kunci seperti “Claude Code di laptop saya”, simpan Membaca dan Menjalankan dicentang, pilih Kedaluwarsa (Tidak pernah, 30 hari, 90 hari, atau 1 tahun) dan klik Hasilkan kunciSalinlah, lalu Lanjutkan instalasi: itu Menghubungkan Tab ini menampilkan cuplikan persis untuk alat Anda dengan kunci yang sudah terisi.

   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.

   Menjalankan

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

   Menganalisa

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

   Kuncinya hilang? Membuka Kunci Saya: ikon mata 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. Membuka Pengaturan → Konektor lalu klik Telusuri konektor. Query Streams is listed in the Anthropic Connectors Directory: find Aliran Kueri lalu klik Menghubungkan. (Or open the directory listing directly and click Menghubungkan there.)
   2. If your organization hides directory connectors, click Tambahkan konektor khusus instead. Name it Aliran Kueri, tempel https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Menambahkan, then in any chat click + → Telusuri konektor → Aliran Kueri → Menghubungkan.
   3. Tab Aliran Kueri terbuka. Masuk jika diminta, pilih organisasi, tinjau. Membaca dan Menjalankan, 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.

   If you do add it by hand in Claude Desktop, use Pengaturan → Konektor → Tambah, bukan di dalam obrolan Tambahkan pasar option, which expects a git repository. Connectors sync to your Claude account, so the mobile apps and Desktop pick it up automatically. Menu names are Anthropic’s and can move.

   Kode Claude kunci

   Satu perintah, dengan kunci Anda dari Kunci Saya:

   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? Itu Menghubungkan tab 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) 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 (Eksekusi). 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). 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, dan pada Kunci Saya kuncinya Terakhir digunakan Waktu diperbarui dalam beberapa detik.

Bagaimana file baru, yang diubah, dan yang dihapus ditampilkan

Apa yang bisa dilakukan Claude setelah terhubung?

Claude melihat sembilan belas alat kecil. Anda tidak pernah menyebutkannya sendiri; Claude memilih yang tepat untuk pertanyaan Anda. Sederhananya:

Mengapa Kecerdasan Skema 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 Schema Intelligence sekali pada basis data tersebut. Nova → Kecerdasan. Itu Kunci Saya Tab tersebut menampilkan panel cakupan per konektor. Bagaimana cara kerja Schema Intelligence?.

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 Claude:

Aplikasi yang terhubung dihitung sebagai kunci. Selain angka per menit, setiap kunci dapat menjalankan paling banyak 10 kueri per menit. Sebuah kueri mengembalikan hingga 1.000 baris dan berjalan hingga 60 detik kecuali Claude meminta lebih banyak, hingga batas maksimal 50.000 baris dan lima menit. Baris yang diterima Claude dihitung terhadap alokasi Data Realm Anda, kumpulan yang sama yang digunakan kueri Excel dan Sheets Anda, dan MCP diukur sebelum kompresi, sehingga hasil yang lebar akan lebih mahal di sini daripada baris yang sama di spreadsheet. Eksekusi Schema Intelligence yang dimulai dari Claude menggunakan kredit Nova AI, sama seperti yang dilakukan dari Portal. Lihat halaman harga. untuk tunjangan.

Menjaganya tetap aman

Langkah selanjutnya yang bagus

• Jalankan Skema Kecerdasan 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