Bertanya Claude tentang file Log Kustom Anda, dalam bahasa Inggris sederhana
Hubungkan Claude, Claude Code, Cursor, atau klien MCP apa pun ke Query Streams sekali saja. Claude membaca struktur file Log Kustom Anda, menulis SQL, menjalankannya hanya baca 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.
Inilah hasil akhirnya
A Claude that can answer questions about any text log you describe 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:
Kesalahan apa saja yang tercatat dalam log proses pencadangan semalam?
Konektor ini memiliki format dengan Cap waktu didefinisikan. Claude membaca kolom-kolom kumpulan file.kejadianlalu menjalankan satu kueri untuk pesan ERROR dan WARN antara tengah malam dan pukul 6 pagi, diurutkan berdasarkan waktu_acara:
| waktu_acara | nama_file | pesan |
|---|---|---|
| 2026-09-26 02:14:07 | cadangan.log | ERROR penyalinan gagal: akses ditolak pada /mnt/nas01/archive |
| 2026-09-26 02:15:09 | cadangan.log | PERINGATAN mencoba lagi dalam 60 detik (percobaan ke-2 dari 3) |
| 2026-09-26 02:17:11 | cadangan.log | ERROR menyerah setelah 3 kali percobaan |
Proses tersebut kehilangan akses ke arsip bersama pada pukul 02:14 dan berhenti tiga menit kemudian. Tanyakan pada Claude berapa banyak malam bulan ini yang berakhir dengan cara yang sama. Jawabannya mencakup apa yang telah dibaca Agen pada pemindaian terakhirnya.
How often does the backup job fail, and is it the same problem every time?
I took each night’s run from kumpulan file.kejadian, matched the start and finish lines, and pulled the failing path out of any ERROR line:
| Night | Hasil | Failing path | Duration |
|---|---|---|---|
| 25 Sep | OKE | - | 1 h 42 m |
| 26 Sep | FAILED | /mnt/nas01/archive | 0 h 09 m |
| 27 Sep | FAILED | /mnt/nas01/archive | 0 h 08 m |
Two nights running, same path, and it aborts nine minutes in with access denied rather than running out of space. Something changed the permissions on the NAS archive share on the 26th. Until it is fixed you have no backup newer than the 25th.
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.
Folder Log Kustom digunakan untuk log teks apa pun yang tidak dikenali oleh kartu bawaan. Anda cukup mendeskripsikan formatnya sekali, atau membiarkan Nova menyarankan format, dan setiap baris akan menjadi baris SQL yang dapat diakses Claude. Ini adalah analisis log AI pada file Anda sendiri, tanpa perlu mengunggah apa pun. Agen memantau setiap file saat ukurannya bertambah, mengenali file yang dirotasi sehingga tidak ada yang dibaca dua kali, dan membaca setiap baris. .gz Mengarsipkan data sekali, dan mengisi kembali data 30 hari terakhir pada saat pembacaan pertama.
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.
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
-
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 Log Kustom 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\sharejalur 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.
- Tambahkan folder log Anda di bawah ini Folder akar dan mengatur Sertakan pola untuk mencocokkan file Anda.
- Pilih sebuah PengkodeanIni wajib dan tidak memiliki nilai default.
- Jelaskan formatnya: Batas rekor, Tata bahasa (dipisahkan, key=value, grok, baris JSON, header #Fields atau lebar tetap), Cap waktu, Kolom yang diketik dan Kolom identitasAtau klik Biarkan Nova menyarankan formatnya., yang memiliki batasan harian.
- Pada MemeriksaAgen tersebut membaca sampel dan menampilkan jumlah file, ukuran, perkiraan baris, dan tabel yang akan dibuat. Belum ada yang dibuat. Uji koneksi juga menawarkan jenis kayu bakar bawaan yang paling mendekati jika sesuai.
-
Lihat meja apa yang Anda dapatkan.
Baris yang diuraikan mendarat di
kumpulan file.kejadian, atau di dalam Nama tabel Anda yang memilih. Agen menyimpan baris-baris tersebut dalam cache lokal di komputer Agen dan menyajikannya sebagai SQL. Setiap baris menunjukkan dari file mana asalnya.berkas sumberSampai Anda menentukan format, setiap baris adalah satu baris saja.pesanditandai dengannama_file.Meja Apa yang terkandung di dalamnya acaraSatu baris per catatan: waktu_acara, kolom-kolom yang ditentukan oleh format Anda, danpesan. Belum ada formatnya,waktu_acaraadalah waktu modifikasi file.baris_mentah_peristiwaBaris yang formatnya tidak sesuai, tetap dipertahankan. garisdenganalasansepertitidak ada kecocokan tata bahasaTidak ada yang terjatuh.berkasSemua file log di folder saat ini, dengan jalur relatif,ukuran_bytedanUTC yang dimodifikasi.file_kejadianRiwayat setiap file: muncul,dimodifikasi,diputar,terpotongdanmelayangbaris, diatur waktunya olehacara_pada.kursor_logPosisi baca dan status setiap berkas. Berkas yang disisihkan menunjukkan status. diparkirdengan alasan dikesalahan terakhir.Setiap konektor folder juga memberi Claude tabel pembukuan yang sama, semuanya dalam satu tempat.
kumpulan fileskema:Meja Apa 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 diacara_padadan alasannyadetail.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 sumberuntuk membandingkan file. -
Hubungi Claude
Membuka Streaming → Langsung → MCPAda dua jalan masuk, dan keduanya berakhir di tempat yang sama:
Aplikasi obrolan · tanpa kunciclaude.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 kunciClaude 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
- 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.)
- 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. - Tab Aliran Kueri terbuka. Masuk jika diminta, pilih organisasi, tinjau. Membaca dan Menjalankan, opsional Batasi pada konektor tertentulalu klik Setujui koneksi.
- 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:
Terminalclaude 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 penggunaUntuk memiliki Query Streams di setiap proyek. Jalankan/mcpdi dalam Claude Code untuk melihat keterkaitannya.Kursor kunci
Membuka Pengaturan Kursor → MCP → Tambah Server MCP Baruatau edit
.cursor/mcp.jsondi 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 kueriLencana 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 kuerientri ke dalam file konfigurasi yang sudah Anda miliki. Klien apa pun yang menggunakan MCP melalui HTTP akan berfungsi: serverhttps://mcp.querystreams.com/mcp, headerKunci X-MCP(sebuahOtorisasi: Pembawa(Header dengan kunci yang sama juga berfungsi). -
Ajukan pertanyaan pertama Anda
Mulailah dengan sesuatu yang dapat Anda periksa dengan membuka folder, sehingga Anda melihat Claude meraih meja sebelah kanan. Tiga hal yang cocok dengan catatan teks apa pun yang Anda jelaskan:
- “Berkas log mana yang Anda baca, dan kapan perubahan terakhir pada masing-masing berkas tersebut?”
- Claude mengajukan pertanyaan
kumpulan file.fileuntukjalur relatif,ukuran_bytedanUTC yang dimodifikasi, yang terbaru terlebih dahulu. - “Tunjukkan kepada saya setiap KESALAHAN dari satu jam terakhir.”
- Filter Claude
kumpulan file.kejadianpadapesandan jam terakhir dariwaktu_acara, yang terbaru terlebih dahulu. - “Baris mana yang gagal diuraikan oleh format saya, dan mengapa?”
- Claude membaca
fileset.events_raw_lines, kelompok berdasarkanalasandan menunjukkan contoh, sehingga Anda dapat menyesuaikan formatnya.
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.
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 yang digunakan Agen, dan tidak ada yang mengetikkan kata sandi ke dalam AI.
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?
Claude melihat sembilan belas alat kecil. Anda tidak pernah menyebutkannya sendiri; Claude memilih yang tepat untuk pertanyaan Anda. Sederhananya:
Pahami data Anda
Cantumkan konektor, basis data, dan Agen. Baca tabel dan kolom file Log Kustom Anda beserta deskripsi, nilai contoh, dan relasi saat Schema Intelligence telah dijalankan.
Profil dan jelajahi
Lakukan profiling pada sebuah kolom untuk melihat nilai sebenarnya sebelum memfilternya. Temukan join antar tabel yang tidak pernah mendeklarasikan foreign key. (Analisis)
Gunakan kueri yang telah Anda simpan.
Cantumkan kueri berparameter yang tersimpan dan dipercaya oleh tim Anda, lalu jalankan dengan nilai baru. Kueri terfederasi yang mencakup berbagai sumber dijalankan di sisi server dan akan kembali dalam keadaan sudah digabungkan.
Jalankan SQL hanya baca
Tulis dan jalankan perintah SELECT dalam dialek yang tepat untuk Log Kustom. Hingga 1.000 baris dan 60 detik secara default; Claude dapat meminta lebih, hingga 50.000 baris dan lima menit. (Eksekusi)
Periksa peringatan
Cantumkan aturan peringatan Anda, status terkini, dan aktivasi terbaru. Claude dapat membuat draf aturan sebagai uji coba; seseorang akan mengaktifkannya di halaman Peringatan.
Perbaiki modelnya
Periksa cakupan Schema Intelligence per basis data dan, dengan persetujuan Anda, antrekan eksekusi agar jawaban berikutnya lebih baik. (Analisis)
Nama-nama alat tersebut, jika Anda ingin mengenalinya dalam balasan Claude.
| Izin | Peralatan |
|---|---|
| Membaca | qs_daftar_organisasi qs_list_agents konektor_daftar_qs qs_get_si_status qs_get_connector_schema qs_get_table_schema qs_get_relationships qs_list_saved_queries qs_get_task_status aturan_peringatan_daftar_qs qs_get_alert_state qs_list_peringatan_terbaru |
| Menganalisa | tabel_profil_qs qs_temukan_hubungan qs_request_si_analysis qs_setup_si |
| Menjalankan | qs_jalankan_kueri qs_run_saved_query qs_create_alert_rule (hanya mengajukan lamaran; tidak pernah bersenjata dari Claude) |
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.
| Tingkat | Apa yang dilihat Claude | Hasil |
|---|---|---|
| Kecerdasan Skema | Deskripsi untuk setiap tabel dan kolom, nilai contoh, arti enum, gabungan yang dideklarasikan dan ditemukan. | Claude menulis SQL Log Kustom yang tepat sejak pertama kali dan menjelaskan data tersebut dalam istilah bisnis Anda. |
| Skema yang diambil | Nama tabel dan kolom, tipe, kunci. | Claude bekerja, tetapi ia menyimpulkan makna dari nama-nama dan mungkin mengajukan pertanyaan lanjutan. |
| Skema langsung | Basis data berada di luar pilihan pengambilan data konektor, sehingga struktur dibaca secara langsung pada setiap permintaan (membutuhkan izin Eksekusi; SQL Server, MySQL, dan PostgreSQL). | Kueri masih berjalan. Claude melakukan eksplorasi dengan select kecil ketika dibutuhkan lebih banyak. |
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:
| Rencana | Kunci per pengguna | Kunci per organisasi | Panggilan per menit |
|---|---|---|---|
| Gratis | 1 | 1 | 30 |
| Inti Pribadi | 1 | 1 | 60 |
| Personal Plus | 1 | 1 | 90 |
| Inti Bisnis | 2 | 3 | 120 |
| Bisnis Plus | 3 | 5 | 150 |
| Bisnis Max | 5 | 10 | 240 |
| Inti Perusahaan | 5 | 25 | 300 |
| Perusahaan Plus | 8 | 50 | 450 |
| Enterprise Max | 10 | 100 | 600 |
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
Hanya baca, diperiksa oleh Agen
Hanya pernyataan SELECT yang dijalankan. Pemeriksaan terjadi pada komputer yang menjalankan Agen, sebelum file Log Kustom Anda melihat SQL, sehingga tidak ada yang ditulis Claude yang dapat mengubah data.
Tidak ada kredensial di AI.
Login Log Kustom 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 Schema Intelligence termasuk nilai contoh, dan baris kueri yang Anda minta. Semua itu dikirim ke penyedia AI yang Anda hubungkan, sesuai dengan ketentuan mereka. Query Streams tidak pernah melihat percakapan Anda.
Langkah selanjutnya yang bagus
- Sesuaikan formatnya dengan bertanya kepada Claude baris mana yang masuk ke
baris_mentah_peristiwaKemudian, edit konektornya. Menyimpan perubahan akan membuat Agen melakukan pengambilan sampel ulang. - Aktifkan fitur Pantau folder untuk perubahan (hampir secara real-time) untuk mengambil baris baru dalam hitungan detik pada disk lokal. Pemindaian terjadwal tetap menjadi jaminan.
- Minta tipe bawaan Jika format Anda umum, Portal tersebut menyatakan: “Membutuhkan jenis log yang tidak tercantum? Ajukan permintaan dukungan dan kami akan menambahkannya dalam beberapa hari.”
Ketika sesuatu tidak berfungsi
| Apa yang Anda lihat | Apa artinya | Memperbaiki |
|---|---|---|
| Claude tidak menampilkan alat Query Streams. | Konektor telah ditambahkan tetapi tidak pernah terhubung dari obrolan, atau kunci disalin ke tempat yang salah. | Dalam diri Claude: + → Jelajahi konektor → Kueri Aliran → MenghubungkanDi alat pengembang: mulai ulang, lalu periksa. Terakhir digunakan di Kunci Saya. |
MCP_KEY_REQUIRED atau 401 | Kunci 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 Kunci Saya dan kirimkan. Kunci X-MCP Judul. |
MCP_USER_DISABLED | Seorang 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_DENIED | Kunci atau koneksi tersebut tidak memiliki izin untuk tindakan tersebut, biasanya Eksekusi. | Edit tombol di Tombol Saya dan centang Menjalankanatau sambungkan kembali aplikasi dan setujui. |
MCP_KEY_ORG_LIMIT_EXCEEDED | Batas 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 TERDAFTAR | Agen yang memiliki file Log Kustom Anda saat ini tidak terhubung. | Membuka Data → Agen Data dan jalankan Agen di komputernya. |
MCP_DATABASE_TIDAK_TERTANGKAP | Basis data berada di luar pilihan tangkapan konektor, sehingga tidak ada skema tersimpan atau Kecerdasan Skema untuknya. Kueri tetap berfungsi. | Tambahkan ke pilihan pengambilan data pada konektor, lalu jalankan Schema Intelligence jika Anda menginginkan jawaban yang lebih lengkap. |
MCP_RATE_LIMITED | Terlalu banyak panggilan per menit untuk paket Anda, atau lebih dari 10 eksekusi kueri per menit pada satu kata kunci. | Tunggu sebentar. Kecerdasan Skema memungkinkan Claude menjawab panggilan dalam jumlah yang lebih sedikit. |
MCP_QUERY_TIMEOUT atau MCP_OUTPUT_TERLALU_BESAR | Permintaan tersebut melampaui batas waktu atau mengembalikan lebih banyak data daripada yang dapat ditampung Claude dalam satu balasan. | Mintalah jumlah baris atau kolom yang lebih sedikit, atau filter tanggal. Claude biasanya menyarankan hal ini sendiri. |
MCP_DATA_REALM_KELELAHAN | Kuota data organisasi Anda untuk periode ini telah habis. | Tunggu hingga kuota direset atau isi ulang melalui Portal. |
| Pelanggaran akses baca saja | SQL tersebut bukan perintah SELECT. | Sesuai rancangan. Tidak ada yang dapat menulis melalui MCP. |
Pertanyaan yang diajukan orang
Apakah saya harus menulis ekspresi reguler?
Tidak. Lari Uji koneksi dan Agen menawarkan tipe log bawaan yang paling dekat, atau klik Biarkan Nova menyarankan formatnya.Anda juga dapat memilih delimited, key=value, baris JSON, header #Fields, atau lebar tetap sebagai pengganti grok.
Apa yang terjadi pada baris yang formatnya tidak sesuai?
Mereka disimpan di dalam baris_mentah_peristiwa dengan suatu alasan, seperti tidak ada kecocokan tata bahasaTidak ada yang dibuang. File yang sama sekali tidak dapat dibaca disisihkan dan dicantumkan dalam konektor. Berkas berdialog dengan alasan.
Apa yang Claude lihat sebelum saya menentukan format?
Setiap baris menjadi satu deret dengan nama_file dan pesan. waktu_acara adalah waktu modifikasi file, bukan waktu penulisan pada baris tersebut. Definisikan sebuah Cap waktu dan kolom dalam format untuk mendapatkan waktu dan bidang kejadian yang sebenarnya.
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 pada login Anda, tambahkan login berbagi pada baris folder jika diperlukan. 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 di tab Connect.

