Query Streams를 Claude에 연결하고 데이터베이스에 대해 일반적인 언어로 질문하세요. Claude는 스키마, 저장된 쿼리 및 기타 정보를 읽습니다. 의미 지능 모델은 실시간으로 실행되며, 네트워크 에이전트를 통해 읽기 전용 SQL을 실행하고 데이터베이스 암호를 전혀 볼 필요가 없습니다. AI 클라이언트가 암호를 요청하면, 네트워크 에이전트(네트워크 내부의 파트너)가 데이터가 있는 곳에서 필요한 작업을 처리합니다. 이 가이드는 claude.ai, Claude Desktop, ChatGPT, Claude Code를 비롯한 모든 MCP 클라이언트에 적용됩니다.
간략 버전. 설치하세요 네트워크 에이전트 데이터베이스 옆에 커넥터를 추가하세요(몇 분 정도 소요). 그런 다음 엽니다. 쿼리 스트림 목록 Anthropic의 커넥터 디렉토리에서 클릭하세요. 연결하다Query Streams 동의 화면에서 권한을 승인하고 Claude에게 문의하세요. “제가 접근할 수 있는 데이터베이스는 무엇인가요?” Claude는 에이전트가 제공하는 데이터만 볼 수 있습니다. 에이전트를 건너뛰면 커넥터가 없다는 메시지가 표시됩니다.
시작하기 전에
네 가지가 필요합니다. Claude 내부에서 Query Streams를 찾았다면 에이전트와 커넥터 두 가지를 설정해야 합니다.
MCP를 포함하는 계획
MCP는 무료 플랜을 포함한 모든 플랜에서 사용할 수 있습니다. 플랜에 따라 보유할 수 있는 키 또는 연결된 앱의 수, AI 클라이언트가 분당 수행할 수 있는 호출 횟수, 쿼리당 반환되는 행 수, 그리고 분석 도구 세트 포함 여부가 결정됩니다. 각 플랜에 포함되는 내용.
온라인 상태인 네트워크 에이전트
에이전트는 데이터베이스 옆에 위치하여 쿼리 스트림으로 나가는 연결을 하나 설정하는 작은 서비스입니다. 새 계정이신가요? 지금 바로 설치하세요. my.querystreams.com/download몇 분 후 윈도우, macOS 또는 리눅스팀에서 이미 포털, Excel 또는 Google Sheets에서 쿼리를 실행하고 있다면 이미 설치되어 있습니다.
적어도 하나의 커넥터
커넥터는 포털에 등록된 데이터베이스 또는 API 소스입니다. 클로드는 사용자가 부여한 권한에 따라 사용자 계정에서 볼 수 있는 모든 커넥터를 볼 수 있습니다.
사용자 계정에 대한 MCP 액세스 권한
조직 생성자와 소유자는 MCP 접근 권한이 자동으로 부여됩니다. 다른 사용자는 관리자의 승인을 받아야 합니다. MCP 이름 옆에 계정 → 접근 제어.
작동 방식
Claude는 데이터베이스에 직접 연결하지 않습니다. 클라우드에 있는 Query Streams MCP 서버와 통신하며, 이 서버는 네트워크 에이전트가 이미 열어 놓은 단일 아웃바운드 연결을 통해 각 요청을 전달합니다. 에이전트는 쿼리를 로컬에서 실행하고 동일한 방식으로 결과를 다시 전송합니다. 요청과 결과는 에이전트가 시작한 이 단일 채널을 통해 양방향으로 흐르므로 방화벽에서 아무것도 열 필요가 없습니다.
OAuth, 스코프, 감사, 속도 제한
하나의 아웃바운드 TLS 연결
그 설계에서 세 가지 속성이 도출됩니다.
- 클로드에게는 아무런 자격증이 없습니다. 데이터베이스 연결 문자열은 에이전트에 저장됩니다. Claude는 OAuth 권한 또는 MCP 키만 보유하며, 포털에서 한 번의 클릭으로 둘 다 취소할 수 있습니다.
- 읽기 전용이며, 에이전트에서 적용됩니다. 오직
선택,와 함께그리고설명하다진술은 허용됩니다. 검사는 클라우드나 Claude가 아닌 연결의 사용자 측에서 이루어집니다. - 모든 것이 기록됩니다. 모든 툴 호출은 MCP 페이지에 표시됩니다. 활동 탭과 쿼리 기록의 모든 쿼리는 접속한 사용자에게 귀속됩니다.
AI 클라이언트를 연결하세요
포털의 MCP 페이지(스트림 → 라이브 → MCP)에는 네 개의 탭이 있습니다. 연결, 문맥, 도구 그리고 관리자의 경우, 활동Connections에서 AI 클라이언트를 연결하세요 버튼을 누르면 4단계 가이드가 열립니다. 귀사의 AI 클라이언트는 어떻게 연결될까요?, AI 클라이언트를 선택하세요, 설정하세요 그리고 연결 상태를 확인하세요로그인 방법은 두 가지입니다. 채팅 앱은 앱 내에서 승인하며 별도의 키가 필요하지 않습니다. 개발자 도구는 MCP 키를 사용합니다. 두 방법 모두 동일한 서버와 동일한 도구를 사용합니다.
옵션 A: claude.ai, Claude Desktop 및 ChatGPT (앱에서 승인, 키 필요 없음)
인류 연결망 디렉토리에 등재되어 있습니다. Query Streams는 승인된 커넥터입니다. claude.ai/directory/query-streams목록을 열고 클릭하세요. 연결하다 승인만 하면 되며, 서버 URL은 필요하지 않습니다. URL을 통한 추가는 디렉터리 커넥터 사용을 제한하는 Claude 조직의 경우 대체 방법입니다.
- 열기 쿼리 스트림 목록 클릭하고 클릭하세요 연결하다커넥터는 Claude 계정과 동기화되므로 Claude Desktop에서 해당 커넥터를 확인할 수 있습니다. + → 커넥터. 상품 목록이 보이지 않나요? 조직에서 디렉터리 커넥터 사용을 제한할 수 있습니다. 설정 → 커넥터 딸깍 하는 소리 사용자 지정 커넥터 추가이름을 지어주세요 쿼리 스트림, 반죽
https://mcp.querystreams.com/mcp그런 다음 채팅에서 클릭하세요 +, 선택하다 쿼리 스트림 클릭하고 클릭하세요 연결하다. - 새 브라우저 탭에서 Query Streams 동의 화면이 열립니다. 로그인하라는 메시지가 표시되면 로그인하고, 조직을 선택하고, 권한을 검토한 후(아래 참조), 클릭하세요. 연결 승인.
- 클로드에게 돌아가면 알게 될 거예요. 쿼리 스트림에 연결됨클로드가 도구를 처음 사용할 때 권한을 요청합니다. 선택하세요. 항상 허용하세요 따라서 매번 통화할 때마다 알림 없이 작동할 수 있습니다.
이 커넥터는 특정 기기가 아닌 Claude 계정에 연결되어 있으므로 Claude 모바일 앱과 Claude 데스크톱에 자동으로 표시됩니다. 포털에서 언제든지 관리하거나 연결을 해제할 수 있습니다. MCP → 연결 꼬리표.
채팅GPT. 앱 자체에서 쿼리 스트림을 추가하려면 현재로서는 ChatGPT 설정에서 개발자 모드를 켜고 거기에서 연결을 생성한 다음 클릭하면 됩니다. Query Streams로 로그인하세요 동일한 동의 화면에서 승인하는 방식입니다. 포털 가이드에는 현재 ChatGPT 절차가 나와 있으며, 공식 ChatGPT 목록은 곧 제공될 예정입니다.
"마켓플레이스 추가"와는 다릅니다. Claude Desktop의 채팅 기능 + → 커넥터 찾아보기 → 마켓플레이스 추가 해당 옵션은 MCP 서버 URL이 아닌 플러그인 마켓플레이스용 Git 저장소를 요구합니다. 목록의 URL을 사용하세요. 연결하다 버튼, 또는 설정 → 커넥터 → 추가 URL 경로의 경우.
옵션 B: Claude Code, Cursor 및 기타 개발자 도구(MCP 키)
개발자 도구는 포털에서 생성하여 전달하는 키를 사용하여 인증합니다. X-MCP-키 헤더.
- 로그인하세요 my.querystreams.com, 열려 있는 MCP 클릭하고 클릭하세요 AI 클라이언트를 연결하세요. 선택하다 설정 파일에서 키를 사용하세요 그리고 도구를 선택하세요.
- 클릭 키를 생성하세요 도구에 이름을 붙이세요. 도구와 기계의 이름을 따서 지으면 됩니다. 예를 들어, 클로드 코드 랩톱, 유지하다 읽다 그리고 쿼리를 실행합니다만료일을 선택하세요. 나중에 키를 다시 확인하고 복사할 수 있습니다. 연결 탭. 키는 이렇게 생겼습니다.
qsmcp_그 뒤에 43개의 문자가 이어집니다. - 설정하세요 Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue, Cline 등에서 바로 붙여넣을 수 있는 설정 화면을 보여주며, 키가 이미 입력되어 있습니다. Claude Code의 경우 한 번의 명령으로 설정할 수 있습니다.
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - 연결 상태를 확인하세요 해당 키에서 첫 번째 전화가 오기를 기다렸다가 말합니다. 연결됨.
언제든지 확인하려면 문의하십시오. “내가 보유한 Query Streams 커넥터는 무엇인가요?” 고객은 전화해야 합니다. qs_list_connectors그리고 열쇠는 마지막 사용 연결 탭의 시간은 몇 초 내에 업데이트됩니다.
권한
OAuth를 사용하든 키를 사용하든, 접근 권한은 세 가지 범위로 제어됩니다. 동의 화면에 이러한 범위가 표시되며, 이를 기반으로 키가 생성됩니다.
| 범위 | 클로드가 할 수 있는 일 | 언제 승인해야 할까요? |
|---|---|---|
| 읽다 | 커넥터와 에이전트를 나열하고, 스키마를 탐색하고, Semantic Intelligence 설명과 저장된 열 프로필 및 관계를 읽고, 저장된 쿼리와 알림 규칙을 나열합니다. | 언제나 그렇죠. 다른 모든 것은 그것을 기반으로 합니다. |
| 분석하다 | Network Agent에서 테이블을 프로파일링하거나 실시간으로 암시적 관계를 검색하고 Semantic Intelligence 실행을 대기열에 추가합니다. 이 기능이 없으면 AI 클라이언트에 Semantic Intelligence 실행을 시작하는 도구가 표시되지 않습니다. | 권장 사항입니다. 이렇게 하면 Claude가 조인을 작성하기 전에 데이터의 형태를 이해할 수 있습니다. |
| 실행하다 | 다음과 같이 표시됩니다 쿼리 실행(읽기 전용)읽기 전용 SQL 및 저장된 쿼리를 실행하고 행을 스트리밍 방식으로 반환합니다. 결과를 저장하고 후속 분석 도구를 사용하여 결과를 분석합니다. | 단순히 구조를 살펴보는 것뿐만 아니라 답변을 얻고자 하는 사람들을 위한 것입니다. 탐색 전용 키의 경우 해당 기능을 비활성화하세요. |
연결된 앱은 승인 시 특정 커넥터로 제한할 수 있으며, 생성된 키는 조직 내 모든 커넥터에 적용됩니다. 권한 또는 키를 취소하면 약 5분 이내에 효력이 발생합니다. 관리자는 연결 탭에서 조직의 모든 활성 권한 및 키를 확인할 수 있습니다.
AI 클라이언트가 연결되면 할 수 있는 일
AI 클라이언트는 쿼리 스트림 도구를 살펴보고 질문에 가장 적합한 도구를 선택합니다. 사용자는 직접 도구를 호출할 필요가 없습니다. 포털의 도구 탭 모든 도구와 모드, 각 도구의 기능, 사용 중인 요금제에 포함된 항목을 나열합니다.
데이터에 관한 질문이 있으면 Query Streams가 AI 클라이언트를 네 단계로 안내합니다. 커넥터를 나열하고, 데이터베이스의 테이블을 읽고, 쿼리할 각 테이블의 열을 읽은 다음, 읽기 전용 쿼리를 실행합니다. 열을 먼저 읽으면 이름을 추측하지 않게 됩니다. Free를 포함한 모든 요금제에서 사용할 수 있습니다:
데이터를 매핑하세요
커넥터, 데이터베이스 및 에이전트 목록을 표시합니다. 테이블 및 열 설명, 의미 유형, 샘플 값, 열거형 레이블, 선언된 관계 및 검색된 관계를 포함하여 모든 데이터베이스의 스키마 트리를 읽습니다.
프로필을 살펴보고 둘러보세요.
필터를 작성하기 전에 테이블 프로파일링을 통해 실제 값 분포를 확인하세요. 외래 키가 선언되지 않은 테이블 간의 조인을 찾아보세요.
읽기 전용 SQL을 실행합니다.
커넥터에 맞는 방언으로 읽기 전용 SQL을 작성하고 실행하세요. 기본 시간 초과는 60초이며 최대 5분까지 설정할 수 있습니다. 실행 계획에 따라 쿼리가 반환하는 행 수가 결정됩니다.
저장된 쿼리, 연동 및 알림
조직에 저장된 매개변수화된 쿼리를 새 값으로 실행하세요. 여러 소스에 걸쳐 있는 연합 쿼리는 이미 결합된 상태로 반환됩니다. 알림 규칙과 최근 실행 내역을 확인하고, 모의 실행 모드에서 새 규칙을 제안해 보세요.
분석 도구 세트
유료 플랜에서는 네트워크 에이전트가 데이터가 존재하는 곳에서 기초 작업을 수행합니다. 측정, 프로파일링, 저장 및 결과 분석을 통해 AI 클라이언트가 각 질문에 대해 이미 준비된 컨텍스트를 가지고 접근하여 사고 과정에 집중할 수 있도록 합니다. 무료 플랜은 기존과 동일하게 표준 결과를 제공합니다. 자세한 내용은 다음을 참조하세요. AI 클라이언트를 사용하여 데이터를 분석하세요..
컨텍스트 관리
개인 핵심 역량 이상. 결과를 읽기 전에 크기를 확인하세요.모양): 열, 행 예상 비용 및 토큰 비용, 행 없음. 대규모 데이터베이스를 영역별로 탐색합니다(스키마 레벨답변은 정해진 예산 내에서만 하세요. 컬럼 그리고 필요한 텍스트 셀 길이입니다.
당신이 통제권을 유지합니다. 그만큼 컨텍스트 탭 텍스트 셀 제한, 대규모 데이터베이스용 스키마 보기, 결과 크기 및 분석 기본값을 설정하고 AI 클라이언트가 수신하는 내용을 보여줍니다. 또한 각 에이전트가 보유하고 있는 결과 목록도 표시합니다. 각 키로 기본값을 재정의할 수 있으며, 모든 호출은 활동 탭에서 확인할 수 있고, 관리자는 이 기능을 활성화/비활성화할 수 있습니다. 국소 분석 에이전트를 위해 휴가를 냈습니다. 데이터 → 데이터 에이전트.
플랜에 포함된 내용
MCP는 무료 플랜을 포함한 모든 플랜에 포함되어 있으며, 무료 플랜은 만료되지 않습니다.
| 계획 | 사용자별 키 개수 | 조직별 키 개수 | 분당 통화 횟수 | 쿼리당 행 수 | 분석 도구 세트 | 결과 발표 |
|---|---|---|---|---|---|---|
| 무료 | 1 | 1 | 30 | 1,000 | 표준 결과 | 없음 |
| 개인적 핵심 | 1 | 1 | 60 | 2,500 | 컨텍스트 관리, 결과 분석 | 15분, 128MB |
| 퍼스널 플러스 | 1 | 1 | 90 | 5,000 | 컨텍스트 관리, 결과 분석 | 15분, 128MB |
| 비즈니스 코어 | 2 | 3 | 120 | 10,000 | 맥락 관리, 결과 분석, 심층 분석 | 60분, 512MB |
| 비즈니스 플러스 | 3 | 5 | 150 | 25,000 | 세 명 모두 | 60분, 512MB |
| 비즈니스 맥스 | 5 | 10 | 240 | 50,000 | 세 명 모두 | 60분, 512MB |
| 엔터프라이즈 코어 | 5 | 25 | 300 | 100,000 | 세 명 모두 | 8시간, 4,096MB |
| 엔터프라이즈 플러스 | 8 | 50 | 450 | 100,000 | 세 명 모두 | 8시간, 4,096MB |
| 엔터프라이즈 맥스 | 10 | 100 | 600 | 100,000 | 세 명 모두 | 8시간, 4,096MB |
연결된 앱은 하나의 키로 간주됩니다. 모든 요금제에서 하나의 키는 분당 최대 10개의 쿼리를 실행할 수 있습니다. 쿼리당 행 수는 하나의 쿼리가 AI 클라이언트에 반환하는 최대 행 수를 의미합니다. 더 많은 행을 요청하면 요금제 제한에 도달했음을 알리고 오류를 발생시키지 않습니다. 보류된 결과는 요금제에서 정한 시간 및 크기 내에서, 에이전트 컴퓨터의 처리 능력에 따라 후속 질문을 위해 보관됩니다. 모든 요금제를 나란히 비교해 보세요. 가격.
여기서 시맨틱 인텔리전스가 중요한 이유
클로드가 받는 모든 응답에는 세 가지 등급 중 어느 등급에서 왔는지 태그가 지정되며, 클로드는 자신이 보는 내용을 얼마나 신뢰하는지 조정합니다.
| 층 | 클로드가 보는 것 | 결과 |
|---|---|---|
| 의미 지능 | 각 테이블과 열에 대한 설명, 의미 유형, 열거형 레이블, 샘플 값, 팩트 및 차원 분류, 선언 및 발견된 조인이 포함됩니다. | 클로드는 첫 시도에 실무 수준의 SQL 쿼리를 작성하고 데이터를 비즈니스 용어로 설명해 줍니다. |
| 캡처된 스키마 | 테이블 및 컬럼 이름, 데이터 유형, 기본 키, 인덱스, 선언된 외래 키. | 클로드는 일을 하지만 이름에서 의미를 추론해야 하고 추가 질문이 필요할 수도 있습니다. |
| 라이브 스키마 | 해당 데이터베이스는 커넥터의 캡처 선택 항목에 포함되어 있지 않으므로 구조는 요청이 있을 때마다 카탈로그에서 실시간으로 읽어옵니다. | 쿼리는 계속 실행됩니다. 클로드는 필요에 따라 샘플 SELECT 문을 사용하여 탐색합니다. |
팀에 중요한 데이터베이스라면 시맨틱 인텔리전스를 한 번 실행해 보세요. 대규모 데이터베이스의 경우, 쿼리에서 실제로 사용하는 테이블만 선택하여 실행 범위를 좁히세요. 시맨틱 인텔리전스는 어떻게 작동할까요? →
예시 프롬프트
이미 답을 알고 있는 것부터 시작하세요. 그런 다음 추가 질문을 하세요. 클로드는 맥락을 유지합니다.
내가 접근할 수 있는 데이터베이스와 테이블은 무엇이며, 그중에서 시맨틱 인텔리전스가 적용된 것은 무엇인가요?연결 고리를 파악하고 답변이 가장 유력한 지점을 알려줍니다. 판매 데이터베이스에서 고객과 주문 간의 관계를 보여주고, 주문 상태 열을 프로파일링해 주세요.관계 및 열 프로파일링을 사용합니다. 클로드가 실제 상태 코드와 그 의미를 보여줄 것입니다. 저장된 쿼리 "지역별 월별 매출"을 올해 2분기에 대해 실행하세요.자체적인 SQL 쿼리를 생성하는 대신, 매개변수를 사용하여 신뢰할 수 있는 저장된 쿼리를 실행합니다. 지난 90일간 매출 기준 상위 10개 제품을 나열하고, 그 결과를 판매 채널별로 세분화해 주세요.커넥터의 방언으로 임시 SQL 쿼리를 실행한 후 동일한 스레드에서 후속 쿼리를 실행합니다. 결과 분석이 포함된 실행 계획에서는 후속 쿼리가 보류된 결과에서 실행될 수 있으며 두 번째 쿼리가 필요하지 않습니다. 어떤 알림 규칙이 설정되어 있으며, 이번 주에 해당 규칙 중 하나라도 실행되었습니까?경보 규칙과 최근 상태를 읽습니다.더 나은 답변을 위한 팁
- Claude Project를 사용하세요. Query Streams 커넥터를 프로젝트에 연결하고 프로젝트 지침에 비즈니스 규칙을 입력하세요. 기본적으로 사용할 데이터베이스, 공식 정의로 사용할 저장된 쿼리, 명명 규칙 등을 명시하면 됩니다. Claude는 스키마를 실시간으로 읽기 때문에 지침은 간결하게 작성하면 됩니다.
- 중요하다고 생각하는 쿼리를 저장하세요. Claude는 저장된 쿼리를 먼저 참조하므로 "활성 고객"은 팀에서 정의한 의미를 갖습니다.
- 분석 범위를 허용합니다. 필터링하기 전에 열을 프로파일링하는 것은 상태 코드를 추측하는 것과 올바른 상태 코드를 사용하는 것의 차이를 만듭니다.
- 차트를 요청하세요. claude.ai는 Claude가 반환하는 행들을 기반으로 차트를 렌더링합니다.
비용이 얼마나 드는지
MCP 자체는 어떤 요금제에도 별도의 수수료를 부과하지 않습니다. 단, 두 가지 항목에 대해서만 요금이 부과됩니다.
- 데이터 용량. Claude에 반환되는 쿼리 결과는 Excel, Google Sheets, Portal 및 Nova 사용량과 동일한 데이터 영역 예산에 포함됩니다. MCP를 통한 결과는 전송 압축 전 Claude에 전달되는 모든 바이트(결과, 스키마 읽기 및 보류된 결과 페이지)를 기준으로 측정됩니다. AI 클라이언트는 압축되지 않은 데이터를 받기 때문입니다. 스프레드시트, Portal 및 API 결과는 Network Agent가 전달하는 압축된 결과를 기준으로 계산됩니다. 실패한 응답은 계산에 포함되지 않습니다. 탐색적 질문은 작게 유지하세요. Context management가 포함된 요금제에서는 먼저 Claude에 결과의 크기를 확인하도록 요청하면(mode: shape) 필요하지 않은 행을 가져오는 일을 피할 수 있습니다.
- 시맨틱 인텔리전스가 실행 중입니다. Claude를 통해 분석을 대기열에 추가하면 포털에서 직접 실행하는 것과 마찬가지로 조직에 AI 크레딧이 청구됩니다. Claude는 청구하기 전에 사용자에게 확인을 요청합니다.
문제 해결
| 당신이 보는 것 | 그것이 의미하는 바는 | 고치다 |
|---|---|---|
| 클로드는 커넥터도 없고 네트워크 에이전트도 없다고 말합니다. | 귀하의 계정에는 아직 에이전트가 실행 중이지 않거나, 에이전트에 데이터 소스가 추가되지 않았습니다. | 에이전트를 설치하려면 다음에서 설치하세요. my.querystreams.com/download커넥터를 아래에 추가하세요 데이터 → 데이터 에이전트 → 커넥터 추가그럼 다시 물어보세요. |
| Claude는 Query Streams 도구를 표시하지 않습니다. | 커넥터가 추가되었지만 채팅에서 연결되지 않았거나 OAuth 승인이 완료되지 않았습니다. | 채팅을 열고 클릭하세요 +쿼리 스트림을 선택하세요. 연결하다그리고 동의 화면을 완료하세요. |
MCP_KEY_필수 또는 401 | 서버에 키 또는 권한 부여 정보가 전송되지 않았습니다. 키 클라이언트의 경우, 이는 일반적으로 줄 바꿈 문자가 뒤에 있거나 키가 잘못된 헤더에 있는 등의 복사 붙여넣기 오류 때문입니다. | 키를 다시 복사하세요 X-MCP-키 헤더. claude.ai의 경우 + 메뉴에서 다시 연결하세요. |
MCP_토큰_만료됨 | OAuth 토큰이 일정 시간 동안 사용되지 않아 만료되었습니다. | Claude는 일반적으로 자동으로 새로 고쳐집니다. 그렇지 않은 경우 커넥터를 분리했다가 다시 연결하십시오. |
MCP_KEY_REVOKED 또는 MCP_사용자_비활성화됨 | 키가 취소되었거나 해당 사용자의 MCP 액세스가 비활성화되었습니다. | 새 키를 생성하거나 관리자에게 MCP를 다시 활성화해달라고 요청하세요. 계정 → 접근 제어. |
MCP_SCOPE_REQUIRED | 보조금이나 열쇠에는 해당 조치를 취할 수 있는 범위가 부족한 경우가 대부분입니다. 실행하다 (쿼리를 실행합니다). | 누락된 범위를 다시 연결하고 승인하거나, 해당 범위를 포함하는 키를 생성하십시오. |
MCP_PLAN_LAPSED | 귀 기관의 구독이 만료되었습니다. | 포털의 MCP 페이지에는 현재 계획 상태와 향후 진행 방향이 나와 있습니다. |
MCP_에이전트가 연결되지 않았습니다 | 커넥터를 소유한 네트워크 에이전트가 현재 연결되어 있지 않습니다. | 확인하다 데이터 에이전트 포털에서 에이전트 서비스를 호스트에서 시작하십시오. |
MCP_CONNECTOR_NOT_ALLOWED | 해당 연결 앱은 승인 당시 특정 커넥터로 제한되었으며, 이 앱은 그 제한에 포함되지 않습니다. | 앱을 다시 연결하고 쿼리 스트림 동의 화면에서 더 넓은 액세스 권한을 승인하세요. |
MCP_데이터베이스_캡처되지 않음 | 해당 데이터베이스가 커넥터의 스키마 캡처 선택 항목에 포함되어 있지 않으므로 읽을 수 있는 시맨틱 인텔리전스 또는 저장된 관계가 없습니다. 하지만 쿼리는 여전히 작동합니다. | 포털의 커넥터에서 캡처 선택 항목에 데이터베이스를 추가한 다음, 선택적으로 시맨틱 인텔리전스를 실행합니다. |
MCP_RATE_LIMITED | 사용하시는 요금제에 비해 분당 통화량이 너무 많습니다. | 잠시만 기다려 주세요. 통화량이 많은 세션은 시맨틱 인텔리전스 덕분에 클로드가 더 적은 통화로 응답할 수 있습니다. |
MCP_QUERY_TIMEOUT | 쿼리가 기본값인 60초의 시간 초과를 초과했습니다. | 클로드에게 필터를 추가하거나 행 제한을 낮추거나 높여달라고 요청하세요. 타임아웃초 최대 300개. |
MCP_OUTPUT_TOO_LARGE | 결과값이 너무 커서 한 번의 응답으로 AI 클라이언트에게 전달할 수 없었습니다. | 열이나 행의 수를 줄여달라고 요청하세요. 컨텍스트 관리 기능이 있는 요금제에서는 먼저 결과 크기를 조정해달라고 요청하세요. |
MCP_기능이_포함되지 않았습니다 | "귀하의 계획에는 컨텍스트 관리, 결과 분석 또는 심층 분석이 포함되어 있지 않거나, 해당 키 또는 조직에 대해 도구가 비활성화되어 있습니다." | AI 클라이언트에게 해당 기능 없이 계속 진행하도록 요청하거나, 더 높은 등급의 요금제를 선택하거나, 관리자에게 해당 도구를 활성화하도록 요청하세요. |
MCP_RESULT_EXPIRED | 보류된 결과는 더 이상 보류되지 않습니다. 만료되었거나, 해제되었거나(새로운 결과를 위한 공간을 확보하기 위해 조기에 해제되는 경우도 있음), 또는 에이전트가 재시작되었습니다. | AI 클라이언트에게 보류 옵션을 추가하여 쿼리를 다시 실행하도록 요청하세요. |
MCP_윈도우_예산 | 에이전트가 현재 해당 크기의 결과를 저장할 수 없거나, 후속 작업에 필요한 메모리가 저장된 결과에 허용되는 메모리보다 많을 수 있습니다. | 보류된 결과를 해제하거나 필터를 사용하거나 열 수를 줄여 쿼리 범위를 좁힐 수 있습니다. |
MCP_AGENT_ANALYSIS_DISABLED | 해당 에이전트 또는 해당 커넥터에서 보류된 결과 및 분석 기능이 비활성화되어 있습니다. | 관리자에게 활성화해달라고 요청하세요. 국소 분석 데이터 에이전트 페이지의 에이전트에 대해 분석을 허용하거나 커넥터에서 분석을 허용합니다. |
MCP_WINDOW_SQL_REJECTED | 후속 작업은 보류된 결과 테이블에 대한 읽기 전용 SELECT 쿼리가 아니거나, 결과에 없는 열을 지정하는 것이었습니다. | 해당 결과에 대해 열 이름을 사용하여 하나의 SELECT 쿼리를 요청하십시오. |
MCP_AGENT_VERSION_TOO_OLD | 에이전트가 결과를 형성, 프로파일링, 유지 또는 분석하기 전에 업데이트가 필요합니다. | 에이전트를 업데이트하세요. 데이터 → 데이터 에이전트그동안 일반 쿼리는 계속 작동합니다. |
| 열 이름이나 테이블 이름 오류로 쿼리가 실패함 | AI 클라이언트가 먼저 테이블을 읽는 대신 이름을 추측했습니다. | 대개 아무것도 아닙니다. AI 클라이언트가 받는 오류에는 해당 테이블의 실제 열이나 이름이 비슷한 테이블이 나열되므로, 다음 시도에서 쿼리를 수정할 수 있습니다. 계속 이름을 추측한다면 먼저 테이블의 열을 읽으라고 요청하세요. |
| 읽기 전용 위반 | SQL에는 다음 이외의 내용이 포함되어 있었습니다. 선택, 와 함께 또는 설명하다. | 의도적으로 그렇게 설계되었습니다. MCP를 통한 쓰기는 절대 허용되지 않습니다. |
여전히 문제가 해결되지 않았나요? 이메일로 문의하세요. [email protected].
보안 및 개인정보 보호
- 클로드는 스키마 메타데이터, 샘플 값을 포함한 시맨틱 인텔리전스 설명, 그리고 사용자가 요청한 쿼리 결과를 수신합니다. 분석 도구 세트를 사용하는 경우, 종종 크기 추정치, 프로필 또는 보류된 결과 답변을 대신 수신하며, 전체 결과는 에이전트에 저장됩니다. 클로드가 수신한 정보는 사용자가 연결하도록 선택한 AI 제공업체의 약관에 따라 해당 제공업체로 전송됩니다.
- Query Streams는 Claude와의 대화를 수신하거나 저장하지 않습니다.
- OAuth 권한 및 키는 사용자별, 조직별로 부여됩니다. 관리자는 MCP 페이지에서 모든 권한 및 키를 확인하고 취소할 수 있습니다.
- 자세한 내용은 저희 웹사이트에서 확인하실 수 있습니다. 개인정보 보호정책 그리고 서비스 약관.
자주 묻는 질문
포트를 열어야 하나요, 아니면 VPN을 실행해야 하나요?
아니요. 에이전트는 443번 포트를 통해 하나의 아웃바운드 TLS 연결을 설정합니다. 아웃바운드 HTTPS 연결이 작동하면 MCP도 작동합니다.
클로드가 내 데이터를 변경할 수 있나요?
아니요. 에이전트는 읽기 명령만 허용합니다. Claude는 시뮬레이션 모드에서 의미론적 지능 실행을 대기열에 추가하고 경고 규칙을 제안할 수 있습니다. 두 작업 모두 쿼리 스트림 메타데이터에 기록되며 데이터베이스에는 절대 기록되지 않습니다.
다른 어떤 AI 도구가 효과가 있나요?
MCP를 지원하는 모든 도구: ChatGPT, Cursor, Claude Code, Windsurf, Zed, VS Code Copilot, JetBrains AI, Gemini CLI, Codex CLI, Continue, Cline 등. 포털의 AI 클라이언트를 연결하세요 가이드에는 각 항목에 대한 미리 설정된 구성이 있습니다.
보류된 결과란 무엇인가요?
결과 분석 기능이 포함된 플랜에서 AI 클라이언트는 에이전트에게 전체 결과를 일정 시간 동안 보관하도록 요청할 수 있습니다. 지역별 분석이나 다음 페이지의 행과 같은 후속 질문은 별도의 데이터베이스 쿼리 없이 해당 복사본에서 답변됩니다. 보관되는 결과의 기간과 크기는 플랜에 따라 달라집니다.
분석 도구 세트가 포함된 요금제는 무엇입니까?
상황 관리 및 결과 분석은 Personal Core 이상 등급에서 제공되며, 심층 분석은 Business Core 이상 등급에서 제공됩니다. 계획표 자세한 내용을 알고 있습니다.
이로 인해 무료 플랜이 변경되나요?
아니요. 무료 플랜은 이전과 마찬가지로 표준적인 결과를 제공합니다.
여러 조직과 호환되나요?
각 보조금 또는 키는 하나의 조직에 귀속됩니다. 필요한 조직별로 한 번씩만 연결하세요.
이것과 노바의 차이점은 무엇인가요?
Nova는 Query Streams 포털에 내장된 어시스턴트이며 동일한 시맨틱 인텔리전스 모델을 공유합니다. Query Streams 내에서 답변을 얻고 싶을 때는 Nova를 사용하고, Claude에서 수행하는 모든 작업과 함께 데이터를 Claude 내에서 사용하고 싶을 때는 MCP를 사용하십시오.
커넥터별 가이드
각 가이드는 해당 소스에 대한 예시와 함께 동일한 연결 과정을 안내합니다.
데이터베이스: Microsoft SQL Server · PostgreSQL · MySQL · MariaDB · Oracle · 눈송이 · 구글 빅쿼리 · SQLite · Microsoft Access · DuckDB · 수파베이스
아피스: 스트라이프 · Shopify · HubSpot · 구글 광고 · Google 애널리틱스 4 · Google 검색 콘솔 · ShipStation · 아이틱
파일 및 로그 폴더 (에이전트가 폴더를 스캔하고 파일을 테이블로 변환합니다.) 파일 시스템 · CSV 폴더 · 마루 폴더 · 엑셀 폴더 · SQLite 폴더 · JSONL 폴더 · 다중 레코드 CSV · 기계 로그 · 웹 서버 로그 · 컨테이너 로그 · 애플리케이션 로그 · 시스템 로그 · 사용자 지정 로그
호스팅 데이터베이스 (관리형 PostgreSQL, MySQL, MariaDB 및 SQL Server는 에이전트가 TLS를 통해 접근할 수 있습니다.) 네온 · 아마존 RDS · Azure Database for PostgreSQL · Azure Database for MySQL · Azure SQL · Google Cloud SQL · 구글 AlloyDB · DigitalOcean 관리형 데이터베이스 · 아이벤 · 크런치 브릿지 · Heroku Postgres · 세우다 · 철도 · Fly.io 포스트그레스 · Vultr 관리형 데이터베이스 · OVHcloud 관리형 데이터베이스 · 스케일웨이 관리형 데이터베이스 · PostgreSQL을 사용하는 OCI 데이터베이스 · MySQL 히트웨이브 · IBM 클라우드 데이터베이스(PostgreSQL용) · MariaDB SkySQL · 자타 · 타임스케일 클라우드 · PlanetScale Postgres · 프리즈마 포스트그레스 · 코예브 · 나일 강
Claude를 데이터에 연결하세요
에이전트를 한 번 설치하면 몇 분밖에 걸리지 않습니다. 그 후에는 클릭 한 번으로 Claude에 연결할 수 있습니다. 키도, 설정 파일도, VPN도 필요 없습니다. 읽기 전용으로 설계되었습니다.
에이전트를 설치하세요 MCP 페이지를 엽니다 MCP 작동 방식
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish