View Categories

MCP를 사용하여 CNC 및 기계 로그를 Claude에 연결합니다.

기계 로그무료 플랜쿼리 스트림클로드

Machine Logs → Claude · Query Streams 사용

Query Streams를 사용하면 Machine Logs 파일에 대해 Claude에게 일상적인 영어로 질문할 수 있습니다. 네트워크 내부에 이미 설치된 Agent가 SQL을 읽기 전용으로 실행하므로 데이터베이스 비밀번호가 AI에 전달되지 않습니다. 약 10분이면 설정할 수 있으며 Free 요금제로 이용할 수 있습니다.

무료로 시작하세요
에이전트가 카트를 끌고 카운터의 채팅 패널로 카드를 옮기는 데이터베이스 서가의 등각 투영 라이브러리
진행 과정에서 막히는 부분이 있나요? 언제든지 저희에게 문의하세요. 열려 있는 지원 쿼리 스트림(오른쪽 상단 메뉴 → 지원)에서 메시지를 보내주세요. 담당자가 직접 확인하며, "이 화면에서 무엇을 묻는지 모르겠습니다"라는 질문은 전혀 문제없습니다.

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

기계 로그 아이콘Claude는 CNC, PLC 및 로봇 컨트롤러 로그에 대한 질문에 답변할 수 있습니다. 에이전트가 파일에서 구축한 테이블에 대해 실시간 읽기 전용 쿼리를 수행하고 각 답변이 어떤 파일에서 왔는지 알려줍니다. 로그인 정보나 파일 경로를 알 필요가 없으며 방화벽을 변경할 필요도 없습니다. 네트워크 내부에 이미 설치된 에이전트가 폴더를 읽고 필요한 행만 반환합니다. 에이전트가 설치되면 설정 화면을 사용하는 데 익숙하다면 Claude를 연결하는 데 약 90초가 걸립니다. 설정 화면은 다음과 같습니다.

Nova는 쿼리 스트림 도우미입니다.

차라리 AI 클라이언트를 아예 설치하지 않는 게 나을까요? 사업 계획서에 관하여, Nova MCP는 Query Streams 자체에 내장된 어시스턴트입니다. AI 클라이언트가 사용하는 것과 동일한 에이전트 툴셋을 활용할 뿐만 아니라, 외부 클라이언트에는 없는 추가 기능도 제공합니다. 즉, 시맨틱 인텔리전스 모델에 대한 SQL 쿼리를 작성하고 유효성을 검사하고, 결과를 차트로 변환하고, 팀에서 Excel, Google Sheets 또는 REST API를 통해 실행할 수 있는 쿼리 형식으로 저장합니다. 키나 커넥터, 설치해야 할 것이 전혀 없습니다. 팀원들이 이미 Claude, Cursor 또는 ChatGPT를 사용하고 있다면 MCP를 사용하고, 포털 내에서 바로 결과를 확인하고 싶다면 Nova를 사용하세요.

머신 로그 카드는 CNC 컨트롤러, PLC 및 로봇이 기록하는 로그 파일을 읽어 각 이벤트를 Claude가 조회할 수 있는 행으로 변환합니다. 서버 대신 에이전트가 해당 파일을 열 수 있는 컴퓨터의 로그 폴더를 지정하면 됩니다. 파일 크기는 계속 증가하며, 순환된 파일은 중복 읽히지 않도록 인식됩니다. 일부 머신 프로파일은 알람, 사이클 및 가동 중지 시간 테이블도 생성합니다.

파일이 있는 곳에이전트가 열 수 있는 컴퓨터 또는 파일 공유폴더파일파일은 원래 위치에 그대로 있습니다.쿼리 스트림 에이전트폴더를 스캔하고 테이블을 생성합니다.로컬 캐시에서 SQL을 실행합니다.SELECT만 가능하며, 여기서는 강제 적용됩니다.쿼리 스트림MCP 서버키, 권한, 속도 제한을 확인하고 모든 호출을 기록합니다.당신이 묻는 곳claude.ai, Claude Desktop, Claude Code, Cursor, ChatGPT귀사의 AI 클라이언트키나 연결 정보를 보유하는 것이지, 파일을 보유하는 것은 아닙니다.
Claude는 사용자의 파일을 직접 열지 않습니다. 에이전트는 자체 컴퓨터에서 폴더를 읽고 행을 로컬 캐시에 저장한 다음 Claude가 작성한 SQL 쿼리를 실행합니다. 질문에 필요한 행만 쿼리 스트림을 통해 다시 전송됩니다.

필요한 것

Query Streams 계정

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

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

버전 2.6.0 이상. 폴더는 해당 컴퓨터 또는 접근 가능한 파일 공유에 있을 수 있습니다. 에이전트는 서비스로 실행되므로 `shares`를 다음과 같이 입력하세요. \\서버\공유\폴더매핑된 드라이브 문자가 아닌 다른 방식으로 접근해야 합니다. Windows에서는 저장된 로그인 정보를 사용하여 공유 폴더에 로그인할 수 있습니다. Linux 또는 Mac에서는 먼저 공유 폴더를 마운트해야 합니다(Linux에서는 다음 명령어를 사용하세요). /mnt 또는 /메디아맥 /볼륨에이전트를 처음 사용하시나요? 윈도우에 설치하세요, macOS 또는 리눅스.

