Hubungkan File CSV Multi-Rekaman ke Claude dengan MCP

MCP · CSV multi-rekaman ke Claude

Bertanya Claude tentang file CSV multi-rekaman Anda, dalam bahasa Inggris sederhana

Hubungkan Claude, Claude Code, Cursor, atau klien MCP apa pun ke Query Streams sekali saja. Claude membaca struktur file CSV multi-record Anda, menulis SQL, menjalankannya dalam mode baca saja melalui Agen yang sudah ada dengan data Anda, dan memberikan jawaban berupa baris-baris data. Tidak ada kata sandi basis data yang pernah sampai ke AI. Prosesnya memakan waktu 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 CSV files that mix several record types 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

Cantumkan header batch dari file minggu ini, dari yang terlama terlebih dahulu.

qs_get_table_schema qs_jalankan_kueri kecerdasan skema

Claude membaca struktur dari fileset.data_hdr dan melihat kolom posisional. Ia menjalankan satu perintah SELECT melalui Agent Anda dan memberi tahu Anda bahwa ia sedang membaca bidang_1 sebagai nomor batch dan bidang_2 sesuai dengan tanggal batch.

berkas sumber	bidang_1	bidang_2
inbound/2026-09-21/batch_0917.csv	B-000917	2026-09-21
inbound/2026-09-23/batch_0918.csv	B-000918	2026-09-23
inbound/2026-09-25/batch_0919.csv	B-000919	2026-09-25

Lanjutkan dengan detail selanjutnya. Claude bergabung. data_hdr ke tabel detail pada berkas sumber dan _seq, di obrolan yang sama.

Total each batch this week from its detail lines and flag any that do not match the header total.

qs_get_relationships qs_jalankan_kueri qs_jalankan_kueri

I joined data_hdr ke data_dtl pada berkas sumber dan _seq, summed bidang_4 on the details and compared it with the header’s bidang_3:

Batch	Header total	Detail total	Match
B-000917	48,210.00	48,210.00	✓
B-000918	51,904.50	51,904.50	✓
B-000919	46,300.00	39,115.25	✗ −7,184.75

B-000919 is short by 7,184.75. Its last detail _seq is 214 while the header says 228 lines, so the file was cut off before the trailer. Worth re-requesting before it is invoiced.

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.

Beberapa sistem menulis file CSV yang mencampur beberapa jenis catatan dalam satu file, seperti baris header, baris detail, dan trailer, yang masing-masing ditandai dengan tag di satu kolom. Konektor CSV multi-catatan memisahkannya sehingga Claude dapat menanyakan setiap jenis catatan sebagai tabelnya sendiri. Tidak ada basis data yang perlu disiapkan. Agen membaca folder di komputernya dan menyimpan baris-baris tersebut sebagai tabel SQL.

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 CSV multi-rekaman 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.

   • Tidak ada Nama tabel kolom. Nama tabel diambil dari tag rekaman.
   • Mengatur Tata letak file, itu Kolom tag catatan (nomor) yang memegang label, dan Pembatas.
   • Memilih Cakupan tabelSecara default, satu tabel diberikan per tag. Satu tabel untuk setiap ekstensi file dan tag. Memisahkan tag yang sama dari berbagai jenis file.
   • Sebelum Anda melakukan konfigurasi, wizard mencatat bahwa semua file yang cocok harus memiliki satu tata letak yang sama. Sinkronisasi pertama akan menggunakan tata letak tersebut dari sampel, dan file yang kemudian tidak sesuai akan disisihkan dan dilaporkan.
   • Pada MemeriksaAgen membaca sampel dan mencantumkan tabel yang akan dibuatnya. File yang akan disisihkan muncul di bawah ini. Tunjukkan file mana dan mengapa..

2. Lihat meja apa yang Anda dapatkan.

   Nama tabel sudah ditentukan untuk Anda, satu per tag catatan, misalnya data_hdr untuk tag HDR. Kolom diberi nomor berdasarkan posisi, bidang_1 ke bidang_N, tanpa kolom tag. Gabungkan tipe rekaman pada berkas sumber dan _seq.

   Meja	Apa yang terkandung di dalamnya
   data_<tag>, Misalnya data_hdr	Setiap baris dengan tag tersebut dari setiap file, sebagai bidang_1 ke bidang_N, ditambah _seq, berkas sumber dan _id_baris.
   data_<ekstensi>_<tag>	Sama halnya, dipisahkan berdasarkan ekstensi file juga, ketika Cakupan tabel adalah Satu tabel untuk setiap ekstensi file dan tag..
   berkas	Semua file yang cocok masih berada di dalam folder, beserta jalur, ukuran, dan waktu modifikasinya.
   file_kejadian	Riwayat perubahan, termasuk baris pergeseran untuk file yang disisihkan karena tag yang tidak dikenal atau jumlah kolom yang salah. Urutkan berdasarkan acara_pada.
   direktori	Jumlah dan ukuran file untuk setiap folder di bawah direktori root.

   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 melihat Claude meraih tabel yang tepat. Tiga cara yang bekerja dengan baik untuk file CSV yang mencampur beberapa tipe data:

   “Berkas mana saja yang tiba di folder hari ini?”

   Claude menanyakan fileset.files untuk relative_path, size_bytes dan modified_utc, yang terbaru terlebih dahulu.

   “Letakkan header setiap file di sebelah trailernya dan tampilkan keduanya.”

   Claude menggabungkan data_hdr dengan tabel trailer Anda berdasarkan _source_file dan _seq dan mengembalikan satu baris per file.

   “Apakah ada berkas yang disisihkan karena tag yang tidak dikenal atau jumlah kolom yang salah?”

   Claude membaca baris pergeseran dalam files_events, event_at terbaru terlebih dahulu, dan menyebutkan nama setiap file beserta alasannya.

   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 jadi Claude mempelajari apa bidang_1 ke bidang_N artinya di setiap tipe record. Tabel file sudah memuat deskripsi bawaan.
• Periksa files_events setelah sinkronisasi pertama untuk file apa pun yang disisihkan untuk tag yang tidak dikenal.
• Baca panduan lengkap CSV multi-rekaman di dalam Meng querying file CSV multi-record dengan SQL untuk setiap pengaturan.

Ketika sesuatu tidak berfungsi

Pertanyaan yang diajukan orang

Panduan terkait

• Hubungkan Folder File CSV ke Claude dengan MCP
• 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
• Panduan konektor multi-rekaman
• Menghubungkan Query Streams ke Claude melalui MCP: pengaturan, izin, dan pemecahan masalah
• Semua panduan MCP