MCP를 사용하여 Nginx, Apache 및 IIS 로그를 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 nginx, Apache, IIS or Caddy access 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:

Claude · Query Streams에 연결됨 읽기 전용

Nginx 로그에서 최근 발생한 5xx 오류를 보여주세요.

qs_get_table_schema qs_run_query 스키마 인텔리전스

클로드는 구조를 읽는다 파일셋.이벤트 먼저, 에이전트를 통해 하나의 SELECT 쿼리를 실행합니다. 상태 500 이상, 정렬 기준 이벤트 시간최신순으로 정렬합니다.

이벤트 시간	길	상태
2026-09-25 14:02:11+00	/api/checkout	502
2026-09-25 13:58:47+00	/api/cart/items	504
2026-09-25 13:41:05+00	/search?q=boots	500

클로드는 다음 기준으로 정렬합니다. 이벤트 시간따라서 회전된 파일의 요청이 순서대로 정렬됩니다. 어떤 파일인지와 같은 후속 질문을 하세요. 클라이언트 IP 대부분을 보냈습니다.

Where are the 5xx errors coming from? One endpoint, one client, or everywhere?

qs_run_query qs_run_query

I grouped 파일셋.이벤트 ~에 의해 길 with a 5xx rate, then bucketed the worst path by 10-minute window:

길	Requests	5xx	Rate
/api/checkout	88,210	1,904	2.2%
/api/cart	142,004	61	0.04%
everything else	2,108,442	88	0.004%

It is one endpoint. All but 40 of the checkout 502s fall in two ten-minute windows, 14:00–14:10 and 16:30–16:40, which line up with the two deploys in the container logs. Between those windows checkout ran clean.

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

웹 서버 로그는 Nginx 로그, Apache 액세스 로그, IIS 로그 및 Caddy 로그를 요청당 한 행씩 있는 테이블로 변환하여 Claude가 트래픽 및 오류에 대한 질문에 답변할 수 있도록 합니다. 연결할 서버가 없습니다. 에이전트는 로그 폴더를 열 수 있는 컴퓨터의 로그 폴더를 읽고 해당 행을 캐시합니다. 파일 크기는 지속적으로 모니터링되며, 순환 저장되거나 gzip으로 압축된 파일은 인식되어 요청이 중복 계산되지 않습니다.

필요한 것

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분마다 또는 매일) 에이전트가 새롭거나 변경되었거나 사라진 파일을 찾는 빈도입니다. 폴더 변경 사항 감시 로컬 디스크에서 몇 초 내에 반응합니다. 파일이 사라졌을 때 ~이다 행을 내려놓으세요 기본적으로.

   렐름, 리뷰

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

   • 선택하세요 로그 유형 사용 중인 서버와 일치하는 커넥터를 사용하십시오. 프로필별로 열이 다르므로 로그 형식별로 하나의 커넥터를 사용해야 합니다.
   • 오직 사용자 지정 로그 폴더 이 카드를 사용하면 사용자 지정 형식을 정의할 수 있습니다. 목록 아래에는 "목록에 없는 로그 유형이 필요하신가요? 지원 요청을 제출해 주시면 며칠 내로 추가해 드리겠습니다."라고 적혀 있습니다.
   • 테이블 이름 선택 사항이며 기본값은 입니다. 이벤트. 되메우기(일) 30살이고 N일 동안 이벤트를 유지합니다. 60입니다.
   • ~에 확인하다에이전트가 샘플을 읽고 파일, 크기 및 행 수 예상치를 표시합니다. 파일이 로그 유형과 일치하지 않으면 "이 파일은 로그 유형이 아닙니다"라는 제목과 함께 유형이 표시됩니다. 다른 유형을 선택하고 클릭하십시오. 다시 테스트해 보세요.

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

   토지 요청 이벤트nginx와 Apache를 결합한 프로필은 다음과 같은 기능을 제공합니다. 대지, 클라이언트 IP, 인증, 방법, 길, http_버전, 상태, 바이트, 추천인 그리고 대리인브라우저 문자열은 다음과 같습니다. 대리인IIS W3C 로그는 다음과 같은 고유한 이름을 유지합니다. c_ip, cs_uri_stem 그리고 sc_상태.

   테이블	그것이 담고 있는 것
   이벤트	요청당 한 행씩, 이벤트 시간프로필의 열, _소스_파일 그리고 _라인_번호.
   events_raw_lines	구문 분석에 실패한 줄은 그대로 유지되었습니다. 선 그리고 이유 문법이 일치하지 않는 경우와 같은 오류.
   파일	에이전트가 읽는 액세스 로그 파일의 경로, 크기 및 수정 시간입니다.
   파일_이벤트	파일 기록에는 회전, 덮어쓰기 및 잘림 이벤트가 포함됩니다. 정렬 기준은 다음과 같습니다. 이벤트_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. 첫 번째 질문을 해보세요

   폴더를 열어서 확인할 수 있는 것부터 시작하세요. 그러면 클로드가 어떤 테이블을 찾는지 알 수 있을 겁니다. nginx, Apache, IIS 또는 Caddy 액세스 로그와 잘 연동되는 세 가지 예시를 소개합니다.

   "에이전트가 읽는 액세스 로그 파일은 무엇이며, 이번 주에 교체된 파일은 무엇입니까?"

   클로드는 fileset.files와 files_events의 회전된 행들을 최신 이벤트부터 순서대로 나열합니다.

   "지난 7일 동안 404 오류를 반환하는 상위 20개 경로는 무엇입니까?"

   Claude는 상태와 이벤트 시간을 기준으로 이벤트를 필터링하고, 경로별로 그룹화하여 개수를 반환합니다.

   "분석되지 않은 로그 라인이 있었습니까? 있었다면 그 이유는 무엇입니까?"

   클로드는 events_raw_lines 테이블에서 이유별로 행 수를 세고 예시 행을 보여줍니다.

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

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

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

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

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

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

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

계획이 허용하는 것

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

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

안전하게 보관하기

좋은 다음 행보입니다

• 스키마 인텔리전스 실행 커넥터에서 Claude가 사용자 지정 열에 대한 일반 영어 설명을 받을 수 있도록 합니다. 파일 테이블에는 이미 내장된 설명이 있습니다.
• 스캔 간격을 줄이세요 보다 최신 교통량 정보를 제공합니다. 기본 설정은 1시간 간격이며, 가장 빠른 옵션은 5분 간격입니다.
• 커넥터의 파일 대화 상자를 엽니다. 각 로그 파일을 확인하고 특정 파일이 따로 보관되는 이유를 알아보려면 이 커넥터를 커넥터 목록에서 '로그 파일'로 표시하세요.

무언가가 작동하지 않을 때

사람들이 묻는 질문

관련 가이드

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