Skip to Content
사용자 가이드🧩 Available MCP ServersQueryPie SAC

QueryPie SAC

QueryPie 플랫폼의 SAC(Security Access Control)를 통해 안전하게 서버에 접근할 수 있습니다.

주요 기능

  • QueryPie SAC(Security Access Control)을 통한 서버 접근
  • 권한 기반 서버 관리
  • 안전한 서버 명령어 실행

기본 정보

인증 방식

관리자가 사전에 MCP 서버 구성을 설정해야합니다. 사용자는 OAuth 방식을 사용하여 인증합니다.

입력 파라미터

  • Server URL (필수): QueryPie 도메인
  • Authorization URL for OAuth (필수): OAuth 인증 URL
  • Token URL for OAuth (필수): OAuth 토큰 URL
  • Client ID (필수): OAuth 클라이언트 ID
  • Client Secret (필수): OAuth 클라이언트 시크릿

QueryPie v11.2.1 버전을 기준으로, 관리자 페이지의 일반 설정 > 보안 > OAuth 설정 경로에서 확인할 수 있습니다.

OAuth 연동 가이드

QueryPie와 AIP를 OAuth로 연동하는 절차입니다. 아래 순서대로 진행하세요.

  1. QueryPie 접속 및 관리자 로그인
    조직의 QueryPie 도메인(예: https://<your-querypie-domain>)에 접속하여 관리자 계정으로 로그인합니다.

  2. OAuth 설정으로 이동
    관리자 페이지 → 일반 설정 → 보안 → OAuth 설정 메뉴로 이동합니다. QueryPie OAuth 설정

  3. Client ID와 Secret 복사
    Client ID를 입력하고 Client ID와 Client Secret을 복사합니다. 아래 5단계에서 필요합니다.

  4. AIP의 OAuth 콜백 URL 입력
    Redirect URI 필드에 https://api.app.querypie.com/integration/oauth/callback을 입력합니다.

  5. AIP 접속 및 OAuth 설정 입력
    AIP 관리자 페이지의 MCP 연동 관리 메뉴에서 QueryPie MCP 설정에 다음 값을 입력합니다:

    • Server URL: 예) https://<your-querypie-domain>
    • Client ID (위 3단계에서 복사한 값)
    • Client Secret (위 3단계에서 복사한 값)
    • Edge Tunnel (개인 Tunnel 선택) QueryPie OAuth 설정

지원하는 MCP 도구

SAC(Security Access Control) 도구

QueryPie의 보안 액세스 제어 기능을 통해 서버 접근을 관리합니다.

QueryPie SAC MCP는 Linux 계열의 서버에 대해서만 동작합니다.

list_accessible_server_roles

접근 가능한 모든 서버 역할 목록을 조회합니다. 다음 명령어에 사용할 역할을 선택해야 합니다.

list_accessible_server_groups

접근 가능한 모든 서버 그룹 목록을 조회합니다.

입력 파라미터:

  • roleUuid (필수): 역할 UUID

list_accessible_servers

접근 가능한 모든 서버 목록을 조회합니다.

입력 파라미터:

  • roleUuid (필수): 역할 UUID
  • serverGroupUuid (필수): 서버 그룹 UUID

list_server_accounts

서버 계정 목록을 조회합니다. 서버에 연결하는 데 사용할 수 있는 모든 계정 목록입니다.

입력 파라미터:

  • roleUuid (필수): 역할 UUID
  • serverUuid (필수): 서버 UUID

run_server_command

서버에서 명령어를 실행합니다.

입력 파라미터:

  • roleUuid (필수): 역할 UUID
  • host (필수): 서버 호스트
  • port (필수): 서버 포트
  • username (필수): 사용자명
  • command (필수): 실행할 명령어

사용 예시

예를 들어,

  • Prompt로 “QueryPie를 통해 접근할 수 있는 서버 목록 알려줘” 라고 입력하면,
  • LLM은 QueryPie SAC MCP로 list_accessible_server_roles, list_accessible_server_groups, list_accessible_servers 도구를 순차적으로 호출한 뒤, 호출 결과를 기반으로 답변합니다.

주의사항

  • 적절한 권한 설정을 통해 보안을 유지하세요.
  • 서버 접근 시 조직의 보안 정책을 준수하세요.
  • 정기적으로 접근 로그를 검토하세요.
QueryPie DAC - AdminQueryPie SAC - Admin