Hubungkan Log Aplikasi JSON ke Claude dengan MCP

MCP · Log Aplikasi ke Claude

Bertanya Claude tentang file Log Aplikasi 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 Aplikasi 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.

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

Inilah hasil akhirnya

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

Claude · terhubung ke Aliran Kueri Hanya baca

Apa saja kesalahan yang paling umum terjadi dalam satu jam terakhir, dan logger mana yang menyebabkan kesalahan tersebut?

qs_get_table_schema qs_jalankan_kueri kecerdasan skema

Claude memeriksa kolom-kolom kumpulan file.kejadianKemudian, program menjalankan satu kueri yang terus-menerus menghasilkan kesalahan dan kegagalan fatal. tingkat nilai dari jam terakhir waktu_acara dan mengelompokkannya berdasarkan pencatat dan pesanTiga teratas:

tingkat	pencatat	pesan
kesalahan	Pembayaran.Klien Stripe	Transaksi gagal: kartu ditolak untuk pesanan 88213
kesalahan	Layanan Pemesanan	Waktu habis setelah 30000 ms memanggil inventory-svc
fatal	db.pool	Jumlah koneksi telah habis (maksimal 20 koneksi)

Habisnya sumber daya akan menjelaskan terjadinya timeout di OrderService. Mintalah pesan lengkap dan jejak tumpukan (stack trace) dari kejadian fatal tersebut kepada Claude. Pesan tersebut terbaca pada baris yang sama, karena jejaknya tetap berada pada kejadian tersebut. Jawaban tersebut mencakup apa yang telah dibaca oleh Agen pada pemindaian terakhirnya.

Break this week’s payment failures down by reason. Is it customers or us?

qs_jalankan_kueri qs_jalankan_kueri

I parsed the decline reason out of pesan untuk Pembayaran.Klien Stripe errors in kumpulan file.kejadian and compared with last week:

Decline reason	Count	Bagikan	vs last week
card_declined	1,204	62%	+2%
insufficient_funds	402	21%	−1%
api_timeout	331	17%	+310%

The first two are customers and are flat. api_timeout is us: it did not exist a fortnight ago, every one comes from host = web-03, and web-03 shows 30-second gaps in its own logs at the same moments. One unhealthy host, not the payment provider.

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

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

Application Logs membaca file log JSON dan teks yang ditulis aplikasi Anda, dari log JSON ECS, Serilog, pino, atau Bunyan ke teks biasa. Aplikasi ini mengubah setiap kejadian menjadi baris SQL dengan level, logger, dan pesannya, dan jejak tumpukan (stack trace) tetap melekat pada kejadian yang menghasilkannya. Agen memantau setiap file saat ukurannya bertambah, mengenali file yang dirotasi sehingga tidak ada yang dibaca dua kali, dan membaca setiap .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.

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 Log Aplikasi 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.

   • Tambahkan folder log aplikasi Anda ke bawah Folder akar.
   • Pilih Jenis logKartu ini mengirimkan baris JSON (ECS, Serilog, pino, dan Bunyan), teks biasa dengan level, logger, dan pesan, serta riwayat dpkg dan apt, yang menggunakan tuan rumah sebagai kolom identitas.
   • Nama tabel bersifat opsional dan secara default bernilai acara. Pertahankan acara selama N hari Menyimpan semuanya kecuali jika Anda mengaturnya.
   • 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.

