macOS 네트워크 에이전트
macOS에 Query Streams를 설치하세요
macOS 12 Monterey 이상에서 발신 전용 Query Streams 네트워크 에이전트를 실행하십시오. 설치 스크립트 하나로 시스템 수준 에이전트로 등록됩니다. 출시됨 데몬 — Apple Silicon(M1~M4) 및 Intel용 네이티브 빌드입니다. 로컬 에이전트 대시보드를 사용하세요. http://localhost:1823 에이전트를 등록하고 데이터 커넥터를 관리한 다음, 쿼리 스트림 포털에서 Excel, Google Sheets, 자동화, REST API, MCP 및 Nova AI용 저장된 쿼리를 구축할 수 있습니다.
윈도우
리눅스
Query Streams는 Mac 사용자와 개발 팀이 실시간 데이터베이스를 Excel, Google Sheets, 자동화 도구, MCP 호환 AI 도구 및 파트너와 바로 사용할 수 있는 REST API에 연결할 수 있도록 지원하는 안전한 실시간 데이터 액세스 플랫폼입니다. QueryStreams.com에서 더 자세히 알아보세요. 그리고 무료로 가입하세요 macOS 에이전트를 처음 설치하려면 다음을 수행하십시오.
이 가이드는 macOS에 에이전트를 설치하는 방법을 설명합니다. 패키지에는 다음이 포함됩니다. 한 번의 명령으로 설치하는 스크립트 파일을 복사하는 /usr/local/querystreams/agent/ 그리고 등록합니다 시스템 수준 launchd 데몬 — 네이티브 ARM64(Apple Silicon M1–M4) 및 네이티브 x64(Intel) 빌드로 제공됩니다. 로컬 에이전트 대시보드에서 데이터 커넥터를 추가한 다음, 쿼리 스트림 포털을 사용하여 첫 번째 저장된 쿼리를 구축하세요.
시작하기 전에
지원되는 macOS 버전
macOS 12 Monterey 또는 그 이후 버전(Monterey, Ventura, Sonoma, Sequoia). Apple Silicon과 Intel 모두 네이티브 바이너리를 지원합니다.
관리자/sudo 접근 권한
필수 사항입니다. 설치 스크립트는 루트 권한으로 실행되어 설치합니다. /usr/local/ 그리고 시스템 LaunchDaemon을 등록합니다.
아웃바운드 HTTPS
에이전트가 Streams 클라우드 서비스를 쿼리하려면 443번 포트에 대한 외부 HTTPS 액세스가 필요합니다. 인바운드 방화벽 규칙은 필요하지 않습니다.
데이터베이스 네트워크 액세스
데이터베이스 또는 API 소스와 동일한 네트워크, VPN 또는 라우팅 가능한 환경에 있는 Mac에 에이전트를 설치하십시오.
1단계: macOS 에이전트를 다운로드합니다.
- 로그인하세요 my.querystreams.com/download.
- 선택하다 macOS 에이전트 다운로드 옵션에서.
- 선택하다 ARM64 (애플 실리콘 - 확인) Apple 메뉴 > 이 Mac에 관하여(만약 "Apple M1/M2/M3/M4"라고 표시되면 이것을 사용하세요.) x64 (인텔 코어)를 다운로드하세요. .tar.gz 보관소.
- 다운로드 페이지에서 조직 인증 키를 복사하세요. 로컬 에이전트 대시보드를 열 때 이 키를 사용합니다.
2단계: 설치 스크립트 실행
열려 있는 단말기 (응용 프로그램 > 유틸리티 > 터미널)에서 다음 명령어를 실행하세요:
그만큼 install.sh 스크립트는 다음 네 단계를 자동으로 수행합니다: 파일을 복사합니다. /usr/local/querystreams/agent/올바른 권한을 설정하고 launchd plist를 설치합니다. /라이브러리/LaunchDaemons/com.querystreams.agent.plist 시스템 전체 데몬으로 실행되며, 다음을 통해 서비스를 로드합니다. launchctl 로드 — 부팅 즉시 그리고 매번 부팅할 때마다 시작합니다.
서명 및 공증 완료: Query Streams macOS 에이전트는 Apple의 코드 서명 및 공증을 받았으므로 Gatekeeper 환경에서 정상적으로 실행됩니다. 대부분의 사용자는 추가 조치가 필요하지 않습니다. 드물게 첫 실행 시 메시지가 표시되는 경우(예: 격리 플래그가 다시 적용된 후 아카이브가 컴퓨터 간에 복사된 경우)에는 다음 명령으로 격리 속성을 해제하십시오. xattr -dr com.apple.quarantine qs-agent/ 그리고 다시 실행 sudo bash install.sh.
서비스가 실행되면 로컬 대시보드는 다음 주소에서 이용 가능합니다. http://localhost:1823 Mac에서 사용됩니다. 인증 키를 입력하고 로컬 데이터 커넥터를 관리하는 데 사용됩니다. 데이터베이스 자격 증명은 에이전트 컴퓨터에 저장되며 Query Streams 클라우드로 전송되지 않습니다.
3단계: 에이전트를 계정에 연결합니다.
- 로컬 에이전트 대시보드에서
http://localhost:1823Query Streams 인증 키를 붙여넣으세요. - 키를 저장하고 에이전트가 조직에 등록될 때까지 기다리세요.
- 서비스가 정상적으로 작동하는지 확인하십시오.
sudo launchctl list | grep querystreams. - 선택하다 데이터 소스 추가 로컬 연결 마법사를 엽니다.
4단계: 로컬 에이전트에 첫 번째 데이터 소스를 추가합니다.
쿼리 스트림 포털에서 커넥터를 추가하거나 편집하지 마십시오. 커넥터 설정은 로컬 네트워크 에이전트 대시보드에서 수행합니다. http://localhost:1823여기에서 PostgreSQL, MySQL, MariaDB, SQLite, Microsoft SQL Server, Oracle, Snowflake, BigQuery, DuckDB, Stripe, HubSpot, Shopify, Google Analytics 4, Google Ads, Google Search Console, ShipStation 또는 iTick과 같은 데이터베이스 또는 API 커넥터를 추가, 편집, 테스트 및 삭제할 수 있습니다.
- macOS 에이전트 컴퓨터에서 브라우저를 열고 다음 주소로 이동하세요.
http://localhost:1823. - 클릭 데이터 소스 추가 또는 에이전트 연결 영역을 엽니다.
- 데이터베이스 또는 API 커넥터 유형을 선택하세요.
- macOS 에이전트 머신에서 유효한 연결 정보를 입력하십시오.
- 메시지가 표시되면 데이터 영역을 선택하십시오.
- 연결을 테스트한 다음 저장하세요.
- 지원되는 데이터베이스 커넥터의 경우, 쿼리 빌더, Nova AI 및 MCP 클라이언트가 더 풍부한 테이블 및 열 컨텍스트를 얻을 수 있도록 스키마 인텔리전스를 활성화된 상태로 유지하십시오.
5단계: 첫 번째 쿼리를 작성하고 저장하세요
에이전트에서 커넥터와 데이터베이스를 구성한 후, 쿼리 스트림 포털을 열고 쿼리 빌더를 사용하여 첫 번째 저장된 쿼리를 생성하세요. 저장된 쿼리는 Excel, Google Sheets, 자동화, 보안 REST API 엔드포인트 및 공유 사용자가 원시 SQL이나 데이터베이스 자격 증명을 보지 않고 실행할 수 있는 쿼리입니다.
- 열려 있는 쿼리 빌더 쿼리 스트림 포털에서.
- 로컬 에이전트에 구성한 데이터 커넥터와 데이터베이스를 선택하십시오.
- SQL 쿼리를 작성하거나 생성하고 미리 보기를 실행합니다.
- 쿼리를 명확한 이름으로 저장하고 사용자가 조정할 수 있도록 필터를 추가하세요.
- 저장된 쿼리를 Microsoft Excel, Google Sheets, 자동화, REST API 또는 공유 대시보드에서 실행할 수 있습니다.
현지 에이전트
커넥터를 추가, 편집, 테스트 및 삭제하려면 다음 링크를 이용하세요. 로컬호스트:1823.
쿼리 빌더
커넥터를 선택하고, 데이터베이스를 선택하고, SQL을 작성하고, 미리 보기를 한 다음 저장합니다.
사용자 도구
저장된 쿼리는 Excel, Google Sheets, 자동화 기능 및 API에서 사용할 수 있습니다.
MCP 액세스
MCP 클라이언트는 에이전트를 통해 사용 가능한 커넥터를 확인하고 데이터베이스를 직접 쿼리할 수도 있습니다.
서비스 관리 참조
에이전트 제거
패키지에는 다음이 포함됩니다. uninstall.sh launchd 서비스를 중지하고 언로드하는 스크립트이며, plist 파일을 제거합니다. /라이브러리/데몬 실행/그리고 설치 디렉토리를 삭제합니다.
제거 스크립트는 다음과 같은 메시지를 표시합니다. "설정 정보와 로그를 유지하시겠습니까? (예/아니오)" - 입력하다 y 당신의 것을 보존하기 위해 앱 설정 json 그리고 로그/ 폴더 또는 N 모든 것을 제거하기 위해.
문제 해결
macOS에서 "개발자를 확인할 수 없으므로 열 수 없습니다"라는 메시지가 표시됩니다. +
xattr -dr com.apple.quarantine qs-agent/그런 다음 다시 실행하세요 sudo bash install.sh또는 다음으로 이동하세요. 시스템 설정 > 개인 정보 및 보안 클릭하고 클릭하세요 “어쨌든 허용합니다” 첫 번째 시도가 차단된 후.해당 담당자는 온라인에 나타나지 않습니다. +
tail -50 /usr/local/querystreams/agent/logs/agent-stdout.log일반적인 원인: 로컬 웹 UI에 잘못된 인증 키를 입력한 경우 http://localhost:1823프록시에 의해 아웃바운드 포트 443이 차단되었습니다(테스트 대상). curl -v https://my.querystreams.com); 게이트키퍼가 여전히 차단 중입니다(설치 전에 격리 속성이 제거되었는지 확인하십시오).데이터베이스 연결 테스트가 실패했습니다. +
ARM64를 사용해야 할까요, 아니면 x64를 사용해야 할까요? +
방화벽에서 들어오는 포트를 열어야 하나요? +
데이터베이스 자격 증명은 어디에 저장되나요? +
/usr/local/querystreams/agent/appsettings.json 에이전트 머신에서. Query Streams 클라우드는 에이전트를 통해 쿼리 요청을 라우팅하기 위해 원시 데이터베이스 암호가 필요하지 않습니다.커넥터를 추가, 편집 또는 삭제하려면 어디에 있어야 하나요? +
http://localhost:1823쿼리 스트림 포털은 에이전트에 커넥터가 구성된 후 저장된 쿼리를 구축하고 액세스를 공유하는 곳입니다.macOS에서 자동 업데이트는 어떻게 작동하나요? +
osx-arm64 또는 osx-x64사용 가능한 경우 launchd plist를 언로드하고 백업합니다. 앱 설정 json새로운 바이너리를 추출하고, 구성을 복원하고, 서비스를 다시 로드합니다. 이 모든 과정은 완전히 자동화되어 사용자 조치가 필요하지 않습니다.시작하기
macOS 에이전트를 설치하고 첫 번째 데이터 소스를 연결하세요.
한 번의 명령으로 설치 스크립트를 실행하고, localhost:1823에서 로컬로 커넥터를 구성한 다음, Excel, Google Sheets, 자동화, MCP, REST API 및 Nova AI에 사용할 수 있는 재사용 가능한 쿼리를 저장하세요.
관련 가이드: Windows에 Query Streams 에이전트를 설치하세요. | Linux에 Query Streams 에이전트를 설치하세요. | Query Streams Google Sheets 추가 기능을 설치하세요. | Microsoft Excel에서 쿼리 스트림 사용하기
카테고리: 설정
태그: macOS, 쿼리 스트림 에이전트, 네트워크 에이전트, 설정, 데이터베이스 커넥터, launchd
메타 설명: macOS에 Query Streams Agent를 설치하고 launchd 데몬으로 실행하여 실시간 데이터베이스에 안전하게 연결하세요.
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish