Bertanya Claude tentang file Log Kontainer 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 Kontainer 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 your Docker container logs 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:
Kontainer mana saja yang mengirimkan pesan kesalahan ke stderr dalam satu jam terakhir?
Claude membaca kolom-kolom kumpulan file.kejadian Pertama. Kemudian, ia menjalankan satu kueri yang menyimpan baris di mana sungai kecil adalah stderr dan waktu_acara Penurunan harga dalam satu jam terakhir, yang terbaru terlebih dahulu. Tiga kontainer menonjol:
| aplikasi | sungai kecil | pesan |
|---|---|---|
| checkout-api | stderr | ERROR dial tcp 172.18.0.4:5432: connect: connection refused |
| pekerja | stderr | redis.exceptions.TimeoutError: Waktu habis saat membaca dari soket |
| nginx-proxy | stderr | [kesalahan] 29#29: *1184 upstream habis waktu (110: Koneksi habis waktu) |
checkout-api kehilangan basis datanya, dan proxy kehabisan waktu menunggu upstream. Minta Claude untuk menghitung baris stderr per kontainer per menit untuk melihat mana yang gagal terlebih dahulu. Jawabannya mencakup apa yang telah dibaca Agen pada pemindaian terakhirnya.
Is the checkout-api connection error new, and what else was happening at the same time?
I counted checkout-api stderr errors per hour in kumpulan file.kejadian, and put the postgres dan scheduler containers alongside for the same hours:
| Hour | checkout-api errors | postgres restarts | scheduler warnings |
|---|---|---|---|
| 12:00 | 0 | 0 | 0 |
| 13:00 | 412 | 1 | 9 |
| 14:00 | 1,880 | 2 | 31 |
New as of 13:07, and it is not checkout-api’s fault: every burst starts the minute postgres restarts, and postgres’s own last lines before each restart are out of memory. Fix the database container’s memory limit and the checkout errors go with it.
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.
Container Logs membaca file log yang ditulis Docker untuk setiap kontainer dan mengubah setiap baris menjadi satu baris dalam tabel SQL yang dapat diakses oleh Claude. Ini bukan MCP Toolkit milik Docker sendiri. Ia tidak menjalankan atau mengelola kontainer; ia hanya membaca log kontainer Docker. Agen tersebut mengikuti 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 Log Kontainer 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 yang berisi log kontainer Anda di bawah ini. Folder akar. Sertakan pola mulai sebagai
**/*-json.log,**/*.logdan**/*.log.*. - Pilih Jenis logKartu tersebut mengirimkan file JSON Docker,
docker logs --timestampsekspor dan Portainer. - Nama tabel bersifat opsional dan secara default bernilai
acara. - Pada MemeriksaAgen tersebut membaca sampel dan menampilkan jumlah file, ukuran, perkiraan baris, dan tabel yang akan dibuat. Belum ada yang dibuat. Jika file tidak terlihat seperti tipe yang Anda pilih, judulnya akan berbunyi: File-file ini bukan diikuti oleh tipe tersebut, beserta alasannya.
-
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 sumberKolom-kolom di bawah ini berasal dari tipe log file JSON default Docker.Meja Apa yang terkandung di dalamnya acaraSatu baris per baris log: waktu_acara,aplikasi(nama kontainer),sungai kecildanpesan, ditambahgambar,layanan_komposisidanID kontainer.baris_mentah_peristiwaBaris yang tidak diuraikan, tetap dipertahankan. garisdenganalasansepertitidak ada kecocokan tata bahasaatautidak dapat diuraikanTidak 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 dapat melihat Claude meraih meja sebelah kanan. Tiga hal yang berfungsi dengan baik dengan log kontainer Docker Anda:
- “Berkas log kontainer 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. - “Berapa banyak baris stderr yang ditulis setiap kontainer dalam satu jam terakhir?”
- Claude menghitung baris di
kumpulan file.kejadianolehaplikasiDi manasungai keciladalah stderr, difilter berdasarkanwaktu_acara. - “Apakah ada berkas log kontainer yang dirotasi atau disisihkan hari ini?”
- Claude membaca
kumpulan file.file_kejadianuntukdiputardanmelayangbaris, diurutkan berdasarkanacara_pada, dan memberi nama pada setiap file.
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 Kontainer 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 Kontainer. Hingga 1.000 baris dan 60 detik secara default; Claude dapat meminta lebih banyak, 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 Kontainer 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 Kontainer Anda melihat SQL, sehingga tidak ada yang ditulis Claude yang dapat mengubah data.
Tidak ada kredensial di AI.
Login Log Kontainer 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
- 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.
- Tetapkan acara Keep selama N hari untuk mengontrol berapa banyak riwayat yang tersimpan dalam cache. Log Kontainer menyimpan riwayat selama 30 hari secara default.
- Buka dialog Berkas pada konektor untuk melihat setiap file log yang dibaca oleh Agen dan mengapa ada file yang disisihkan.
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 Kontainer 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
Seberapa cepat jalur log kontainer baru sampai ke Claude?
Pada pemindaian berikutnya, Agen memeriksa folder pada Interval pemindaianSecara default, setiap jam. Aktifkan Pantau folder untuk perubahan (hampir secara real-time) untuk bereaksi dalam hitungan detik pada disk lokal. Claude menjawab berdasarkan data yang telah di-cache oleh Agen, sehingga Agen melihat data sesuai dengan pemindaian terakhir.
Apakah file log yang dirotasi dan berformat .gz dibaca dua kali?
Tidak. File yang dirotasi dikenali berdasarkan 4 KB pertamanya dan melanjutkan aliran yang sama, sehingga baris-barisnya tidak dihitung lagi. Setiap .gz Anggota dibaca sekali. .ritsleting, .taksi dan .jurnal Beberapa file dilewati. Baris terakhir yang belum selesai ditulis akan menunggu hingga selesai.
Apa yang terjadi pada baris yang tidak dapat diuraikan?
Itu disimpan di dalam baris_mentah_peristiwa dengan suatu alasan, seperti tidak ada kecocokan tata bahasa atau tidak dapat diuraikanSeluruh berkas yang tidak dapat dibaca disisihkan dan dicantumkan dalam konektor. Berkas Dialog dengan alasan yang mendasarinya. Tidak ada yang diabaikan begitu saja.
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.