2. Lihat meja apa yang Anda dapatkan.

   Peristiwa yang diuraikan masuk ke 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 baris JSON default.

   Meja	Apa yang terkandung di dalamnya
   acara	Satu baris per acara: waktu_acara, aplikasi, tingkat, pencatat dan pesan, ditambah tuan rumah, melayani, sungai kecil dan dataJejak tumpukan multi-baris tetap berada di dalam kejadiannya.
   baris_mentah_peristiwa	Baris yang tidak diuraikan, tetap dipertahankan. garis dengan alasanBlok yang lebih panjang dari batas akan mendarat di sini. rekor-maksimum-barisTidak ada yang terjatuh.
   berkas	Semua file log di folder saat ini, dengan jalur relatif, ukuran_byte dan UTC yang dimodifikasi.
   file_kejadian	Riwayat setiap file: muncul, dimodifikasi, diputar, terpotong dan melayang baris, diatur waktunya oleh acara_pada.
   kursor_log	Posisi baca dan status setiap berkas. Berkas yang disisihkan menunjukkan status. diparkir dengan alasan di kesalahan terakhir.

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

   Meja	Apa yang terkandung di dalamnya
   berkas	Setiap file yang saat ini ada di dalam folder: jalur, nama, ekstensi, ukuran, waktu pembuatan dan modifikasi. Tanyakan "apa yang ada di dalam folder ini?" dan Claude akan membacanya.
   file_kejadian	Riwayat perubahan: satu baris per file yang muncul, dimodifikasi, hilang, atau disisihkan (melayang), dengan waktu di acara_pada dan alasannya detail.
   direktori, volume	Ukuran dan jumlah folder, serta disk atau share tempat root berada.
   berkas sumber, _id_baris	Dua kolom pada setiap baris data: dari file mana baris tersebut berasal, dan ID baris tetap di dalam file tersebut. Kelompokkan berdasarkan berkas sumber untuk membandingkan file.

3. Hubungi Claude

   Membuka Streaming → Langsung → MCPAda dua jalan masuk, dan keduanya berakhir di tempat yang sama:

   Aplikasi obrolan · tanpa kunci

   claude.ai, Claude Desktop, ChatGPT

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

   Alat pengembang · sebuah kunci

   Claude Code, Cursor, VS Code dan teman-teman

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

   Kedua cara tersebut menggunakan tiga izin yang sama, yang dapat Anda pilih di layar persetujuan atau pada kunci:

   Membaca

   Menampilkan daftar konektor, menelusuri tabel dan kolom, membaca kueri tersimpan dan aturan peringatan Anda. Tidak pernah mengembalikan data baris.

   Menjalankan

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

   Menganalisa

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

   Kuncinya hilang? Membuka Kunci Saya: ikon mata menunjukkannya lagi dan Salin kunci lengkap Salin file tersebut. Cabut izinnya di sana jika laptop hilang; setiap klien yang menggunakannya akan gagal pada panggilan berikutnya, dalam waktu sekitar lima menit.

   Kemudian pilih resep Claude yang Anda gunakan. Alamat servernya sama di mana saja: https://mcp.querystreams.com/mcp.

   Claude di web, Claude Desktop dan seluler tidak ada kunci

   1. Membuka Pengaturan → Konektor lalu klik Telusuri konektor. Query Streams is listed in the Anthropic Connectors Directory: find Aliran Kueri lalu klik Menghubungkan. (Or open the directory listing directly and click Menghubungkan there.)
   2. If your organization hides directory connectors, click Tambahkan konektor khusus instead. Name it Aliran Kueri, tempel https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click Menambahkan, then in any chat click + → Telusuri konektor → Aliran Kueri → Menghubungkan.
   3. Tab Aliran Kueri terbuka. Masuk jika diminta, pilih organisasi, tinjau. Membaca dan Menjalankan, opsional Batasi pada konektor tertentulalu klik Setujui koneksi.
   4. Kembali ke Claude, Anda melihat "Terhubung ke Aliran Kueri". Pertama kali Claude menggunakan alat, ia akan menanyakan; pilih Selalu izinkan.

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

   Kode Claude kunci

   Satu perintah, dengan kunci Anda dari Kunci Saya:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "X-MCP-Key: qsmcp_PASTE_YOUR_KEY_HERE"

   Itu menuliskan proyek saat ini .mcp.json. Menambahkan --cakupan pengguna Untuk memiliki Query Streams di setiap proyek. Jalankan /mcp di dalam Claude Code untuk melihat keterkaitannya.

   Kursor kunci

   Membuka Pengaturan Kursor → MCP → Tambah Server MCP Baruatau edit .cursor/mcp.json di akar ruang kerja Anda:

   .cursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "X-MCP-Key": "qsmcp_PASTE_YOUR_KEY_HERE" } } } }

   Mulai ulang Kursor atau jalankan MCP: Mulai Ulang Server; A aliran kueri Lencana muncul di bilah status MCP.

   Menggunakan sesuatu yang lain? Itu Menghubungkan tab memiliki resep siap pakai untuk ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev dan JetBrains AI, ditambah Tempel & gabungkan alat yang menjatuhkan aliran kueri entri ke dalam file konfigurasi yang sudah Anda miliki. Klien apa pun yang menggunakan MCP melalui HTTP akan berfungsi: server https://mcp.querystreams.com/mcp, header Kunci X-MCP (sebuah Otorisasi: Pembawa (Header dengan kunci yang sama juga berfungsi).