MCP가 활성화되었습니다.

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

AI 클라이언트

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

작업은 어디에서 이루어지나요? 에이전트가 실행되는 컴퓨터에서 해당 폴더를 스캔하고, 행을 로컬 캐시에 복사한 다음, 클로드(Claude)가 작성한 SQL 쿼리를 해당 캐시에 대해 실행합니다. 파일 자체는 해당 컴퓨터를 벗어나지 않으며, 클로드가 요청하지 않은 어떤 것도 전송되지 않습니다.

네 단계로 설정하세요

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

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

    폴더
    입력하세요 루트 폴더에이전트 컴퓨터의 경로로 한 줄에 하나씩 입력하세요. 하위 폴더를 스캔합니다 켜져 있습니다. 최대 깊이 8입니다. 패턴을 포함하세요 이 파일 형식에 맞는 글로브 패턴으로 시작합니다. 추가 제외 패턴 폴더에 원하지 않는 파일이 있는 경우 매핑된 드라이브 문자에 주황색 경고가 표시됩니다. 에이전트가 해당 드라이브를 볼 수 없으므로 다른 방법을 사용하십시오. \\서버\공유 대신 경로를 이용하세요.
    확인하다
    에이전트는 최대 64개의 파일 샘플을 읽고 빌드할 내용을 보여줍니다. 아직 아무것도 생성되지 않았습니다. 만들 준비가 되었습니다 이는 샘플링된 모든 파일이 적합하다는 것을 의미합니다. 적합하지 않은 파일은 "{m}개 파일 중 {n}개가 따로 보관됩니다"라는 주황색 배너로 표시됩니다. 어떤 파일인지, 그리고 그 이유는 무엇인지 보여주세요.커넥터를 생성한 후 나중에 수정할 수도 있습니다. 폴더에 레이아웃이 혼합되어 있는 경우 파란색 패널이 표시됩니다. 레이아웃당 테이블 하나로 전환.
    설정
    스캔 간격 (기본값은 매시간, 5분마다 또는 매일) 에이전트가 새롭거나 변경되었거나 사라진 파일을 찾는 빈도입니다. 폴더 변경 사항 감시 로컬 디스크에서 몇 초 내에 반응합니다. 파일이 사라졌을 때 ~이다 행을 내려놓으세요 기본적으로.
    렐름, 리뷰
    행 수를 계산할 데이터 영역을 선택하고 요약을 확인한 후 클릭하세요. 커넥터를 생성합니다.첫 번째 스캔은 즉시 시작됩니다. 커넥터의 명백한 이 탭에는 빌드된 내용과 따로 저장해 둔 파일이 표시됩니다.

    선택하세요 로그 유형 목록에서. 기계 프로필은 고정되어 있습니다. 오직 사용자 지정 로그 폴더 이 카드를 사용하면 사용자 지정 형식을 정의할 수 있습니다. 목록 아래에는 "목록에 없는 로그 유형이 필요하신가요? 지원 요청을 제출해 주시면 며칠 내로 추가해 드리겠습니다."라고 적혀 있습니다. 테이블 이름 선택 사항이며 기본값은 입니다. 이벤트. 되메우기(일) 30이므로 첫 번째 읽기는 30일 전으로 거슬러 올라갑니다. 확인하다에이전트는 선택한 로그 유형의 샘플을 읽고 생성될 파일, 크기 및 테이블을 표시합니다. 파일이 일치하지 않으면 "이 파일은 아닙니다"라는 제목과 함께 로그 유형이 표시됩니다. 다른 유형을 선택하고 클릭하십시오. 다시 테스트해 보세요.

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

    파싱된 줄은 다음과 같습니다. 이벤트또는 설정한 테이블 이름입니다. 각 행에는 다음이 있습니다. 이벤트 시간, 식별 열 기계 (기계 인간 로봇 프로필의 경우) 그리고 선택한 로그 유형의 열이 포함됩니다. 파생 테이블은 해당 테이블을 선언한 프로필에 대해서만 존재합니다.

    테이블그것이 담고 있는 것
    이벤트파싱된 로그 이벤트당 한 행씩, 이벤트 시간, 이벤트 시간_로우, 기계프로필의 열, _소스_파일 그리고 _라인_번호.
    events_raw_lines구문 분석에 실패한 줄은 그대로 유지되었습니다. 선 그리고 이유 문법이 일치하지 않거나 해독할 수 없는 경우와 같은 오류입니다.
    경보, 주기, 교대 근무프로필에서 해당 기능을 선언한 경우, 매 동기화 후 이벤트로부터 다시 생성됩니다.
    유휴 간격, oee_입력다운타임 범위와 OEE 입력값은 해당 값을 선언한 프로필의 경우 동기화 후 매번 다시 구축됩니다.
    파일, 파일_이벤트로그 파일과 해당 기록(순환, 재작성 및 잘림 이벤트 포함).
    로그 커서각 파일의 읽기 위치 및 상태. 따로 보관해 둔 파일은 '보류됨' 상태와 그 이유를 표시합니다. 마지막 오류.

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

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

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

    채팅 앱 · 키 없음

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

    claude.ai 및 Claude Desktop에서 다음을 엽니다. 쿼리 스트림 목록 Anthropic의 커넥터 디렉토리에서 클릭하세요. 연결하다 그리고 승인합니다. URL로 추가하려면, https://mcp.querystreams.com/mcp이것이 대체 방법입니다. ChatGPT에서는 앱(현재는 개발자 모드)에서 쿼리 스트림을 추가하고 쿼리 스트림으로 로그인합니다. 어느 방법을 사용하든 쿼리 스트림 페이지가 열립니다. 조직과 권한을 선택하고 클릭하세요. 연결 승인복사할 내용이 없습니다. 연결은 다음과 같습니다. 연결 탭에서 취소할 수 있습니다.

    개발자 도구 · 핵심

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

    MCP 페이지에서 클릭하세요 AI 클라이언트를 연결하세요가이드가 묻습니다. 귀사의 AI 클라이언트는 어떻게 연결될까요?: 선택하다 설정 파일에서 키를 사용하세요자, 도구를 고르세요. 키를 생성하세요 그것: 하나 키 이름, 읽다 그리고 쿼리를 실행합니다 체크 표시됨, 그리고 만료 (절대, 30일, 90일 또는 1년). 설정하세요 키가 채워진 코드 조각을 보여줍니다. 연결 상태를 확인하세요 첫 번째 전화를 기다립니다.

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

    읽다
    커넥터 목록을 확인하고, 테이블과 열을 탐색하고, 저장된 쿼리와 알림 규칙을 읽어보세요. 행 데이터는 절대 반환하지 않습니다.
    쿼리를 실행합니다
    에이전트를 통해 읽기 전용 SQL 및 저장된 쿼리를 실행하고 행을 반환합니다. 에이전트가 없으면 AI 클라이언트는 데이터를 설명할 수는 있지만 데이터를 기반으로 답변을 제공할 수는 없습니다.
    분석하다
    테이블을 프로파일링하고, 관계를 찾아내고, Semantic Intelligence 실행을 대기열에 추가하세요. 프로파일링과 검색은 무료입니다. Semantic Intelligence 실행은 Nova AI 크레딧과 데이터 사용량을 소모하므로 동의 화면에서 기본 선택되지 않습니다.

    열쇠를 잃어버리셨나요? 목록에 등재되어 있습니다. 연결 꼬리표: 전체 키 공개 그것을 다시 보여주고 전체 키를 복사하세요 복사합니다. 노트북을 분실하면 해당 권한을 취소하세요. 그렇지 않으면 해당 권한을 사용하는 모든 클라이언트가 약 5분 이내에 다음 통화에서 오류가 발생합니다.

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

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

    1. 열기 쿼리 스트림 목록 Anthropic의 커넥터 디렉토리에서 클릭하세요. 연결하다데스크톱에서는 그 아래에 위치합니다. + → 커넥터.
    2. 조직에서 디렉터리 커넥터를 숨기는 경우 대체 방법: 설정 → 커넥터 → 사용자 지정 커넥터 추가, 이름 쿼리 스트림URL https://mcp.querystreams.com/mcpOAuth 필드가 비어 있습니다. 추가하다그런 다음 채팅에서 + → 쿼리 스트림 → 연결하다.
    3. '쿼리 스트림' 탭이 열립니다. 로그인하라는 메시지가 표시되면 로그인하고, 조직을 선택한 후 검토하세요. 읽다 그리고 쿼리를 실행합니다선택적으로 특정 커넥터로 제한그리고 클릭하세요 연결 승인.
    4. 클로드 화면으로 돌아가면 "쿼리 스트림에 연결됨"이라는 메시지가 표시됩니다. 클로드가 도구를 처음 사용할 때 선택하라는 메시지가 나타납니다. 항상 허용하세요.

    Claude Desktop에서 수동으로 추가하는 경우 다음을 사용하십시오. 설정 → 커넥터 → 추가채팅창이 아니라 마켓플레이스 추가 이 옵션은 Git 저장소를 필요로 합니다. 커넥터는 Claude 계정과 동기화되므로 모바일 앱과 데스크톱에서 자동으로 인식합니다. 메뉴 이름은 Anthropic에서 지정한 이름이며, 필요에 따라 변경할 수 있습니다.

    클로드 코드 열쇠

    연결 탭에서 키를 사용하여 한 번의 명령으로 모든 작업을 수행할 수 있습니다.

    단말기
    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 상태 표시줄에 나타납니다.

    다른 걸 사용하시나요? 포털의 AI 클라이언트를 연결하세요 가이드 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. 첫 번째 질문을 해보세요

    폴더를 열어서 확인할 수 있는 것부터 시작하세요. 그러면 클로드가 올바른 테이블을 찾는 모습을 볼 수 있을 겁니다. CNC, PLC 및 로봇 컨트롤러 로그와 잘 연동되는 세 가지 예시를 소개합니다.

    "에이전트가 읽고 있는 머신 로그 파일은 무엇이며, 각 파일의 마지막 크기 증가는 언제였습니까?"
    Claude는 fileset.files에서 relative_path, size_bytes 및 modified_utc 값을 최신순으로 조회합니다.
    "어제 각 기기는 시간당 몇 건의 이벤트를 기록했습니까?"
    Claude는 fileset.events를 머신과 이벤트 발생 시간별로 그룹화하여 간단한 표를 반환합니다.
    구문 분석에 실패한 줄들을 이유별로 그룹화해서 보여주세요.
    클로드는 events_raw_lines 테이블에서 이유별로 행 수를 세고 각 이유에 대한 몇 가지 예시 행을 보여줍니다.

    배선이 제대로 되었는지 확인하려면 문의하십시오. “내가 보유한 Query Streams 커넥터는 무엇인가요?”클로드가 전화합니다. qs_list_connectors포털 가이드의 연결 상태를 확인하세요 스텝은 다음과 같이 말합니다. 연결됨그리고 키 또는 앱은 연결 탭에는 해당 내용이 표시됩니다. 마지막 사용 몇 초 안에 시간이 걸립니다.

