MCP를 사용하여 JSON 애플리케이션 로그를 Claude에 연결합니다.

MCP · 클로드에게 보내는 애플리케이션 로그

묻다 클로드 애플리케이션 로그 파일에 관하여, 쉽게 말해서

Claude, Claude Code, Cursor 또는 기타 MCP 클라이언트를 Query Streams에 한 번만 연결하면 됩니다. Claude는 애플리케이션 로그 파일의 구조를 읽고 SQL 쿼리를 작성한 후, 이미 데이터가 저장된 에이전트를 통해 읽기 전용으로 실행하고 결과를 행 단위로 반환합니다. 데이터베이스 암호는 AI에 절대 전달되지 않습니다. 소요 시간은 약 10분이며, 무료 플랜으로 이용 가능합니다.

약 10분 Claude, ChatGPT, Cursor 외 11개 클라이언트 파일은 제자리에 그대로 있습니다. 항상 읽기 전용입니다.

당신이 최종적으로 얻게 될 것

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 · Query Streams에 연결됨 읽기 전용

지난 한 시간 동안 가장 흔하게 발생한 오류는 무엇이었으며, 어떤 로거가 해당 오류를 발생시켰습니까?

qs_get_table_schema qs_run_query 스키마 인텔리전스

클로드는 열들을 확인합니다. 파일셋.이벤트그런 다음 오류 및 치명적인 결과를 기록하는 쿼리를 하나 실행합니다. 수준 지난 한 시간의 값 이벤트 시간 그리고 그것들을 다음과 같이 그룹화합니다: 나무꾼 그리고 메시지상위 3개:

수준	나무꾼	메시지
오류	결제.StripeClient	결제 실패: 주문 번호 88213에 대해 카드 결제가 거부되었습니다.
오류	주문 서비스	inventory-svc 호출 후 30000ms 만에 타임아웃 발생
치명적인	db.pool	연결 풀이 소진되었습니다(최대 연결 수 20개).

리소스 풀이 고갈되면 OrderService에서 타임아웃이 발생할 수 있습니다. 클로드에게 치명적인 이벤트에 대한 전체 메시지와 스택 트레이스를 요청하세요. 트레이스가 해당 이벤트와 함께 유지되었기 때문에 동일한 행이 표시됩니다. 답변은 에이전트가 마지막 스캔에서 읽은 내용을 다룹니다.

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

qs_run_query qs_run_query

I parsed the decline reason out of 메시지 ~을 위한 결제.StripeClient errors in 파일셋.이벤트 and compared with last week:

Decline reason	Count	공유	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.

선택만 가능하며, 담당자가 확인합니다. 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.

애플리케이션 로그는 ECS, Serilog, pino 또는 Bunyan JSON 로그부터 일반 텍스트 로그까지 애플리케이션이 작성하는 JSON 및 텍스트 로그 파일을 읽습니다. 각 이벤트를 레벨, 로거 및 메시지와 함께 SQL 행으로 변환하고, 해당 이벤트를 발생시킨 스택 추적 정보를 이벤트와 함께 유지합니다. 에이전트는 파일 크기가 증가함에 따라 각 파일을 지속적으로 모니터링하고, 파일 순환을 인식하여 중복 읽기를 방지하며, 각 파일을 읽습니다. .gz 한 번만 보관하고, 처음 읽을 때 지난 30일간의 데이터를 채워 넣습니다.

필요한 것

Query Streams 계정

MCP는 무료 플랜을 포함한 모든 플랜에서 이용 가능합니다. 무료 플랜에서는 키 하나 또는 연결된 앱 하나만 사용할 수 있으며, 이 가이드에서는 그것으로 충분합니다. 가입은 다음 링크에서 하세요. my.querystreams.com.

폴더를 열 수 있는 컴퓨터의 에이전트

버전 2.6.0 이상. 폴더는 해당 컴퓨터 또는 접근 가능한 파일 공유에 있을 수 있습니다. 에이전트는 서비스로 실행되므로 `shares`를 다음과 같이 입력하세요. \\서버\공유\폴더매핑된 드라이브 문자가 아닙니다. 에이전트를 처음 사용하시나요? 윈도우에 설치하세요, macOS 또는 리눅스.

MCP가 활성화되었습니다.