4. Ajukan pertanyaan pertama Anda

   Mulailah dengan sesuatu yang dapat Anda periksa dengan membuka folder, sehingga Anda dapat melihat Claude meraih meja sebelah kanan. Tiga hal yang cocok dengan file log aplikasi Anda:

   “Berkas log aplikasi mana yang Anda baca, dan berapa ukuran masing-masing berkas?”

   Claude mengajukan pertanyaan kumpulan file.file untuk jalur relatif, ukuran_byte dan UTC yang dimodifikasi.

   “Berapa banyak kesalahan yang tercatat oleh setiap aplikasi dalam satu jam terakhir, berdasarkan level?”

   Grup Claude kumpulan file.kejadian oleh aplikasi dan tingkat, disaring berdasarkan waktu_acara.

   “Baris mana yang tidak dapat diuraikan, dan mengapa?”

   Claude membaca fileset.events_raw_lines dan mengelompokkan baris-baris tersebut berdasarkan alasan, dengan beberapa contoh untuk masing-masing.

   Untuk memastikan pemasangan kabel, tanyakan “Konektor Query Streams apa saja yang saya miliki?”Claude menelepon konektor_daftar_qs, dan pada Kunci Saya kuncinya Terakhir digunakan Waktu diperbarui dalam beberapa detik.

Bagaimana file baru, yang diubah, dan yang dihapus ditampilkan

Apa yang bisa dilakukan Claude setelah terhubung?

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

Mengapa Kecerdasan Skema penting di sini?

Setiap jawaban yang diterima Claude diberi label dari mana struktur tersebut berasal, dan Claude menyesuaikan seberapa besar kepercayaannya terhadap apa yang dilihatnya.

Jika basis data penting, jalankan Schema Intelligence sekali pada basis data tersebut. Nova → Kecerdasan. Itu Kunci Saya Tab tersebut menampilkan panel cakupan per konektor. Bagaimana cara kerja Schema Intelligence?.

Apa yang diizinkan oleh rencana tersebut

MCP tersedia di semua paket, termasuk paket Gratis, tanpa biaya tambahan. Yang ditentukan oleh setiap paket adalah berapa banyak tombol atau aplikasi terhubung yang dapat Anda simpan dan berapa banyak panggilan per menit yang dapat dilakukan Claude:

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

Menjaganya tetap aman

Langkah selanjutnya yang bagus

• 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 seberapa banyak riwayat yang tersimpan dalam cache. Log Aplikasi menyimpan semuanya kecuali Anda mengaturnya.
• Gunakan Folder Log Kustom jika format Anda tidak ada di Jenis log daftar. Anda dapat mendeskripsikan formatnya sendiri, atau membuka permintaan dukungan dan kami akan menambahkannya dalam beberapa hari.

Ketika sesuatu tidak berfungsi

Pertanyaan yang diajukan orang

Panduan terkait

• Hubungkan Folder File CSV ke Claude dengan MCP
• Hubungkan Folder File Excel ke Claude dengan MCP
• Hubungkan Folder Basis Data SQLite ke Claude dengan MCP
• Hubungkan Folder File Parquet ke Claude dengan MCP
• Menghubungkan Query Streams ke Claude melalui MCP: pengaturan, izin, dan pemecahan masalah
• Semua panduan MCP