그게 다예요. 폴더에 새 파일을 넣으면 다음 스캔 후 클로드가 해당 파일에서 답변을 할 수 있습니다. 파일은 원래 있던 컴퓨터를 벗어나지 않으며, 누구도 AI에 비밀번호를 입력할 필요가 없습니다.

네트워크 공유의 파일에 접근하기

에이전트는 사용자가 아닌 백그라운드 서비스로 파일을 열기 때문에 다른 컴퓨터에 있는 파일을 열려면 추가 단계가 필요합니다. 어떤 단계가 필요한지는 에이전트가 실행되는 컴퓨터에 따라 다릅니다.

윈도우

네트워크 경로를 입력하세요. 예: \\서버\공유\폴더매핑된 드라이브 문자(예: ...)는 절대 사용하지 않습니다. 에스:에이전트가 볼 수 없는 내용입니다. 공유 설정에서 지정된 사람만 접속할 수 있도록 하려면 클릭하세요. 서비스 ID (경로 아래의 칩 또는 폴더의) 신임장 해당 서버에 대한 로그인 정보를 저장합니다. 회사 도메인 계정 또는 서버 자체에서 생성된 계정을 사용할 수 있습니다. 도메인 해당 필드는 비워 두십시오. 그러면 에이전트가 해당 서버에 로그인하여 파일을 읽습니다. 동일한 서버를 읽는 에이전트의 모든 커넥터는 동일한 로그인 정보를 사용해야 합니다. 로그인 정보가 없으면 에이전트는 자체 서비스 계정으로 파일을 읽게 되며, 회사 도메인에서는 이를 컴퓨터 자체로 인식합니다. Windows에서 단계별로 진행

