View Categories

Hubungkan Sistem File Anda ke Claude dengan MCP

Sistem BerkasPaket gratisAliran KueriClaude

File System → Claude · dengan Query Streams

Dengan Query Streams, tanyakan tentang file File System 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
Ilustrasi isometrik rak-rak database, dengan agent membawa kartu di atas troli menuju panel chat di meja
Mengalami kesulitan di suatu titik? Tanyakan saja pada kami. Membuka Dukungan Di Query Streams (menu kanan atas → Dukungan) dan kirimkan pesan kepada kami. Ada orang sungguhan yang membacanya, dan "Saya tidak tahu apa yang diminta layar ini" adalah pertanyaan yang sangat wajar.

Inilah hasil akhirnya

Ikon Sistem BerkasClaude yang dapat menjawab pertanyaan tentang file dan folder di komputer atau berbagi file Anda dengan kueri langsung dan hanya baca pada tabel yang dibangun Agen dari file Anda, dan memberi tahu Anda dari file mana setiap jawaban berasal — tanpa pernah 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:

Nova, asisten Query Streams

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 Sistem Berkas Kartu ini mengubah folder di komputer atau berbagi file Anda menjadi tabel SQL yang mendeskripsikan file Anda: setiap nama, jalur, ukuran, dan tanggal, ditambah riwayat perubahan dan ukuran folder. Kartu ini hanya mengindeks metadata file dan tidak membaca isi file, jadi ini bukan pembaca file seperti server sistem file referensi Anthropic, dan Claude tidak dapat membuka, mengubah, atau menghapus file melaluinya. Anda mengarahkan Agen ke folder, bukan ke server basis data, dan Agen akan membangun dan memperbarui tabel secara otomatis.

DI MANA BERKAS-BERKAS ITU TERSIMPANkomputer atau berbagi file yang dapat dibuka oleh Agen.Folder Andadari fileberkas tetap berada di tempatnyaAgen Aliran KueriMemindai folder, membuat tabeldi dalam cache lokal, menjalankan SQL.Hanya PILIH, diberlakukan di siniAliran KueriServer MCPMemeriksa kunci, izin, dan batasan laju · Mencatat setiap panggilanDI MANA ANDA BERTANYAclaude.ai, Claude Desktop, Claude Code, Kursor, ChatGPTKlien AI Andamemegang kunci atau koneksi, bukan file Anda.
Claude tidak pernah membuka file Anda. Agen membaca folder di komputernya sendiri, menyimpan baris-baris tersebut dalam cache lokal, dan menjalankan SQL yang ditulis Claude di sana. Hanya baris-baris yang dibutuhkan oleh sebuah pertanyaan yang dikirim kembali melalui Query Streams.

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.

