시작하기
MCP
SQL 컴파일러
SQL 실행 모델
hs-sql-agent가 신뢰할 수 없는 SQL을 검증하고 대상 데이터베이스용 SQL로 변환한 뒤 실행하는 과정을 설명합니다.
02Safe DML
하나 이상의 DML을 승인하고 정확한 Evidence를 재검증한 뒤 승인된 Transaction을 원자적으로 commit합니다.
03데이터베이스 방언
공통 MCP 인터페이스 뒤에서 동작하는 6개 데이터베이스 지원과 SQL 방언의 지원 범위를 설명합니다.
04SQL 지원 레퍼런스
hs-sql-agent의 SQL grammar와 provider capability를 사람이 읽기 쉽게 정리합니다.
관리
Admin 패널 개요
데이터베이스 접근, MCP 자격 증명, ID, 권한 부여, 감사, 보안 정책 및 런타임 운영을 위한 운영자 제어 평면입니다.
02데이터베이스 관리
hs-sql-agent에서 외부에 노출할 데이터베이스 연결을 구성하고 운영합니다.
03MCP 키
hs-sql-agent에서 MCP 자격 증명을 발급하고 범위를 지정하며 교체·복제·폐기합니다.
04Custom Tools
hs-sql-agent의 정책 경계를 우회하지 않고 목적별 Query 또는 DML MCP 도구를 만들고 게시합니다.
05Semantic Metadata
hs-sql-agent에서 테이블/컬럼 의미, 관계, 지표 메타데이터로 데이터베이스 탐색 정보를 보강합니다.
06멤버와 역할
hs-sql-agent의 Admin 사용자, 세션, 역할 할당 및 역할 수명 주기를 관리합니다.
07권한
hs-sql-agent Admin 작업에 사용되는 path + action authorization 모델을 설명합니다.
08감사
Admin 제어 평면에서 hs-sql-agent 감사 레코드를 조회·요약·내보내고 보존 정책을 적용합니다.
09보안 정책
Admin 제어 평면에서 hs-sql-agent의 SQL, DML, rate limit 및 동시 실행 정책을 구성합니다.
10운영 상태
hs-sql-agent의 실행 지표, 데이터베이스 상태, MCP 키 사용량 및 외부 전송 상태를 확인합니다.
통합
운영
설정 레퍼런스
독립 Docker, 표준 HsSqlAgent.Hosting 또는 모듈형 HsSqlAgent.Server Host를 구성합니다.
02관측성과 감사 운영
health probe, slow-query threshold, Prometheus, OTLP, audit retention 및 서명된 outbound delivery를 구성합니다.
03배포
hs-sql-agent 독립 서비스, 표준 임베드, 모듈형 Host의 프로덕션 배포 지침.
04분산 배포
하나의 서비스 endpoint 뒤에서 여러 hs-sql-agent 인스턴스를 운영할 때 필요한 shared-state 요구 사항을 설명합니다.