리눅스

포털에 저장된 공유 로그인 정보는 Linux에서 사용되지 않습니다. 관리자는 먼저 에이전트 컴퓨터의 특정 폴더에 공유를 마운트해야 합니다. /mnt 또는 /메디아에이전트 서비스에서 볼 수 없기 때문입니다. /집 또는 /실행/사용자커넥터에서 다음을 유지하십시오. \\서버\공유 에이전트가 마운트에 매핑하는 경로를 지정하거나, 마운트 경로를 직접 입력할 수도 있습니다(예: ...). /mnt/fileserver-shared/Accounts. 리눅스에서 공유 폴더를 마운트하는 방법

스코틀랜드 사람

포털에 저장된 공유 로그인 정보는 Mac에서 사용되지 않습니다. 터미널에서 먼저 공유를 마운트하십시오. 슈도폴더 안에 /볼륨에이전트의 백그라운드 서비스에서 이를 볼 수 있도록 합니다. 커넥터에서 다음을 유지하세요. \\서버\공유 에이전트가 마운트에 매핑하는 경로를 지정하거나, 마운트 경로를 직접 입력할 수도 있습니다(예: ...). /볼륨/파일서버공유/계정. 맥에서 공유 폴더를 마운트하는 방법

테스트가 공유 폴더에 접근할 수 없는 경우, 결과에서 다음 단어들을 찾아보세요. 도달할 수 없음 에이전트 컴퓨터가 서버로부터 응답을 받지 못했다는 의미입니다. Linux 또는 Mac 환경에서는 장착되지 않음 이는 공유 폴더가 아직 마운트되지 않았다는 의미이며, 해당 메시지에는 서버에 맞는 정확한 마운트 명령이 포함되어 있습니다.

공유 폴더에 폴더가 있나요? Windows에서는 하나의 로그인으로 동일한 서버에서 추가하는 모든 폴더를 관리할 수 있습니다. 폴더 변경 사항 감시 공유 폴더에서도 최선을 다해 작동합니다. 예약된 스캔을 통해 모든 변경 사항이 감지됩니다.

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

새 파일 및 변경된 파일

모든 것에서 스캔 간격 에이전트는 각 파일의 크기와 수정 시간을 원장과 비교합니다. 원장에 맞는 새 파일은 추가되고, 변경된 파일은 전체를 다시 읽어들이므로 테이블에 동일한 파일의 두 가지 버전이 저장되는 일은 없습니다. 이 기능을 활성화하세요. 폴더 변경 사항 감시 로컬 디스크에서 몇 초 내에 반응합니다.

삭제된 파일

파일이 사라지면 해당 파일의 행도 삭제됩니다. 단, 사용자가 별도로 선택한 경우는 제외합니다. 행은 유지하고, 삭제된 것으로 표시합니다.공유 폴더가 오프라인 상태가 되어 대부분의 파일이 한꺼번에 사라지는 경우, 에이전트는 모든 파일을 삭제하는 대신 마지막으로 정상 작동했던 파일 목록을 유지합니다.

파일들을 따로 보관해 두세요

레이아웃에 맞지 않거나, 열 수 없거나, 잠겨 있는 파일은 따로 분리됩니다. 해당 파일의 모든 행이 로드되지 않습니다. 파일_이벤트 어떤 파일인지, 그리고 그 이유가 무엇인지 기록합니다. 다음에 변경 사항이 발생하면 자동으로 다시 시도됩니다. 재스캔 버튼은 없습니다.

클로드가 보는 것

마지막 스캔 시점의 데이터입니다. MCP 도구는 스캔을 트리거하지 않으므로 "마지막 업데이트는 언제였습니까?"라고 물으면 Claude가 최신 데이터를 읽어옵니다. 이벤트_at ~에 파일_이벤트 당신을 위한.

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

AI 클라이언트는 쿼리 스트림 도구를 보고 질문에 가장 적합한 도구를 선택합니다. 포털의 도구 꼬리표 각 도구와 모드, 그리고 사용 중인 요금제에 포함된 항목을 모두 나열합니다. Query Streams는 쿼리를 실행하기 전에 AI 클라이언트가 각 테이블의 열을 읽도록 요청하므로, 추측하는 대신 실제 이름을 사용해 쿼리를 작성합니다. 무료 요금제를 포함한 모든 요금제에서 이용할 수 있습니다:

데이터를 매핑하세요

커넥터, 데이터베이스 및 에이전트; 시맨틱 인텔리전스 실행 후 머신 로그 파일의 테이블과 열에는 설명, 샘플 값 및 조인이 표시됩니다.

프로필을 살펴보고 둘러보세요.

열을 필터링하기 전에 프로파일링하고, 선언되지 않은 조인을 찾아보세요. 실시간 실행에는 Analyze가 필요합니다.

읽기 전용 SQL을 실행합니다.

머신 로그에 적합한 언어로 작성된 SELECT 문입니다. 기본값은 60초이고 최대 시간은 5분입니다. 실행 계획에 따라 하나의 쿼리가 반환하는 최대 행 수가 결정됩니다. (쿼리 실행)

저장된 쿼리, 연동 및 알림

팀에서 신뢰하는 저장된 쿼리를 새 값으로 실행하세요. 연합된 쿼리는 이미 결합된 상태로 반환됩니다. 알림 규칙을 읽고 모의 실행으로 규칙을 하나 작성해 보세요.

분석 도구 모음. 유료 플랜에서는 에이전트가 머신 로그 파일이 저장될 위치에 대한 기초 작업을 수행하므로 AI 클라이언트는 사고 과정에 집중할 수 있습니다. 무료 플랜은 기존 방식대로 작동합니다.

컨텍스트 관리

개인 핵심 및 그 이상

결과를 읽기 전에 크기를 확인하세요.모양), 대규모 데이터베이스 영역을 영역별로 탐색합니다.레벨), 그리고 답변은 정해진 예산 내에서만 유지하세요. 컬럼 그리고 필요한 세포 길이.

결과 분석

개인 핵심 및 그 이상

A 윤곽 행이 아닌 전체 결과입니다. 결과 발표 레이블을 사용하면 후속 조치 및 그룹별 합계를 두 번째 쿼리 없이 수행할 수 있습니다. 데이터 최신성 그리고 변경됨 - 이후 새로운 내용만 읽으세요.

심층 분석

비즈니스 코어 이상

데이터 품질 보고서, 변칙, 세그먼트통계적 비교하다 그리고 차이점 두 결과 사이의 차이.

기본 설정은 다음과 같습니다. 문맥 꼬리표텍스트 셀 제한, 스키마 보기, 결과 크기, 분석 기본값 및 보류된 결과.

AI 클라이언트의 답변에서 도구 이름을 알아보려면 이 정보를 참고하세요.
허가도구
읽다qs_list_organizations qs_list_agents qs_list_connectors qs_get_si_status qs_get_connector_schema qs_find_tables qs_get_table_schema qs_get_relationships qs_profile_table qs_discover_relationships qs_list_saved_queries qs_alerts qs_result (op=windows)
분석하다qs_request_si_analysis qs_setup_si qs_get_task_status, Analyze가 있는 키에만 표시되며, 실시간 실행은 qs_profile_table 그리고 qs_discover_relationships
쿼리를 실행합니다qs_run_query qs_run_saved_query qs_데이터_신선도 qs_result (기타 모든 op) qs_result_release qs_create_alert_rule (제안만 해당)

여기서 시맨틱 인텔리전스가 중요한 이유

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

층클로드가 보는 것결과
의미 지능각 테이블과 열에 대한 설명, 샘플 값, 열거형 의미, 선언 및 발견된 조인이 포함되어 있습니다.클로드는 머신 로그 SQL 쿼리를 처음부터 정확하게 작성하고 데이터를 고객의 비즈니스 용어로 설명해 줍니다.
캡처된 스키마테이블 및 컬럼 이름, 데이터 유형, 키.클로드는 일을 하지만, 이름에서 의미를 추론하고 추가 질문을 할 수도 있습니다.
라이브 스키마데이터베이스가 커넥터의 캡처 선택 영역 외부에 있으므로 구조는 요청 시마다 실시간으로 읽힙니다(쿼리 실행 권한 필요, SQL Server, MySQL 및 PostgreSQL 지원).쿼리는 계속 실행됩니다. 클로드는 더 많은 쿼리가 필요할 때 작은 쿼리를 사용하여 탐색합니다.

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

계획이 허용하는 것

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

계획사용자별 키 개수조직별 키 개수분당 통화 횟수
무료1130
개인적 핵심1160
퍼스널 플러스1190
비즈니스 코어23120
비즈니스 플러스35150
비즈니스 맥스510240
엔터프라이즈 코어525300
엔터프라이즈 플러스850450
엔터프라이즈 맥스10100600

연결된 앱은 하나의 키로 간주됩니다. 분당 사용량 제한 외에도, 하나의 키는 분당 최대 10개의 쿼리를 실행할 수 있습니다. 쿼리는 AI 클라이언트가 추가 시간을 요청하지 않는 한 최대 60초 동안 실행되며, 추가 시간이 필요한 경우 최대 5분까지 실행될 수 있습니다. 또한, 플랜에 따라 쿼리가 반환하는 행 수와 분석 도구 세트를 사용하는 경우 결과 보관 기간 및 크기가 설정됩니다. MCP 전체 가이드 모든 계획을 나열합니다. AI 클라이언트가 받는 데이터는 Excel 및 Sheets 쿼리와 동일한 풀인 Data Realm 허용량에서 차감됩니다. AI 에이전트(MCP) 사용량은 결과, 스키마 읽기, 보류된 결과 페이지를 비롯해 AI 클라이언트에 전달되는 모든 바이트를 계산하며, 클라이언트가 협상하는 전송 압축을 적용하기 전 기준으로 집계됩니다. 반면 스프레드시트 쿼리는 Network Agent가 전달하는 압축된 결과를 기준으로 계산합니다. AI 클라이언트에서 시작한 Semantic Intelligence 실행은 Portal에서 시작한 경우와 마찬가지로 Nova AI 크레딧을 사용합니다. 가격 페이지를 참조하세요. 수당에 대해서요.

안전하게 보관하기

읽기 전용, 에이전트가 확인함

SELECT 문만 실행됩니다. 검사는 에이전트가 실행되는 컴퓨터에서 수행되며, 머신 로그 파일에 SQL이 기록되기 전에 이루어지므로 AI 클라이언트가 작성하는 내용은 데이터를 변경할 수 없습니다.

AI 분야 자격증 없음

머신 로그 로그인 정보는 에이전트에 유지됩니다. Claude는 쿼리 스트림 키 또는 연결을 보유하고 있으며, MCP 페이지에서 이를 취소할 수 있습니다. 변경 사항은 약 5분 후에 적용됩니다.

모든 것이 기록됩니다

모든 툴콜은 MCP에 표시됩니다. 활동 탭과 쿼리 기록의 모든 쿼리는 클라이언트 유형이 MCP로 표시되며, 해당 키 또는 연결을 생성한 담당자에게 귀속됩니다. SQL 텍스트와 키 자체는 활동 로그에 기록되지 않습니다.

AI 제공업체가 받는 것

테이블 및 열 이름, 샘플 값을 포함한 시맨틱 인텔리전스 설명, 그리고 요청한 쿼리의 행이 표시됩니다. 분석 도구 세트를 사용하는 경우 종종 크기 추정치, 프로필 또는 보류된 결과 답변이 제공되며 전체 결과는 상담원에게만 제공됩니다. 상담원이 받는 정보는 연결된 AI 제공업체의 약관에 따라 해당 제공업체로 전송됩니다. 쿼리 스트림은 사용자의 채팅 내용을 볼 수 없습니다.

좋은 다음 행보입니다

  • 의미 지능 실행 커넥터에서 Claude가 사용자 지정 열에 대한 일반 영어 설명을 받을 수 있도록 합니다. 파일 테이블에는 이미 내장된 설명이 있습니다.
  • N일 동안 유지 이벤트를 설정합니다. 오래된 이벤트를 삭제하려면 해당 옵션을 선택하세요. 머신 로그는 기본적으로 모든 이벤트를 보관합니다.
  • 커넥터의 파일 대화 상자를 엽니다. 각 로그 파일을 확인하고 특정 파일이 따로 보관되는 이유를 알아보려면 이 커넥터를 커넥터 목록에서 '로그 파일'로 표시하세요.

무언가가 작동하지 않을 때

당신이 보는 것그것이 의미하는 바는고치다
AI 클라이언트에 쿼리 스트림 도구가 표시되지 않습니다.커넥터가 추가되었지만 연결되지 않았거나, 키가 잘못된 위치에 붙여졌습니다.클로드에게: + → 스트림 쿼리 → 연결하다개발자 도구에서: 재시작한 다음 사용하세요. 연결 상태를 확인하세요 포털 가이드에 있습니다.
MCP_KEY_필수 또는 401서버에 키가 전송되지 않았습니다. 일반적으로 복사 및 붙여넣기 과정에서 잘못된 줄 바꿈이 발생했거나 키가 잘못된 헤더에 포함된 경우입니다.연결 탭에서 키를 다시 복사하여 보내주세요. X-MCP-키 헤더.
MCP_사용자_비활성화됨관리자가 해당 사용자에 대해 MCP를 비활성화했습니다.그들에게 돌리라고 요청하세요 MCP 아래에서 다시 켜세요 계정 → 접근 제어.
MCP_SCOPE_REQUIRED 또는 MCP_SCOPE_DENIED해당 키 또는 연결에 쿼리 실행과 같은 작업에 대한 권한이 없습니다.연결 탭에서 키를 편집하고 체크 표시를 하세요. 쿼리를 실행합니다또는 앱을 다시 연결하고 승인하세요.
MCP_KEY_ORG_LIMIT_EXCEEDED사용하시는 요금제의 키 사용 한도가 모두 소진되었습니다. 무료 요금제의 경우 키 하나 또는 연결된 앱 하나로 제한됩니다.더 이상 사용하지 않는 요금제를 취소하거나 상위 요금제로 업그레이드하세요.
MCP_에이전트가 연결되지 않았습니다 또는 MCP 에이전트가 등록되지 않았습니다머신 로그 파일을 소유한 에이전트가 현재 연결되어 있지 않습니다.열려 있는 데이터 → 데이터 에이전트 그리고 해당 컴퓨터에서 에이전트를 시작합니다.
MCP_데이터베이스_캡처되지 않음데이터베이스가 커넥터의 캡처 선택 범위 밖에 있으므로 저장된 스키마나 시맨틱 인텔리전스가 없습니다. 하지만 쿼리는 여전히 작동합니다.커넥터의 캡처 선택 항목에 추가한 다음, 더 풍부한 답변을 원하면 시맨틱 인텔리전스를 실행하세요.
MCP_RATE_LIMITED사용하시는 요금제에 비해 분당 통화 횟수가 너무 많거나, 하나의 키에 대해 분당 10회 이상의 쿼리 실행이 발생했습니다.잠시만 기다려 주세요. 시맨틱 인텔리전스 덕분에 클로드는 더 적은 통화로 응답할 수 있습니다.
MCP_QUERY_TIMEOUT 또는 MCP_OUTPUT_TOO_LARGE쿼리 실행 시간이 초과되었거나 AI 클라이언트가 한 번에 처리할 수 있는 응답보다 많은 응답이 반환되었습니다.행이나 열의 수를 줄이거나 날짜 필터를 적용해 달라고 요청하세요. 컨텍스트 관리 기능이 있는 요금제에서는 먼저 결과 크기를 조정해 달라고 요청하세요.
MCP_DATA_REALM_EXHAUSTED귀사의 해당 기간 데이터 사용량이 모두 소진되었습니다.사용량 한도가 재설정될 때까지 기다리거나 포털에서 충전하세요.
MCP_기능이_포함되지 않았습니다귀하의 플랜에는 컨텍스트 관리, 결과 분석 또는 심층 분석이 포함되어 있지 않거나, 해당 도구가 이 키 또는 조직에 대해 비활성화되어 있습니다.AI 클라이언트에게 해당 기능 없이 계속 진행하도록 요청하거나, 더 높은 등급의 요금제를 선택하거나, 관리자에게 해당 도구를 활성화하도록 요청하세요.
MCP_RESULT_EXPIRED보류된 결과가 더 이상 보류되지 않습니다. 만료되었거나, 해제되었거나(새로운 결과를 위한 공간을 확보하기 위해 조기에 해제되는 경우도 있음), 에이전트가 재시작되었습니다.AI 클라이언트에게 보류 옵션을 추가하여 쿼리를 다시 실행하도록 요청하세요.
MCP_윈도우_예산현재 에이전트는 해당 크기의 결과를 유지할 수 없거나, 후속 작업에 필요한 메모리가 허용된 메모리보다 많을 수 있습니다.보류된 결과를 해제하거나 필터를 사용하거나 열 수를 줄여 쿼리 범위를 좁힐 수 있습니다.
MCP_AGENT_ANALYSIS_DISABLED해당 에이전트 또는 커넥터에서 보류된 결과 및 분석 기능이 비활성화되어 있습니다.관리자에게 활성화해달라고 요청하세요. 국소 분석 데이터 에이전트 페이지에서 분석을 허용하거나 커넥터에서 분석을 허용하십시오.
MCP_WINDOW_SQL_REJECTED후속 작업은 보류된 결과에 대한 읽기 전용 SELECT 쿼리가 아니거나 결과에 없는 열을 지정하는 쿼리가 아니었습니다.해당 결과에 대해 열 이름을 사용하여 하나의 SELECT 쿼리를 요청하십시오.
MCP_AGENT_VERSION_TOO_OLD에이전트가 결과를 형성, 프로파일링, 유지 또는 분석하기 전에 업데이트가 필요합니다.에이전트를 업데이트하세요. 데이터 → 데이터 에이전트한편, 일반 쿼리는 계속해서 작동합니다.
읽기 전용 위반해당 SQL 문은 SELECT 문이 아니었습니다.의도된 설계입니다. MCP를 통해서는 아무것도 기록되지 않습니다.

사람들이 묻는 질문

새로운 로그 라인이 얼마나 빨리 표시되나요?

