Claude에 쿼리 스트림을 연결하고 데이터베이스에 대해 평이한 언어로 질문하세요. Claude는 스키마, 저장된 쿼리 및 스키마 인텔리전스 모델을 실시간으로 읽고, 네트워크 에이전트를 통해 읽기 전용 SQL을 실행하며, 데이터베이스 암호를 절대 보지 않습니다. 이 가이드는 claude.ai, Claude Desktop 및 Claude Code를 비롯한 모든 MCP 클라이언트에 대해 다룹니다.
간략 버전. Query Streams is in the Anthropic Connectors Directory. In claude.ai open Settings → Connectors → Browse connectors, 찾다 쿼리 스트림클릭 연결하다Query Streams 동의 화면에서 권한을 승인하고 Claude에게 문의하세요. “제가 접근할 수 있는 데이터베이스는 무엇인가요?” That’s it.
시작하기 전에
네 가지가 필요합니다. 대부분의 계정에는 이미 첫 세 가지가 있습니다.
MCP를 포함하는 계획
MCP는 무료 플랜을 포함한 모든 플랜에서 이용 가능합니다. 플랜별로 달라지는 점은 보유할 수 있는 키 또는 연결된 앱의 개수와 클로드(Claude)가 분당 걸 수 있는 통화 횟수입니다. 무료 플랜에서는 키 또는 연결된 앱 1개와 분당 30통의 통화가 허용됩니다.
온라인 상태인 네트워크 에이전트
에이전트는 데이터베이스 옆에 위치하여 쿼리 스트림으로 나가는 연결을 하나 설정하는 작은 서비스입니다. 팀에서 이미 포털, Excel 또는 Google Sheets에서 쿼리를 실행하고 있다면 에이전트는 이미 설치되어 있습니다. 설치 가이드 →
적어도 하나의 커넥터
커넥터는 포털에 등록된 데이터베이스 또는 API 소스입니다. 클로드는 사용자가 부여한 권한에 따라 사용자 계정에서 볼 수 있는 모든 커넥터를 볼 수 있습니다.
사용자 계정에 대한 MCP 액세스 권한
조직 생성자와 소유자는 MCP 접근 권한이 자동으로 부여됩니다. 다른 사용자는 관리자의 승인을 받아야 합니다. MCP 이름 옆에 계정 → 접근 제어.
작동 방식
Claude는 데이터베이스에 직접 연결하지 않습니다. 클라우드에 있는 Query Streams MCP 서버와 통신하며, 이 서버는 네트워크 에이전트가 이미 열어 놓은 단일 아웃바운드 연결을 통해 각 요청을 전달합니다. 에이전트는 쿼리를 로컬에서 실행하고 동일한 방식으로 결과를 다시 전송합니다. 요청과 결과는 에이전트가 시작한 이 단일 채널을 통해 양방향으로 흐르므로 방화벽에서 아무것도 열 필요가 없습니다.
OAuth, 스코프, 감사, 속도 제한
하나의 아웃바운드 TLS 연결
그 설계에서 세 가지 속성이 도출됩니다.
- 클로드에게는 아무런 자격증이 없습니다. 데이터베이스 연결 문자열은 에이전트에 저장됩니다. Claude는 OAuth 권한 또는 MCP 키만 보유하며, 포털에서 한 번의 클릭으로 둘 다 취소할 수 있습니다.
- 읽기 전용이며, 에이전트에서 적용됩니다. 오직
선택,와 함께그리고설명하다진술은 허용됩니다. 검사는 클라우드나 Claude가 아닌 연결의 사용자 측에서 이루어집니다. - 모든 것이 기록됩니다. 모든 툴 호출은 MCP 페이지에 표시됩니다. 활동 탭과 쿼리 기록의 모든 쿼리는 접속한 사용자에게 귀속됩니다.
클로드에게 연결하세요
접근 방법은 두 가지입니다. 채팅 앱은 OAuth를 사용하므로 키가 필요하지 않습니다. 개발자 도구는 MCP 키를 사용합니다. 두 방법 모두 동일한 서버와 동일한 도구에 접속합니다.
옵션 A: claude.ai 및 Claude Desktop (OAuth, 키 필요 없음)
Listed in the Anthropic Connectors Directory. Query Streams is an approved connector: claude.ai/directory/query-streams. On claude.ai and in Claude Desktop you can connect it with one click from 커넥터 찾아보기; no server URL needed. The custom-connector route below still works and is what to use if your Claude organization restricts directory connectors.
- ~에 클로드.아이 열려 있는 Settings → Connectors → Browse connectors검색하세요 쿼리 스트림 클릭하고 클릭하세요 연결하다 (or open the directory listing directly). In Claude Desktop the same option is under 설정 → 커넥터. Can’t see it? Your organization may restrict directory connectors: click 사용자 지정 커넥터 추가 instead, name it 쿼리 스트림 and paste
https://mcp.querystreams.com/mcp. - 채팅을 열고 클릭하세요. + 메시지 상자 옆의 버튼을 선택하세요 쿼리 스트림 클릭하고 클릭하세요 연결하다.
- 새 브라우저 탭에서 Query Streams 동의 화면이 열립니다. 로그인하라는 메시지가 표시되면 로그인하고, 조직을 선택하고, 권한을 검토한 후(아래 참조), 클릭하세요. 연결 승인.
- 클로드에게 돌아가면 알게 될 거예요. 쿼리 스트림에 연결됨클로드가 도구를 처음 사용할 때 권한을 요청합니다. 선택하세요. 항상 허용하세요 따라서 매번 통화할 때마다 알림 없이 작동할 수 있습니다.
이 커넥터는 특정 기기가 아닌 Claude 계정에 연결되어 있으므로 Claude 모바일 앱과 Claude 데스크톱에 자동으로 표시됩니다. 포털에서 언제든지 관리하거나 연결을 해제할 수 있습니다. MCP → 연결된 앱 꼬리표.
"마켓플레이스 추가"와는 다릅니다. Claude Desktop의 채팅 기능 + → 커넥터 찾아보기 → 마켓플레이스 추가 이 옵션은 MCP 서버 URL이 아닌 플러그인 마켓플레이스용 Git 저장소를 요구합니다. 설정 → 커넥터 → 추가.
옵션 B: Claude Code, Cursor 및 기타 개발자 도구(MCP 키)
개발자 도구는 포털에서 생성하여 전달하는 키를 사용하여 인증합니다. X-MCP-키 헤더.
- 로그인하세요 my.querystreams.com, 열려 있는 MCP → 내 키 클릭하고 클릭하세요 키를 생성합니다도구와 기계의 이름을 따서 명명하세요. 예를 들어, 클로드 코드 랩톱그리고 그 범위를 선택하십시오.
- 지금 키를 복사하세요. 나중에 다시 표시하고 복사할 수 있습니다. 내 열쇠열쇠는 이렇게 생겼습니다.
qsmcp_그 뒤에 43개의 문자가 이어집니다. - 클로드 코드의 경우 다음 명령을 실행하세요.
claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp --header "X-MCP-Key: qsmcp_PASTE_KEY_HERE" - Cursor, VS Code, Windsurf, Zed, JetBrains, Gemini CLI, Codex CLI, Continue 및 Cline의 경우, 다음을 여십시오. MCP → 연결 포털의 해당 탭에서 확인할 수 있습니다. 각 클라이언트에 대해 키가 이미 입력된, 바로 붙여넣을 수 있는 구성 파일이 표시됩니다.
확인하려면 물어보세요. “내가 보유한 Query Streams 커넥터는 무엇인가요?” 고객은 전화해야 합니다. qs_list_connectors 그리고 열쇠는 마지막으로 사용됨 '내 키' 탭의 시간이 몇 초 안에 업데이트됩니다.
권한
OAuth를 사용하든 키를 사용하든, 접근 권한은 세 가지 범위로 제어됩니다. 동의 화면에 이러한 범위가 표시되며, 이를 기반으로 키가 생성됩니다.
| 범위 | 클로드가 할 수 있는 일 | 언제 승인해야 할까요? |
|---|---|---|
| 읽다 | 커넥터 및 에이전트 목록을 보고, 스키마를 탐색하고, 스키마 인텔리전스 설명을 읽고, 저장된 쿼리 및 알림 규칙을 나열합니다. | 언제나 그렇죠. 다른 모든 것은 그것을 기반으로 합니다. |
| 분석하다 | 프로파일 테이블(샘플 값, 분포, 의미 유형)을 분석하고, 암묵적인 관계를 파악하며, 스키마 인텔리전스 실행을 대기열에 추가합니다. | 권장 사항입니다. 이렇게 하면 Claude가 조인을 작성하기 전에 데이터의 형태를 이해할 수 있습니다. |
| 실행하다 | 읽기 전용 SQL 및 저장된 쿼리를 실행하고 행을 스트리밍 방식으로 반환합니다. | 단순히 구조를 살펴보는 것뿐만 아니라 답변을 얻고자 하는 사람들을 위한 것입니다. 탐색 전용 키의 경우 해당 기능을 비활성화하세요. |
연결된 앱은 승인 시 특정 커넥터로 제한할 수 있으며, 생성된 키는 조직 내 모든 커넥터에 적용됩니다. 권한 또는 키를 취소하면 약 5분 이내에 효력이 발생합니다. 관리자는 MCP 페이지에서 조직의 모든 활성 권한 및 키를 확인할 수 있습니다.
클로드가 연결되면 할 수 있는 일
클로드는 몇 가지 도구를 봅니다. 당신은 그 도구들을 직접 부르지 않습니다. 클로드가 당신의 질문에 맞는 적절한 도구를 선택합니다. 쉽게 말해서,
데이터를 이해하세요
커넥터, 데이터베이스 및 에이전트 목록을 표시합니다. 테이블 및 열 설명, 의미 유형, 샘플 값, 열거형 레이블, 선언된 관계 및 검색된 관계를 포함하여 모든 데이터베이스의 스키마 트리를 읽습니다.
프로필을 살펴보고 둘러보세요.
필터를 작성하기 전에 테이블 프로파일링을 통해 실제 값 분포를 확인하세요. 외래 키가 선언되지 않은 테이블 간의 조인을 찾아보세요.
저장된 쿼리를 사용하세요
조직에 저장된 매개변수화된 쿼리 목록을 확인하고 다양한 매개변수를 사용하여 실행해 보세요. 여러 소스에 걸쳐 있는 연합 쿼리는 서버 측에서 실행되며 이미 조인된 행을 반환합니다.
임시 SQL 실행
커넥터에 맞는 방언으로 읽기 전용 SQL을 작성하고 실행합니다. 결과는 기본적으로 1,000행이며 시간 초과는 60초입니다. 두 값 모두 조정 가능합니다.
알림 확인
알림 규칙 목록을 보고 현재 상태와 최근 실행 내역을 확인할 수 있습니다. 클로드는 사전 테스트 모드에서 새 규칙을 제안할 수 있으며, 담당자는 알림 페이지에서 해당 규칙을 활성화할 수 있습니다.
모델을 개선하세요
데이터베이스별 스키마 인텔리전스 적용 범위를 확인하고, 동의를 얻어 분석 실행을 예약하면 향후 더 나은 결과를 얻을 수 있습니다.
스키마 인텔리전스가 중요한 이유
클로드가 받는 모든 응답에는 세 가지 등급 중 어느 등급에서 왔는지 태그가 지정되며, 클로드는 자신이 보는 내용을 얼마나 신뢰하는지 조정합니다.
| 층 | 클로드가 보는 것 | 결과 |
|---|---|---|
| 스키마 인텔리전스 | 각 테이블과 열에 대한 설명, 의미 유형, 열거형 레이블, 샘플 값, 팩트 및 차원 분류, 선언 및 발견된 조인이 포함됩니다. | 클로드는 첫 시도에 실무 수준의 SQL 쿼리를 작성하고 데이터를 비즈니스 용어로 설명해 줍니다. |
| 캡처된 스키마 | 테이블 및 컬럼 이름, 데이터 유형, 기본 키, 인덱스, 선언된 외래 키. | 클로드는 일을 하지만 이름에서 의미를 추론해야 하고 추가 질문이 필요할 수도 있습니다. |
| 라이브 스키마 | 해당 데이터베이스는 커넥터의 캡처 선택 항목에 포함되어 있지 않으므로 구조는 요청이 있을 때마다 카탈로그에서 실시간으로 읽어옵니다. | 쿼리는 계속 실행됩니다. 클로드는 필요에 따라 샘플 SELECT 문을 사용하여 탐색합니다. |
팀에 중요한 데이터베이스라면 스키마 인텔리전스를 한 번 실행해 보세요. 대규모 데이터베이스의 경우, 쿼리에서 실제로 사용하는 테이블만 선택하여 실행 범위를 좁히세요. 스키마 인텔리전스는 어떻게 작동할까요? →
예시 프롬프트
이미 답을 알고 있는 것부터 시작하세요. 그런 다음 추가 질문을 하세요. 클로드는 맥락을 유지합니다.
내가 접근 권한을 가진 데이터베이스와 테이블은 무엇이며, 그중에서 스키마 인텔리전스를 지원하는 것은 무엇인가요?연결 고리를 파악하고 답변이 가장 유력한 지점을 알려줍니다. 판매 데이터베이스에서 고객과 주문 간의 관계를 보여주고, 주문 상태 열을 프로파일링해 주세요.관계 및 열 프로파일링을 사용합니다. 클로드가 실제 상태 코드와 그 의미를 보여줄 것입니다. 저장된 쿼리 "지역별 월별 매출"을 올해 2분기에 대해 실행하세요.자체적인 SQL 쿼리를 생성하는 대신, 매개변수를 사용하여 신뢰할 수 있는 저장된 쿼리를 실행합니다. 지난 90일간 매출 기준 상위 10개 제품을 나열하고, 그 결과를 판매 채널별로 세분화해 주세요.커넥터의 방언으로 임시 SQL 쿼리를 실행한 후, 동일한 스레드에서 후속 작업을 진행합니다. 어떤 알림 규칙이 설정되어 있으며, 이번 주에 해당 규칙 중 하나라도 실행되었습니까?경보 규칙과 최근 상태를 읽습니다.더 나은 답변을 위한 팁
- Claude Project를 사용하세요. Query Streams 커넥터를 프로젝트에 연결하고 프로젝트 지침에 비즈니스 규칙을 입력하세요. 기본적으로 사용할 데이터베이스, 공식 정의로 사용할 저장된 쿼리, 명명 규칙 등을 명시하면 됩니다. Claude는 스키마를 실시간으로 읽기 때문에 지침은 간결하게 작성하면 됩니다.
- 중요하다고 생각하는 쿼리를 저장하세요. Claude는 저장된 쿼리를 먼저 참조하므로 "활성 고객"은 팀에서 정의한 의미를 갖습니다.
- 분석 범위를 허용합니다. 필터링하기 전에 열을 프로파일링하는 것은 상태 코드를 추측하는 것과 올바른 상태 코드를 사용하는 것의 차이를 만듭니다.
- 차트를 요청하세요. claude.ai는 Claude가 반환하는 행들을 기반으로 차트를 렌더링합니다.
비용이 얼마나 드는지
MCP 자체는 어떤 요금제에도 별도의 수수료를 부과하지 않습니다. 단, 두 가지 항목에 대해서만 요금이 부과됩니다.
- 데이터 용량. Claude로 반환되는 쿼리 결과는 Excel, Google Sheets, Portal 및 Nova 사용량과 동일한 데이터 영역 예산에 포함됩니다. MCP는 종단 간 압축 없이 HTTP를 통해 실행되므로 압축되지 않은 바이트 단위로 측정됩니다. 따라서 1MB 결과는 약 1MB의 비용이 발생하지만, Excel에서 동일한 결과를 얻을 경우 일반적으로 150~250KB의 비용이 발생합니다.
미리보기 제한탐색적 질문에 적합합니다. - 스키마 인텔리전스가 실행됩니다. Claude를 통해 분석을 대기열에 추가하면 포털에서 직접 실행하는 것과 마찬가지로 조직에 AI 크레딧이 청구됩니다. Claude는 청구하기 전에 사용자에게 확인을 요청합니다.
문제 해결
| 당신이 보는 것 | 그것이 의미하는 바는 | 고치다 |
|---|---|---|
| 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 | 그 결과는 너무 방대해서 클로드에게 한 번에 전달할 수 없었습니다. | 열이나 행의 수를 줄여달라고 요청하세요. 클로드가 보통 직접 제안해 줄 겁니다. |
| 읽기 전용 위반 | SQL에는 다음 이외의 내용이 포함되어 있었습니다. 선택, 와 함께 또는 설명하다. | 의도적으로 그렇게 설계되었습니다. MCP를 통한 쓰기는 절대 허용되지 않습니다. |
여전히 문제가 해결되지 않았나요? 티켓을 접수해 주세요. my.querystreams.com/support 또는 이메일 [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 등. 포털의 MCP 페이지에는 각 도구에 대한 설정이 미리 준비되어 있습니다.
여러 조직과 호환되나요?
각 보조금 또는 키는 하나의 조직에 귀속됩니다. 필요한 조직별로 한 번씩만 연결하세요.
이것과 노바의 차이점은 무엇인가요?
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 · 프리즈마 포스트그레스 · 코예브 · 나일 강
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish