View Categories

Windows에 Query Streams 에이전트를 설치하는 방법

7분 읽기

윈도우 로고 Windows 네트워크 에이전트

Windows에 Query Streams 설치하기

Windows 데스크톱, 워크스테이션 또는 서버에서 발신 전용 Query Streams 네트워크 에이전트를 실행하십시오. 로컬 에이전트 대시보드를 사용하십시오. http://localhost:1823 에이전트를 등록하고 데이터 커넥터를 관리한 다음, 쿼리 스트림 포털에서 Excel, Google Sheets, 자동화, REST API, MCP 및 Nova AI용 저장된 쿼리를 구축할 수 있습니다.

로컬 커넥터 설정 인바운드 방화벽 포트 없음 귀하의 자격 증명은 지역에 보관됩니다.
윈도우 로고
Windows에 설치Windows 10/11 또는 Windows Server 2019 이상
아웃바운드 전용 연결인바운드 포트 없음, VPN 없음, 공개 데이터베이스 노출 없음
커넥터를 로컬에서 관리하세요로컬호스트:1823의 에이전트에서 추가, 편집, 테스트 및 삭제를 수행하세요.
저장된 쿼리를 빌드합니다.재사용 가능한 쿼리를 Excel, Sheets, MCP, API 및 자동화에 게시합니다.
다른 운영체제에 설치하시나요?

Query Streams는 데이터베이스와 SaaS API를 Excel, Google Sheets, 자동화 도구, MCP 호환 AI 도구 및 파트너 지원 REST API에 연결하는 안전한 실시간 데이터 액세스 플랫폼입니다. QueryStreams.com에서 더 자세히 알아보세요. 그리고 무료로 가입하세요 Windows 에이전트를 처음 설치하려면 다음 단계를 따르세요.

이 가이드는 기존의 샘플 데이터베이스 설정 절차를 대체합니다. Query Streams는 더 이상 번들로 제공되는 예제 데이터베이스를 필요로 하지 않습니다. 에이전트를 설치하고 조직 키로 로그인한 다음, 로컬 에이전트 대시보드에서 데이터 커넥터를 추가하고 Query Streams 포털을 사용하여 첫 번째 저장된 쿼리를 구축하십시오.

시작하기 전에

지원되는 Windows 버전

Windows 10, Windows 11 및 Windows Server 2019 이상 버전이 지원됩니다. 쿼리 스트림을 통해 노출하려는 데이터베이스에 액세스할 수 있는 컴퓨터를 사용하십시오.

관리자 액세스

설치를 완료하고 로컬 대시보드를 허용하며 에이전트를 백그라운드 서비스로 실행하려면 관리자 권한이 필요할 수 있습니다.

아웃바운드 HTTPS

에이전트가 Streams 클라우드 서비스를 쿼리하려면 443번 포트에 대한 외부 HTTPS 액세스가 필요합니다. 인바운드 방화벽 규칙은 필요하지 않습니다.

데이터베이스 네트워크 액세스

데이터베이스 또는 API 소스와 동일한 네트워크, VPN, VPC 또는 라우팅 가능한 환경에 있는 Windows 컴퓨터에 에이전트를 설치하십시오.

1단계: Windows 에이전트를 다운로드합니다.

1
2
3
4
5
  1. 로그인하세요 my.querystreams.com/download.
  2. 선택하다 윈도우 에이전트 다운로드 옵션에서.
  3. 최신 Windows 설치 프로그램을 다운로드하세요.
  4. 다운로드 페이지에서 조직 인증 키를 복사하세요. 로컬 에이전트 대시보드를 열 때 이 키를 사용합니다.

2단계: 설치 프로그램 실행

2
3
4
5
  1. 다운로드한 설치 프로그램을 브라우저의 다운로드 폴더에서 엽니다.
  2. Windows에서 확인을 요청하면 선택하세요. 설치 프로그램이 실행될 수 있도록 허용합니다.
  3. 설치 프로그램의 안내에 따라 진행하세요.
  4. 설치가 완료되면 로컬 에이전트 대시보드를 엽니다. http://localhost:1823.

로컬 대시보드는 사용자의 Windows 컴퓨터에서 실행됩니다. http://localhost:1823이 기능은 인증 키를 입력하고 로컬 데이터 커넥터를 관리하는 데 사용됩니다. 데이터베이스 자격 증명은 에이전트 시스템에 저장되며 Query Streams 클라우드로 전송되지 않습니다.

3단계: 에이전트를 계정에 연결합니다.

3
4
5
  1. 로컬 에이전트 대시보드에서 http://localhost:1823Query Streams 인증 키를 붙여넣으세요.
  2. 키를 저장하고 에이전트가 조직에 등록될 때까지 기다리세요.
  3. 설치가 완료되면 에이전트는 온라인 또는 연결됨 상태를 표시합니다.
  4. 선택하다 데이터 소스 추가 로컬 연결 마법사를 엽니다.

4단계: 로컬 에이전트에 첫 번째 데이터 소스를 추가합니다.

4
5

쿼리 스트림 포털에서 커넥터를 추가하거나 편집하지 마십시오. 커넥터 설정은 로컬 네트워크 에이전트 대시보드에서 수행합니다. http://localhost:1823여기에서 Microsoft SQL Server, PostgreSQL, MySQL, MariaDB, SQLite, Microsoft Access, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation 또는 iTick과 같은 데이터베이스 또는 API 커넥터를 추가, 편집, 테스트 및 삭제할 수 있습니다.

  1. Windows 에이전트 컴퓨터에서 브라우저를 열고 다음 주소로 이동하십시오. http://localhost:1823.
  2. 클릭 데이터 소스 추가 또는 에이전트 연결 영역을 엽니다.
  3. 데이터베이스 또는 API 커넥터 유형을 선택하세요.
  4. Windows 에이전트 컴퓨터에서 유효한 연결 정보를 입력하십시오.
  5. 메시지가 표시되면 데이터 영역을 선택하십시오.
  6. 연결을 테스트한 다음 저장하세요.
  7. 지원되는 데이터베이스 커넥터의 경우, 쿼리 빌더, Nova AI 및 MCP 클라이언트가 더 풍부한 테이블 및 열 컨텍스트를 얻을 수 있도록 스키마 인텔리전스를 활성화된 상태로 유지하십시오.
SQL Server
SQL Server서버, 데이터베이스, 사용자 이름, 비밀번호
PostgreSQL
PostgreSQL호스트, 포트, 데이터베이스, SSL
MySQL
MySQL / MariaDB호스트, 포트, 데이터베이스, SSL
SQLite
로컬 파일SQLite, DuckDB, 액세스
스트라이프
API 커넥터자격 증명, 동기화 일정, 데이터 영역
MCP
MCP 준비 완료AI 클라이언트는 커넥터에 직접 쿼리할 수 있습니다.
네트워크 모델
커넥터 관리 로컬 에이전트 대시보드: http://localhost:1823 Windows 에이전트 자격 증명을 로컬에 저장하고 외부 연결을 설정합니다. 사용자 데이터베이스/API 에이전트의 개인 네트워크 연결 쿼리 스트림 클라우드 커넥터 메타데이터를 수신하고 쿼리 요청을 라우팅합니다.

5단계: 첫 번째 쿼리를 작성하고 저장하세요

5

에이전트에서 커넥터와 데이터베이스를 구성한 후, 쿼리 스트림 포털을 열고 쿼리 빌더를 사용하여 첫 번째 저장된 쿼리를 만드세요. 저장된 쿼리는 Excel, Google Sheets, Power Automate 스타일 자동화, 보안 REST API 엔드포인트 및 공유 사용자가 원시 SQL이나 데이터베이스 자격 증명을 보지 않고 실행할 수 있는 쿼리입니다.

  1. 열려 있는 쿼리 빌더 쿼리 스트림 포털에서.
  2. 로컬 에이전트에 구성한 데이터 커넥터와 데이터베이스를 선택하십시오.
  3. SQL 쿼리를 작성하거나 생성하고 미리 보기를 실행합니다.
  4. 쿼리를 명확한 이름으로 저장하고 사용자가 조정할 수 있도록 필터를 추가하세요.
  5. 저장된 쿼리를 Microsoft Excel, Google Sheets, 자동화, REST API 또는 공유 대시보드에서 실행할 수 있습니다.
1

현지 에이전트

커넥터를 추가, 편집, 테스트 및 삭제하려면 다음 링크를 이용하세요. 로컬호스트:1823.

2

쿼리 빌더

커넥터를 선택하고, 데이터베이스를 선택하고, SQL을 작성하고, 미리 보기를 한 다음 저장합니다.

3

사용자 도구

저장된 쿼리는 Excel, Google Sheets, 자동화 기능 및 API에서 사용할 수 있습니다.

4

MCP 액세스

MCP 클라이언트는 에이전트를 통해 사용 가능한 커넥터를 확인하고 데이터베이스를 직접 쿼리할 수도 있습니다.

문제 해결

해당 담당자는 온라인에 나타나지 않습니다. +
Windows 컴퓨터에서 443번 포트를 통해 외부로 나가는 HTTPS 액세스가 허용되는지 확인한 다음, 로컬 에이전트 대시보드를 다시 열고 인증 키가 올바르게 저장되었는지 확인하십시오. 회사에서 외부 프록시를 사용하는 경우, 해당 프록시를 통해 Query Streams 클라우드 트래픽을 허용하십시오.
데이터베이스 연결 테스트가 실패했습니다. +
에이전트가 설치된 Windows 컴퓨터에서 테스트하십시오. 에이전트는 데이터베이스 호스트 및 포트에 직접 연결할 수 있어야 합니다. 또한 데이터베이스 사용자 이름이 쿼리하려는 테이블 또는 뷰에 대한 읽기 권한이 있는지 확인하십시오.
방화벽에서 들어오는 포트를 열어야 하나요? +
아니요. 에이전트는 쿼리 스트림으로 나가는 암호화된 연결을 생성합니다. 쿼리 요청은 해당 연결을 통해 전송되므로 SQL Server, PostgreSQL, MySQL 또는 기타 데이터베이스가 공용 인터넷에 노출되지 않습니다.
데이터베이스 자격 증명은 어디에 저장되나요? +
데이터베이스 자격 증명은 에이전트 머신에 저장됩니다. Query Streams 클라우드는 에이전트를 통해 쿼리 요청을 전송하기 위해 데이터베이스 암호를 직접 입력할 필요가 없습니다.
커넥터를 추가, 편집 또는 삭제하려면 어디에 있어야 하나요? +
네트워크 에이전트의 로컬 대시보드를 사용하세요. http://localhost:1823쿼리 스트림 포털은 에이전트에 커넥터가 구성된 후 저장된 쿼리를 구축하고 액세스를 공유하는 곳입니다.
에이전트를 두 개 이상 설치할 수 있나요? +
예. 온프레미스 Windows Server, AWS EC2, Azure VM, Google Cloud 또는 지사 컴퓨터 등 데이터베이스가 있는 모든 위치에 에이전트를 설치하세요. 쿼리 스트림은 서로 다른 에이전트가 서로 다른 커넥터를 호스팅하는 경우에도 하나의 계정에서 사용 가능한 소스를 표시합니다.
설치 후에는 무엇을 해야 하나요? +
Query Streams 포털에서 저장된 쿼리를 생성한 다음 Microsoft Excel, Google Sheets, Nova AI, Claude 또는 Cursor와 같은 MCP 클라이언트, 예약된 자동화 또는 보안 REST API 엔드포인트에서 실행할 수 있습니다.
샘플 데이터베이스는 어디에 있나요? +
기존 샘플 데이터베이스 설정은 더 이상 사용되지 않습니다. Query Streams는 이제 에이전트를 통해 사용자의 실제 데이터베이스 또는 API 소스에 직접 연결하도록 안내합니다.

시작하기

Windows 에이전트를 설치하고 첫 번째 데이터 소스를 연결하세요.

에이전트를 다운로드하고 localhost:1823에서 로컬로 커넥터를 구성한 다음 Excel, Google Sheets, 자동화, MCP, REST API 및 Nova AI에 사용할 수 있는 재사용 가능한 쿼리를 저장하세요.

다운로드 에이전트

관련 가이드: Linux에 Query Streams 에이전트를 설치하세요. | macOS에 Query Streams 에이전트를 설치하세요. | Query Streams Google Sheets 추가 기능을 설치하세요. | Microsoft Excel에서 쿼리 스트림 사용하기

카테고리: 설정

태그: Windows, 쿼리 스트림 에이전트, 네트워크 에이전트, 설치, 데이터베이스 커넥터

메타 설명: Windows에 Query Streams 에이전트를 설치하고 실시간 데이터베이스에 안전하게 연결하세요.

Updated on 2026년 7월 2일

Powered by BetterDocs