새로운 라인은 기본적으로 매시간 스캔할 때마다 감지됩니다. 스캔 간격반쯤 쓰인 마지막 줄이 다음 스캔을 기다리고 있습니다. 첫 번째 읽기는 30일 전으로 거슬러 올라갑니다. 되메우기(일)파일당 최대 64MiB를 읽습니다. 클로드는 마지막 스캔 시점의 데이터를 확인합니다.

어떤 머신 프로파일이 알람, 사이클 및 OEE 테이블을 생성합니까?

MTConnect SHDR 및 CNC 컨트롤러 시스템 로그는 5개의 파생 테이블을 모두 생성합니다. Haas, Okuma, Mitsubishi 및 기타 여러 제품은 알람만 생성합니다. PLC 키=값 텔레메트리는 아무런 로그도 생성하지 않습니다. 누락된 로그 유형이 있는 경우 지원 요청을 제출하십시오.

구문 분석에 실패한 줄은 어떻게 되나요?

그것들은 보관되어 있습니다. events_raw_lines 원래 줄과 문법 불일치, 디코딩 불가, 널 바이트 등의 이유가 함께 표시됩니다. 아무것도 삭제되지 않습니다. 카운트가 크다는 것은 일반적으로 잘못된 것임을 의미합니다. 로그 유형 선택되었습니다.

클로드가 내 파일을 읽나요?

아니요. 에이전트는 자체 컴퓨터에서 데이터를 읽고 로컬 캐시에 행을 저장합니다. 클로드는 쿼리 스트림으로 SQL 쿼리를 보내고, 에이전트는 해당 캐시에 대해 쿼리를 실행한 후 질문에 필요한 행만 다시 전송합니다. 클로드는 파일을 열거나 변경, 이동 또는 삭제할 수 없습니다.

포트를 열어야 하나요, 아니면 VPN을 실행해야 하나요?

아니요. 에이전트는 443번 포트로 하나의 아웃바운드 연결을 생성하며, 모든 요청과 행은 해당 포트를 통해 전송됩니다. 아웃바운드 HTTPS 연결이 정상적으로 작동한다면, 이 방식도 정상적으로 작동합니다.

해당 폴더가 네트워크 공유 폴더나 OneDrive 또는 Dropbox에 있을 수 있나요?

공유 폴더는 에이전트의 컴퓨터가 해당 폴더를 열 수 있는 한 작동합니다. 다음과 같이 입력하세요. \\서버\공유\폴더에이전트가 서비스로 실행되므로 로그인에 매핑된 드라이브를 볼 수 없기 때문입니다. Windows에서는 폴더의 공유 로그인 정보를 추가하세요. 신임장 공유 폴더에 지정된 사용자만 접근할 수 있도록 하려면 해당 열을 사용하세요. Linux 또는 Mac에서는 먼저 공유 폴더를 마운트해야 합니다(저장된 로그인 정보는 사용되지 않습니다). 동기화된 클라우드 폴더의 경우, 파일을 이 장치에 보관하도록 설정하세요. 에이전트는 클라우드 자리 표시자 파일을 건너뜁니다.

무료 플랜으로 이 모든 기능을 이용할 수 있나요?

네. 무료 플랜은 만료되는 체험판이 아니라 계속 사용할 수 있는 플랜입니다. MCP는 모든 플랜에 포함되어 있으며, 무료 플랜에서는 키 하나 또는 연결된 앱 하나와 분당 30통의 통화가 허용됩니다. 폴더 커넥터 자체에는 파일 수 제한이 없습니다. 무료 플랜에 포함된 내용을 자세히 확인해 보세요. 가격 페이지.

클로드 외에 어떤 AI 도구가 효과가 있나요?

HTTP를 통해 MCP를 사용하는 모든 도구(ChatGPT, Cursor, Copilot이 포함된 VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev 및 JetBrains AI)는 포털의 AI 클라이언트 연결 가이드에서 바로 사용할 수 있는 레시피를 제공합니다.

아직도 막히셨나요? 열려 있는 지원 쿼리 스트림에서 현재 단계와 표시되는 내용을 알려주시면 연결해 드리겠습니다.
동일한 머신 로그 연결을 통해 다음 정보도 제공됩니다.엑셀과 구글 시트자동화REST APIMCP 설정 전체 가이드

모든 가이드 Machine Logs

원하는 설정이 아닌가요?

  • 사용하시는 로그 형식이 미리 만들어진 로그 유형 중 하나가 아닌가요? 사용자 지정 로그 폴더를 사용하면 형식을 직접 정의할 수 있습니다 → Custom Logs
  • 이것들은 CutRite 부품 목록 및 절단 패턴이지 기계 출력물이 아닌가요? 다중 레코드 CSV 읽기 → Multi-record

설치에 문제가 있으신가요?

  • 에이전트에서 파일이나 폴더가 존재하지 않거나 액세스가 거부되었다고 표시되나요? 매핑된 드라이브, 네트워크 공유, OneDrive 및 Linux 홈 폴더 각각에 대한 해결 방법이 다릅니다. → 에이전트가 파일을 읽을 수 있는 위치
  • 에이전트가 오프라인으로 표시되거나, 연결 테스트 및 찾아보기 옵션이 비활성화되어 있습니까? 에이전트가 온라인 상태인지 확인하십시오. 상담원이 온라인 상태인가요?
Updated on 11월 9, 2026

Powered by BetterDocs