제작자, 소유자 및 관리자는 처음부터 해당 권한을 갖습니다. 그 외의 모든 사용자는 권한을 변경하려면 관리자의 승인이 필요합니다. MCP 이름 옆에 있는 스위치를 누르세요. 계정 → 접근 제어그때까지 MCP 페이지에는 "귀하의 계정에 대해 MCP가 비활성화되었습니다."라는 메시지가 표시됩니다.

AI 클라이언트

Claude 웹 버전, Claude 데스크톱 버전 또는 Claude 모바일 앱은 키 입력 없이 연결됩니다. Claude Code, Cursor, ChatGPT를 비롯한 약 10가지 도구도 사용 가능하며, 포털에는 각 도구에 대한 사용 방법이 미리 준비되어 있습니다.

네 단계로 설정하세요

1. 에이전트가 폴더를 가리키도록 설정하세요

   포털이 열려 있습니다 데이터 → 데이터 에이전트폴더를 열 수 있는 에이전트를 찾아서 클릭하십시오. 커넥터 추가 버튼. 아래에 파일 및 폴더 알약을 클릭하세요 애플리케이션 로그 카드입니다. 그러면 마법사가 단계별로 안내해 줍니다. 폴더, 확인하다, 설정, 왕국 그리고 검토:

   폴더

   입력하세요 루트 폴더에이전트 컴퓨터의 경로로 한 줄에 하나씩 입력하세요. 하위 폴더를 스캔합니다 켜져 있습니다. 최대 깊이 8입니다. 패턴을 포함하세요 이 파일 형식에 맞는 글로브 패턴으로 시작합니다. 추가 제외 패턴 폴더에 원하지 않는 파일이 있는 경우 매핑된 드라이브 문자에 주황색 경고가 표시됩니다. 에이전트가 해당 드라이브를 볼 수 없으므로 다른 방법을 사용하십시오. \\서버\공유 대신 경로를 이용하세요.

   확인하다

   에이전트는 최대 64개의 파일 샘플을 읽고 빌드할 내용을 보여줍니다. 아직 아무것도 생성되지 않았습니다. 만들 준비가 되었습니다 이는 샘플링된 모든 파일이 적합하다는 것을 의미합니다. 적합하지 않은 파일은 "{m}개 파일 중 {n}개가 따로 보관됩니다"라는 주황색 배너로 표시됩니다. 어떤 파일인지, 그리고 그 이유는 무엇인지 보여주세요.커넥터를 생성한 후 나중에 수정할 수도 있습니다. 폴더에 레이아웃이 혼합되어 있는 경우 파란색 패널이 표시됩니다. 레이아웃당 테이블 하나로 전환.

   설정

   스캔 간격 (기본값은 매시간, 5분마다 또는 매일) 에이전트가 새롭거나 변경되었거나 사라진 파일을 찾는 빈도입니다. 폴더 변경 사항 감시 로컬 디스크에서 몇 초 내에 반응합니다. 파일이 사라졌을 때 ~이다 행을 내려놓으세요 기본적으로.

   렐름, 리뷰

   행 수를 계산할 데이터 영역을 선택하고 요약을 확인한 후 클릭하세요. 커넥터를 생성합니다.첫 번째 스캔은 즉시 시작됩니다. 커넥터의 명백한 이 탭에는 빌드된 내용과 따로 저장해 둔 파일이 표시됩니다.

   • 앱 로그가 저장되는 폴더를 다음 위치에 추가하세요. 루트 폴더.
   • 선택하세요 로그 유형이 카드는 JSON 형식의 데이터(ECS, Serilog, pino 및 Bunyan), 레벨, 로거 및 메시지가 포함된 일반 텍스트, 그리고 dpkg 및 apt 기록을 전송합니다. 주인 ID 열로 사용합니다.
   • 테이블 이름 선택 사항이며 기본값은 입니다. 이벤트. N일 동안 이벤트를 유지합니다. 설정하지 않는 한 모든 것을 유지합니다.
   • ~에 확인하다에이전트가 샘플을 읽고 파일 개수, 크기, 행 수 예상치 및 생성될 테이블을 표시합니다. 아직 아무것도 생성되지 않았습니다. 파일 형식이 선택한 형식과 다르면 헤드라인에 다음과 같이 표시됩니다. 이 파일들은 아닙니다 그 뒤에 해당 유형과 이유가 나옵니다.

2. 어떤 테이블을 받게 되는지 확인해 보세요

   파싱된 이벤트는 다음 위치에 저장됩니다. 파일셋.이벤트또는 ~에서 테이블 이름 사용자가 선택한 것입니다. 에이전트는 에이전트 컴퓨터의 로컬 캐시에 행을 저장하고 SQL 형식으로 제공합니다. 각 행에는 해당 행이 어떤 파일에서 왔는지에 대한 정보가 포함되어 있습니다. _소스_파일아래 열들은 기본 JSON 라인 로그 유형에서 가져온 것입니다.

   테이블	그것이 담고 있는 것
   이벤트	이벤트당 한 줄씩: 이벤트 시간, 앱, 수준, 나무꾼 그리고 메시지, 플러스 주인, 서비스, 개울 그리고 데이터여러 줄로 된 스택 추적은 해당 이벤트에 남아 있습니다.
   events_raw_lines	구문 분석에 실패한 줄은 그대로 유지됩니다. 선 함께 이유제한 길이보다 긴 블록은 여기에 놓입니다. 레코드 최대 라인 수아무것도 떨어뜨리지 않습니다.
   파일	현재 폴더에 있는 모든 로그 파일은 다음과 같습니다. 상대 경로, 크기_바이트 그리고 수정된_utc.
   파일_이벤트	각 파일의 이력: 나타났다, 수정됨, 회전된, 잘린 그리고 경향 행, 시간 이벤트_at.
   로그 커서	각 파일의 읽기 위치와 상태입니다. 따로 보관해 둔 파일의 상태는 다음과 같습니다. 주차됨 이유는 다음과 같습니다. 마지막 오류.

   모든 폴더 커넥터는 클로드에게 동일한 회계 표를 제공합니다. 파일셋 개요:

   테이블	그것이 담고 있는 것
   파일	폴더에 있는 모든 파일의 경로, 이름, 확장자, 크기, 생성 및 수정 시간을 표시합니다. "이 폴더에 무엇이 있나요?"라고 물으면 클로드가 이 정보를 읽어줍니다.
   파일_이벤트	변경 내역: 추가, 수정, 삭제 또는 보류된 파일별로 한 행씩 기록됩니다.경향), 시간과 함께 이벤트_at 그리고 그 이유는 다음과 같습니다. 세부 사항.
   디렉토리, 볼륨	폴더 크기 및 개수, 그리고 루트 폴더가 위치한 디스크 또는 공유 폴더 정보입니다.
   _소스_파일, _row_id	각 데이터 행에는 두 개의 열이 있습니다. 하나는 행이 가져온 파일이고, 다른 하나는 해당 파일 내의 고정된 행 ID입니다. 그룹화 기준은 다음과 같습니다. _소스_파일 파일을 비교하기 위해.

3. 클로드에게 연결하세요

   열려 있는 스트림 → 라이브 → MCP들어가는 길은 두 가지이며, 두 길 모두 같은 곳으로 이어집니다.

   채팅 앱 · 키 없음

   claude.ai, 클로드 데스크톱, ChatGPT

   In Claude, Query Streams is in the Anthropic Connectors Directory: browse connectors, click 연결하다. Elsewhere you paste one address into the app, https://mcp.querystreams.com/mcp채팅을 통해 연결할 수도 있습니다. 쿼리 스트림 페이지가 열리면 조직과 권한을 선택하고 클릭합니다. 연결 승인복사할 것도 없고, 비밀로 할 것도 없습니다. 연결은 아래에 있습니다. 연결된 앱 그리고 그곳에서 취소될 수 있습니다.

   개발자 도구 · 핵심

   Claude Code, Cursor, VS Code 및 관련 프로그램

   ~에 내 열쇠 딸깍 하는 소리 키를 생성합니다. 줘 보세요 키 이름 예를 들면, "내 노트북의 클로드 코드"처럼, 계속 읽다 그리고 실행하다 체크 표시를 하셨다면, 하나를 선택하세요. 만료 (절대, 30일, 90일 또는 1년)을 선택하고 클릭하세요. 키를 생성합니다복사한 다음 설치를 계속 진행하세요: 그 연결하다 탭에는 키가 이미 채워진 해당 도구의 정확한 코드 조각이 표시됩니다.

   두 방법 모두 동의 화면이나 키에서 선택하는 동일한 세 가지 권한을 사용합니다.

   읽다

   커넥터 목록을 확인하고, 테이블과 열을 탐색하고, 저장된 쿼리와 알림 규칙을 읽어보세요. 행 데이터는 절대 반환하지 않습니다.

   실행하다

   에이전트를 통해 읽기 전용 SQL 및 저장된 쿼리를 실행하고 행을 반환합니다. 에이전트가 없으면 Claude는 데이터를 설명할 수는 있지만 데이터를 기반으로 답변을 제공할 수는 없습니다.

   분석하다

   프로필 테이블을 생성하고, 관계를 파악하며, 스키마 인텔리전스 실행을 대기열에 추가합니다. 이 기능은 Nova AI 크레딧과 데이터 허용량을 소모하므로 동의 화면에서 자동으로 선택 해제되지 않습니다.

   열쇠를 잃어버리셨나요? 열려 있는 내 열쇠눈 모양 아이콘을 클릭하면 다시 표시됩니다. 전체 키를 복사하세요 복사합니다. 노트북을 분실하면 해당 권한을 취소하세요. 그렇지 않으면 해당 권한을 사용하는 모든 클라이언트가 약 5분 이내에 다음 통화에서 오류가 발생합니다.

   그다음에는 사용하는 클로드에 맞는 레시피를 선택하세요. 서버 주소는 어디에서나 동일합니다. https://mcp.querystreams.com/mcp.

   웹 버전 클로드, 데스크톱 버전 클로드 및 모바일 버전 열쇠 없음

   1. 열려 있는 설정 → 커넥터 클릭하고 클릭하세요 커넥터 찾아보기. Query Streams is listed in the Anthropic Connectors Directory: find 쿼리 스트림 클릭하고 클릭하세요 연결하다. (Or open the directory listing directly and click 연결하다 there.)
   2. If your organization hides directory connectors, click 사용자 지정 커넥터 추가 instead. Name it 쿼리 스트림, 반죽 https://mcp.querystreams.com/mcp, leave the OAuth fields empty, click 추가하다, then in any chat click + → 커넥터 찾아보기 → 쿼리 스트림 → 연결하다.
   3. '쿼리 스트림' 탭이 열립니다. 로그인하라는 메시지가 표시되면 로그인하고, 조직을 선택한 후 검토하세요. 읽다 그리고 실행하다선택적으로 특정 커넥터로 제한그리고 클릭하세요 연결 승인.
   4. 클로드 화면으로 돌아가면 "쿼리 스트림에 연결됨"이라는 메시지가 표시됩니다. 클로드가 도구를 처음 사용할 때 선택하라는 메시지가 나타납니다. 항상 허용하세요.

   If you do add it by hand in Claude Desktop, use 설정 → 커넥터 → 추가채팅창이 아니라 마켓플레이스 추가 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.

   클로드 코드 열쇠

   '내 키'에서 키를 사용하여 한 번의 명령으로 모든 작업을 완료하세요.

   단말기

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

   그것이 현재 프로젝트의 내용을 작성합니다. .mcp.json. 추가하다 --scope 사용자 모든 프로젝트에 쿼리 스트림을 포함시키려면 실행하세요. /mcp 클로드 코드 내부를 살펴보면 연결된 것을 확인할 수 있습니다.

   커서 열쇠

   열려 있는 커서 설정 → MCP → 새 MCP 서버 추가또는 편집 .cursor/mcp.json 워크스페이스의 최상위 폴더:

   .cursor/mcp.json

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

   커서를 다시 시작하거나 실행하세요 MCP: 서버 재시작; 아 쿼리스트림 배지가 MCP 상태 표시줄에 나타납니다.

   다른 걸 사용하시나요? 그만큼 연결하다 꼬리표 ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev 및 JetBrains AI용 바로 붙여넣을 수 있는 레시피가 포함되어 있습니다. 붙여넣기 및 병합 떨어뜨리는 도구 쿼리스트림 기존 설정 파일에 항목을 추가합니다. HTTP를 통해 MCP를 지원하는 모든 클라이언트가 작동합니다. 서버 https://mcp.querystreams.com/mcp헤더 X-MCP-키 (한 권한: 무기명 동일한 키를 가진 헤더도 작동합니다.

4. 첫 번째 질문을 해보세요

   폴더를 열어서 확인할 수 있는 것부터 시작하세요. 그러면 클로드가 어떤 테이블을 찾는지 알 수 있을 겁니다. 애플리케이션 로그 파일과 잘 어울리는 테이블 세 가지를 소개합니다.

   "어떤 애플리케이션 로그 파일을 읽고 있으며, 각 파일의 크기는 얼마나 됩니까?"

   클로드가 질문합니다 파일셋.파일 ~을 위한 상대 경로, 크기_바이트 그리고 수정된_utc.

   "지난 한 시간 동안 각 앱이 기록한 오류는 레벨별로 몇 개입니까?"

   클로드 그룹 파일셋.이벤트 ~에 의해 앱 그리고 수준필터링됨 이벤트 시간.

   어떤 줄들을 구문 분석할 수 없었으며, 그 이유는 무엇입니까?

   클로드가 읽습니다 파일셋.이벤트_원시라인 그리고 줄들을 그룹화합니다. 이유각각에 대한 몇 가지 예시와 함께.

   배선이 제대로 되었는지 확인하려면 문의하십시오. “내가 보유한 Query Streams 커넥터는 무엇인가요?”클로드가 전화합니다. qs_list_connectors그리고 위에 내 열쇠 열쇠의 마지막 사용 시간은 몇 초 내에 업데이트됩니다.

새로 생성되거나 변경되거나 삭제된 파일이 표시되는 방식

클로드가 연결되면 할 수 있는 일

클로드는 열아홉 개의 작은 도구를 봅니다. 당신은 직접 그것들을 부르지 않습니다. 클로드가 당신의 질문에 딱 맞는 도구를 골라냅니다. 쉽게 말해서,

스키마 인텔리전스가 중요한 이유

클로드가 받는 모든 답변에는 해당 구조의 출처가 표시되며, 클로드는 자신이 보는 정보를 얼마나 신뢰할지 조정합니다.

데이터베이스가 중요하다면, 스키마 인텔리전스를 한 번 실행해 보세요. 노바 → 인텔리전스그. 내 열쇠 탭에는 커넥터별 적용 범위 패널이 표시됩니다. 스키마 인텔리전스는 어떻게 작동할까요?.

계획이 허용하는 것

MCP는 무료 플랜을 포함한 모든 플랜에 별도 요금 없이 포함되어 있습니다. 각 플랜은 보유할 수 있는 키 또는 연결된 앱의 수와 클로드(Claude)가 분당 걸 수 있는 통화 횟수를 설정합니다.

연결된 앱은 하나의 키로 간주됩니다. 분당 사용량 외에도, 하나의 키로 분당 최대 10개의 쿼리를 실행할 수 있습니다. 쿼리는 최대 1,000개의 행을 반환하며, Claude가 추가 요청을 하지 않는 한 최대 60초 동안 실행됩니다. 단, 최대 행 수는 50,000개, 실행 시간은 5분입니다. Claude가 수신하는 행 수는 사용자의 Data Realm 할당량에 포함되며, 이는 Excel 및 Sheets 쿼리에서 사용하는 것과 동일한 풀입니다. MCP는 압축 전에 측정되므로, 결과가 클수록 스프레드시트에서 동일한 행을 사용하는 경우보다 비용이 더 많이 발생합니다. Claude에서 시작된 스키마 인텔리전스 실행은 포털에서 실행되는 것과 마찬가지로 Nova AI 크레딧을 사용합니다. 가격 페이지를 참조하세요. 수당에 대해서요.

안전하게 보관하기

좋은 다음 행보입니다

• 폴더 변경 사항 감시 기능을 켜세요(거의 실시간). 로컬 디스크에서 새 줄을 몇 초 안에 감지합니다. 예약된 검사는 이를 보장합니다.
• N일 동안 유지 이벤트를 설정합니다. 캐시에 저장될 기록의 양을 제어합니다. 애플리케이션 로그는 사용자가 설정하지 않는 한 모든 기록을 저장합니다.
• 사용자 지정 로그 폴더 사용 형식이 여기에 없으면 로그 유형 목록입니다. 형식을 직접 설명하시거나, 지원 요청을 제출해 주시면 며칠 내로 추가해 드리겠습니다.

무언가가 작동하지 않을 때

사람들이 묻는 질문

관련 가이드

• MCP를 사용하여 CSV 파일 폴더를 Claude에 연결합니다.
• MCP를 사용하여 Excel 파일 폴더를 Claude에 연결합니다.
• MCP를 사용하여 SQLite 데이터베이스 폴더를 Claude에 연결합니다.
• MCP를 사용하여 Parquet 파일 폴더를 Claude에 연결합니다.
• MCP를 통해 쿼리 스트림을 Claude에 연결하는 방법: 설정, 권한 및 문제 해결
• 모든 MCP 가이드