Di mana pekerjaan itu dilakukan? Pada komputer yang menjalankan Agen, komputer tersebut memindai folder, menyalin baris ke dalam cache lokal di sana, dan menjalankan SQL yang ditulis Claude terhadap cache tersebut. File-file itu sendiri tidak pernah meninggalkan komputer tersebut, dan begitu pula hal-hal yang tidak diminta oleh Claude.

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 Sistem Berkas 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 bidang. Sistem File hanya membangun tabel inventaris.
    • Letakkan satu folder per baris di Folder akarJalur-jalur tersebut ada di komputer Agen. Ketikkan nama folder bersama sebagai \\server\share\folder, bukan sebagai huruf drive yang dipetakan seperti Z:, karena Agen berjalan sebagai layanan dan tidak dapat melihat drive yang dipetakan pada saat Anda masuk.
    • Sertakan pola dimulai sebagai **/*.csvTambahkan pola untuk setiap jenis file yang ingin Anda cantumkan, dan gunakan Kecualikan pola untuk hal-hal yang ingin Anda hilangkan.
    • Pada MemeriksaAgen tersebut membaca sampel dan menunjukkan berapa banyak folder yang dapat diakses, berapa banyak file yang cocok, dan total ukurannya. Belum ada yang dibuat.
  2. Lihat meja apa yang Anda dapatkan.

    Sistem berkas tidak memiliki tabel data. Semuanya berada dalam satu skema yang disebut kumpulan file, yang disimpan oleh Agen di komputernya dan diperbarui setiap kali melakukan pemindaian. Claude melihat deskripsi bawaan untuk setiap tabel ini tanpa menjalankan Kecerdasan Semantik.

    MejaApa yang terkandung di dalamnya
    kumpulan file.fileSatu baris per berkas yang ada sekarang: jalur relatif, nama, perpanjangan, ukuran_byte, dibuat_utc, UTC yang dimodifikasi dan pemilik (Hanya untuk Windows).
    kumpulan file.file_kejadianRiwayat perubahan. Setiap baris memiliki jenis_acara seperti muncul, dimodifikasi, atau menghilang, waktu dalam acara_pada, dan ukuran sebelumnya.
    fileset.direktoriSatu baris per folder dengan jumlah file, subpohon_byte, file terlama dan terbaru, dan sebuah lewati_alasan ketika sebuah folder tidak terbaca.
    fileset.directory_snapshotsPaling banyak satu snapshot ukuran per folder per hari, sehingga Anda dapat melihat folder mana yang mengalami pertumbuhan.
    kumpulan file.volumeKapasitas dan ruang kosong setiap drive, dengan kapasitas_byte dan byte bebas.

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

    MejaApa yang terkandung di dalamnya
    berkasSetiap 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_kejadianRiwayat perubahan: satu baris per file yang muncul, dimodifikasi, hilang, atau disisihkan (melayang), dengan waktu di acara_pada dan alasannya detail.
    direktori, volumeUkuran dan jumlah folder, serta disk atau share tempat root berada.
    berkas sumber, _id_barisDua 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 meja sebelah kanan. Tiga hal yang berfungsi dengan baik dengan file dan folder di komputer atau berbagi file Anda:

    “Jenis file apa saja yang ada di dalam folder ini, dan berapa banyak ruang yang dibutuhkan oleh setiap jenis file?”
    Claude membaca kumpulan file.file skema (Baca), kemudian menjalankan satu kueri yang mengelompokkan berdasarkan perpanjangan dan jumlahnya ukuran_byte (Jalankan kueri). Anda akan mendapatkan jumlah dan ukuran total per jenis file.
    “Folder mana yang paling besar, dan folder mana yang terlewatkan?”
    Claude mengajukan pertanyaan fileset.direktori (Jalankan kueri), urutkan berdasarkan subpohon_byte dan mencantumkan folder apa pun yang memiliki lewati_alasan, seperti yang terjadi di masa lalu Kedalaman maksimum.
    “Apa yang dihapus dari share dalam tujuh hari terakhir?”
    Claude mengajukan pertanyaan kumpulan file.file_kejadian untuk baris yang hilang, difilter dan diurutkan berdasarkan acara_pada (Jalankan kueri). Anda akan mendapatkan setiap file yang hilang dan kapan pemindaian mendeteksinya.

    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.

Itu saja. Seret file baru ke dalam folder dan, setelah pemindaian berikutnya, Claude dapat menjawab dari file tersebut. File-file tersebut tidak pernah meninggalkan komputer tempatnya berada, dan tidak ada yang mengetikkan kata sandi ke dalam AI.

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.

Windows

Ketik jalur jaringan, seperti \\server\share\folder, tidak pernah berupa huruf drive yang dipetakan seperti S:, yang tidak dapat dilihat oleh Agen. Jika berbagi hanya mengizinkan orang-orang yang namanya tercantum, klik Identitas layanan (chip di bawah jalur, atau folder) Mandat kolom) dan menyimpan informasi login untuk server tersebut: akun domain perusahaan, atau akun yang dibuat di server itu sendiri dengan Domain dibiarkan kosong. Agen kemudian masuk ke server tersebut dan membaca file di sana, dan setiap konektor pada Agen tersebut yang membaca server yang sama harus menggunakan login yang sama. Tanpa login, ia membaca sebagai akun layanannya sendiri, yang oleh domain perusahaan dilihat sebagai komputer itu sendiri. Langkah demi langkah di Windows

Linux

Informasi login yang tersimpan di Portal tidak digunakan di Linux: administrator memasang share tersebut terlebih dahulu di komputer Agen, di dalam folder di bawah /mnt atau /media, karena layanan Agen tidak dapat melihat /rumah atau /jalankan/penggunaDi dalam konektor, simpan \\server\share jalur, yang dipetakan oleh Agen ke dudukan, atau ketik jalur dudukan sebagai gantinya, misalnya /mnt/fileserver-shared/Akun. Cara memasang share di Linux

Mac

Informasi login yang tersimpan di Portal tidak digunakan di Mac: pasang share terlebih dahulu dari Terminal dengan sudo, di dalam folder di bawah /Jilid, sehingga layanan latar belakang Agen dapat melihatnya. Di konektor, pertahankan \\server\share jalur, yang dipetakan oleh Agen ke dudukan, atau ketik jalur dudukan sebagai gantinya, misalnya /Volume/fileserver-shared/Akun. Cara memasang share di Mac

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.

Folder di dalam sebuah share? Di Windows, satu login mencakup semua folder yang Anda tambahkan dari server yang sama. Pantau folder untuk perubahan. Berfungsi juga pada folder bersama, dengan upaya terbaik; pemindaian terjadwal adalah yang menjamin setiap perubahan terdeteksi.

Bagaimana file baru, yang diubah, dan yang dihapus ditampilkan

Berkas baru dan yang diubah

Pada setiap Interval pemindaian Agen membandingkan ukuran dan waktu modifikasi setiap file dengan buku besarnya. File baru yang sesuai ditambahkan; file yang diubah dibaca ulang secara keseluruhan, sehingga sebuah tabel tidak pernah menyimpan dua versi dari satu file. Aktifkan Pantau folder untuk perubahan. untuk bereaksi dalam hitungan detik pada disk lokal.

File yang dihapus

Berkas yang hilang akan menghapus baris-barisnya, kecuali jika Anda memilih demikian. Pertahankan baris, tandai sebagai terhapus.Jika sebuah share offline dan sebagian besar file hilang sekaligus, Agent akan menyimpan inventaris terakhir yang masih berfungsi dengan baik, bukan menghapus semuanya.

File yang disisihkan

Berkas yang tidak sesuai dengan tata letak, tidak dapat dibuka, atau terkunci akan disisihkan: tidak ada barisnya yang dimuat, dan file_kejadian Merekam file mana yang dipindai dan mengapa. Pemindaian akan dicoba ulang secara otomatis saat terjadi perubahan berikutnya. Tidak ada tombol Pindai Ulang.

Apa yang dilihat Claude

Data per pemindaian terakhir. Tidak ada alat MCP yang memicu pemindaian, jadi tanyakan "kapan terakhir kali ini diperbarui?" dan Claude akan membacakan data terbaru. acara_pada di dalam file_kejadian untukmu.

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:

Petakan data Anda

Konektor, basis data, dan Agen; tabel dan kolom file Sistem File Anda beserta deskripsi, nilai contoh, dan penggabungan setelah Kecerdasan Semantik dijalankan.

Profil dan jelajahi

Buat profil kolom sebelum memfilter berdasarkan kolom tersebut; temukan join yang tidak pernah dideklarasikan. Proses langsung memerlukan Analyze.

Jalankan SQL hanya baca

Sebuah perintah SELECT dalam dialek yang tepat untuk Sistem Berkas, 60 detik secara default dan maksimal lima menit. Rencana Anda menentukan jumlah baris terbanyak yang dikembalikan oleh satu kueri. (Jalankan kueri)

Kueri tersimpan, terfederasi, dan peringatan

Jalankan kueri tersimpan yang dipercaya tim Anda dengan nilai-nilai baru; kueri terfederasi akan kembali dalam keadaan sudah digabungkan. Baca aturan peringatan dan buat draf satu sebagai uji coba.

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

Manajemen konteks

Inti Pribadi dan seterusnya

Periksa ukuran hasil sebelum membacanya (membentuk), menelusuri basis data besar area demi area (tingkat), dan batasi jawaban dalam anggaran token hanya dengan kolom dan panjang sel yang dibutuhkannya.

Analisis hasil

Inti Pribadi dan seterusnya

A profil dari keseluruhan hasil, bukan per baris. Hasil yang dipertahankan dengan label, jawabankan pertanyaan lanjutan dan kelompokkan berdasarkan total tanpa kueri kedua. Kesegaran data dan berubah sejak Bacalah hanya yang terbaru.

Analisis lebih mendalam

Inti Bisnis dan seterusnya

Sebuah data kualitas laporan, anomali, segmen, statistik membandingkan dan sebuah perbedaan di antara dua hasil yang telah ditentukan.

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

Nama-nama alat tersebut, jika Anda ingin mengenalinya dalam balasan klien AI Anda.
IzinPeralatan
Membacaqs_daftar_organisasi qs_list_agents konektor_daftar_qs qs_get_si_status qs_get_connector_schema qs_find_tables qs_get_table_schema qs_get_relationships tabel_profil_qs qs_temukan_hubungan qs_list_saved_queries qs_alerts qs_result (op=windows)
Menganalisaqs_request_si_analysis qs_setup_si qs_get_task_status, hanya tercantum untuk kunci dengan Analyze; proses langsung dari tabel_profil_qs dan qs_temukan_hubungan
Jalankan kueriqs_jalankan_kueri qs_run_saved_query kesegaran_data_qs qs_result (op lainnya) rilis_hasil_qs qs_create_alert_rule (hanya mengajukan usulan)

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.

TingkatApa yang dilihat ClaudeHasil
Kecerdasan SemantikDeskripsi untuk setiap tabel dan kolom, nilai contoh, arti enum, gabungan yang dideklarasikan dan ditemukan.Claude menulis SQL Sistem File yang tepat sejak pertama kali dan menjelaskan data tersebut dalam istilah bisnis Anda.
Skema yang diambilNama tabel dan kolom, tipe, kunci.Claude bekerja, tetapi ia menyimpulkan makna dari nama-nama dan mungkin mengajukan pertanyaan lanjutan.
Skema langsungBasis data berada di luar pilihan pengambilan data konektor, sehingga struktur dibaca secara langsung pada setiap permintaan (membutuhkan izin Jalankan kueri; SQL Server, MySQL, dan PostgreSQL).Kueri masih berjalan. Claude melakukan eksplorasi dengan select kecil ketika dibutuhkan lebih banyak.

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:

RencanaKunci per penggunaKunci per organisasiPanggilan per menit
Gratis1130
Inti Pribadi1160
Personal Plus1190
Inti Bisnis23120
Bisnis Plus35150
Bisnis Max510240
Inti Perusahaan525300
Perusahaan Plus850450
Enterprise Max10100600

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

Hanya baca, diperiksa oleh Agen

Hanya pernyataan SELECT yang dijalankan. Pemeriksaan terjadi pada komputer yang menjalankan Agen, sebelum file Sistem File Anda melihat SQL, sehingga tidak ada yang ditulis oleh klien AI Anda yang dapat mengubah data.

Tidak ada kredensial di AI.

Login Sistem Berkas tetap ada di Agen. Claude memegang kunci atau koneksi Query Streams, yang dapat Anda cabut dari halaman MCP; perubahan tersebut akan berlaku dalam waktu sekitar lima menit.

Semua hal tercatat.

Setiap panggilan alat akan muncul di MCP. Aktivitas tab dan setiap kueri dalam Riwayat Kueri sebagai tipe klien MCP, dikaitkan dengan orang yang kunci atau koneksinya membuatnya. Teks SQL dan kunci itu sendiri tidak pernah ditulis ke log aktivitas.

Apa yang diterima oleh penyedia AI?

Nama tabel dan kolom, deskripsi Kecerdasan Semantik termasuk nilai sampel, dan baris kueri yang Anda minta. Dengan perangkat Analitik, seringkali hanya mendapatkan perkiraan ukuran, profil, atau jawaban hasil sementara, dan hasil lengkap tetap berada di Agen. Apa yang didapatkannya akan dikirim ke penyedia AI yang Anda hubungkan, sesuai dengan ketentuan mereka. Query Streams tidak pernah melihat obrolan Anda.

Langkah selanjutnya yang bagus

  • Aktifkan fitur "Pantau folder untuk perubahan" Jika Anda ingin file baru muncul dalam hitungan detik di disk lokal.
  • Tanyakan seberapa baru data tersebut. Claude menjawab dari yang terbaru terakhir_terlihat_utc di dalam file_saat ini dan yang terbaru acara_pada di dalam file_kejadian.
  • Baca panduan Sistem Berkas selengkapnya pada Mengindeks sistem file dan melakukan kueri menggunakan SQL. untuk setiap pengaturan.

Ketika sesuatu tidak berfungsi

Apa yang Anda lihatApa artinyaMemperbaiki
Klien AI Anda tidak menampilkan alat Query Streams.Konektor ditambahkan tetapi tidak pernah dihubungkan, atau kuncinya ditempelkan di tempat yang salah.Dalam diri Claude: + → Aliran Kueri → MenghubungkanDi alat pengembang: mulai ulang, lalu gunakan Periksa koneksinya dalam panduan Portal.
MCP_KEY_REQUIRED atau 401Kunci tidak sampai ke server, biasanya karena baris baru yang tidak sengaja muncul akibat salin tempel atau kunci yang berada di header yang salah.Salin kunci lagi dari tab Koneksi dan kirimkan. Kunci X-MCP Judul.
MCP_USER_DISABLEDSeorang admin telah menonaktifkan MCP untuk pengguna Anda.Minta mereka untuk membalikkan MCP nyalakan kembali di bawah Akun → Kontrol Akses.
MCP_SCOPE_REQUIRED atau MCP_SCOPE_DENIEDKunci atau koneksi tersebut tidak memiliki izin untuk tindakan tersebut, biasanya menjalankan kueri.Edit kunci pada tab Koneksi dan centang Jalankan kueriatau sambungkan kembali aplikasi dan setujui.
MCP_KEY_ORG_LIMIT_EXCEEDEDBatas kunci pada paket Anda telah habis. Pada paket Gratis, batasnya adalah satu kunci atau satu aplikasi yang terhubung.Batalkan langganan yang tidak lagi Anda gunakan, atau tingkatkan paket langganan Anda.
AGEN MCP TIDAK TERHUBUNG atau AGEN MCP TIDAK TERDAFTARAgen yang memiliki file Sistem File Anda saat ini tidak terhubung.Membuka Data → Agen Data dan jalankan Agen di komputernya.
MCP_DATABASE_TIDAK_TERTANGKAPBasis data berada di luar pilihan tangkapan konektor, sehingga tidak ada skema tersimpan atau Kecerdasan Semantik untuknya. Kueri tetap berfungsi.Tambahkan ke pilihan tangkapan pada konektor, lalu jalankan Kecerdasan Semantik jika Anda menginginkan jawaban yang lebih kaya.
MCP_RATE_LIMITEDTerlalu banyak panggilan per menit untuk paket Anda, atau lebih dari 10 eksekusi kueri per menit pada satu kata kunci.Tunggu sebentar. Kecerdasan Semantik memungkinkan Claude menjawab dalam jumlah panggilan yang lebih sedikit.
MCP_QUERY_TIMEOUT atau MCP_OUTPUT_TERLALU_BESARPermintaan tersebut berjalan melebihi batas waktu atau mengembalikan lebih banyak data daripada yang dapat diterima oleh klien AI Anda dalam satu balasan.Minta jumlah baris atau kolom yang lebih sedikit, atau filter tanggal. Pada paket dengan manajemen Konteks, minta agar hasilnya diubah ukurannya terlebih dahulu.
MCP_DATA_REALM_KELELAHANKuota data organisasi Anda untuk periode ini telah habis.Tunggu hingga kuota direset atau isi ulang melalui Portal.
FITUR MCP TIDAK TERMASUKPaket 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_KADALUARSAHasil yang ditahan tersebut tidak lagi ditahan: hasilnya telah kedaluwarsa, dilepaskan (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_BUDGETAgen tersebut tidak dapat menyimpan hasil sebesar itu saat ini, atau tindak lanjut membutuhkan lebih banyak memori daripada yang diizinkannya.Lepaskan hasil yang ditahan, atau persempit kueri dengan filter atau jumlah kolom yang lebih sedikit.
ANALISIS AGEN MCP DINONAKTIFKANHasil dan analisis yang ditahan dimatikan pada Agen atau konektor tersebut.Minta admin untuk mengaktifkannya Analisis lokal di halaman Agen Data, atau izinkan analisis pada konektor.
MCP_WINDOW_SQL_DITOLAKTindak lanjut bukanlah perintah SELECT baca saja atas hasil yang ditahan, atau menyebutkan kolom yang tidak dimiliki oleh hasil tersebut.Minta satu perintah SELECT pada hasil tersebut, menggunakan nama kolomnya.
VERSI_AGENT_MCP_TERLALU_LAMAAgen tersebut perlu diperbarui sebelum dapat membentuk, membuat profil, menyimpan, atau menganalisis hasil.Perbarui Agen dari Data → Agen DataSementara itu, kueri biasa tetap berfungsi.
Pelanggaran akses baca sajaSQL tersebut bukan perintah SELECT.Sesuai rancangan. Tidak ada yang dapat menulis melalui MCP.

Pertanyaan yang diajukan orang

Apakah konektor Sistem Berkas membaca isi berkas saya?

Tidak. Program ini merekam jalur, nama, ukuran, tanggal, dan riwayat perubahan setiap file. Isi file tidak dibaca. Untuk menanyakan baris di dalam file CSV, Parquet, Excel, atau SQLite, tambahkan kartu folder yang sesuai pada folder yang sama.

Seberapa cepat Claude melihat file baru atau file yang dihapus?

Setelah pemindaian berikutnya, Agen memeriksa folder tersebut. Interval pemindaian, setiap jam secara default. Pantau folder untuk perubahan (hampir secara real-time) Bereaksi dalam hitungan detik pada disk lokal dan berupaya sebaik mungkin pada berbagi jaringan. Claude menjawab dari pemindaian terakhir dan tidak dapat memulai pemindaian baru.

Bisakah saya mengindeks folder bersama jaringan atau folder OneDrive yang disinkronkan?

Ya. Pada Windows Agent, ketikkan share tersebut sebagai \\server\share\folderJika hanya mengizinkan masuk orang-orang yang memiliki nama, klik Identitas layanan di dalam folder Mandat kolom dan menyimpan informasi login untuk server tersebut (langkah demi langkahPada Linux atau Mac, login yang tersimpan di Portal tidak digunakan: pasang share terlebih dahulu, di bawah /mnt atau /media pada Linux (Bagaimana) atau di bawah /Volumes di Mac (BagaimanaFolder yang disinkronkan akan berfungsi jika file-file di dalamnya tersimpan di komputer, jadi aturlah agar Selalu aktifkan perangkat ini..

Apakah Claude membaca berkas saya?

Tidak. Agen membaca data tersebut di komputernya sendiri dan menyimpan baris-baris tersebut dalam cache lokal di sana. Claude mengirimkan SQL ke Query Streams, Agen menjalankannya terhadap cache tersebut, dan hanya baris-baris yang dibutuhkan oleh pertanyaan yang dikirim kembali. Claude tidak pernah membuka file dan tidak dapat mengubah, memindahkan, atau menghapus file tersebut.

Apakah saya perlu membuka port atau menjalankan VPN?

Tidak. Agen membuat satu koneksi keluar pada port 443 dan baik permintaan maupun baris data dikirim melalui koneksi tersebut. Jika HTTPS keluar berfungsi, maka ini juga berfungsi.

Apakah folder tersebut dapat berada di jaringan bersama, atau di OneDrive atau Dropbox?

Sebuah share akan berfungsi selama komputer Agen dapat membukanya; ketikkan sebagai \\server\share\folderKarena Agent berjalan sebagai layanan dan tidak dapat melihat drive yang dipetakan di login Anda. Di Windows, tambahkan login share dari folder tersebut. Mandat Kolom ini menunjukkan apakah share hanya mengizinkan akses bagi orang-orang yang bernama; di Linux atau Mac, pasang share terlebih dahulu (login yang tersimpan tidak digunakan di sana). Untuk folder cloud yang disinkronkan, atur agar menyimpan file di perangkat ini; Agent akan melewati file placeholder cloud.

Apakah paket gratis benar-benar mencakup hal ini?

Ya. Gratis adalah paket yang dapat Anda pertahankan, bukan uji coba yang akan berakhir. MCP termasuk dalam setiap paket; Gratis memungkinkan satu kunci atau satu aplikasi yang terhubung dan 30 panggilan per menit. Konektor folder tidak memiliki batasan ukuran file sendiri. Lihat secara detail apa saja yang termasuk dalam paket Gratis di sini. halaman harga.

Selain Claude, alat AI apa saja yang berfungsi?

Apa pun yang menggunakan MCP melalui HTTP: ChatGPT, Cursor, VS Code dengan Copilot, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev, dan JetBrains AI semuanya memiliki resep siap pakai dalam panduan Menghubungkan klien AI di Portal.

Masih bingung? Membuka Dukungan Di Query Streams, beri tahu kami Anda berada di langkah mana dan apa yang Anda lihat. Kami akan menghubungkan Anda.

Setiap panduan untuk File System

Apakah pengaturan Anda kurang tepat?

Mengalami masalah saat pengaturan?

  • Agen mengatakan file atau folder tidak ada, atau akses ditolak? Drive yang dipetakan, berbagi jaringan, OneDrive, dan folder beranda Linux masing-masing membutuhkan satu perbaikan → Di mana Agen dapat membaca file dari
  • Agen menunjukkan Offline, atau Uji koneksi dan Jelajahi berwarna abu-abu? Periksa apakah Agen sedang online → Apakah agennya sedang online?
Updated on November 9, 2026

Powered by BetterDocs