외부 도구#
Supernova는 자동화용 공개 API, 에이전트 도구용 MCP, 조직 데이터 저장소용 Git이라는 3가지 외부 인터페이스를 지원합니다. 각 인터페이스는 대화형 브라우저 세션보다 권한 범위가 좁은 자격 증명을 사용합니다.
공개 API#
개인 액세스 토큰이나 OAuth 액세스 토큰을 사용해 쿼리를 제출하고, 리소스를 확인하고, 지원되는 작업을 실행하고, 결과를 가져옵니다. API 경로에는 버전 구간이 없습니다. 필드가 추가될 수는 있지만, 기존 동작과 호환되지 않는 변경에는 경로를 조용히 바꾸는 대신 새로운 계약이 필요합니다.
MCP#
https://mcp.supernova.ai/mcp를 사용해 레이크 메타데이터, 실행 범위가 제한된 읽기 전용 SQL, 조직 데이터 저장소 파일, 서명된 시각적 미리보기를 제공하는 실시간 대시보드 작성을 이용합니다. OAuth 범위는 읽기, 쓰기, 쿼리 실행을 구분합니다. MCP 액세스를 참고하세요.
Git#
SSH 키를 추가한 뒤 설정된 Git URL로 조직 데이터 저장소를 복제합니다. 모델, 대시보드, 테마, 패키지, typesql.lock은 일반적인 검토 대상 파일입니다. 푸시한 커밋은 이후 실행에서 사용할 새로운 고정 저장소 리비전이 됩니다.
인터페이스 요약#
| 필요한 작업 | 인터페이스 | 자격 증명 |
|---|---|---|
| 데이터 쿼리 또는 리소스 자동화 | 공개 API | PAT 또는 OAuth bearer |
| 에이전트가 데이터를 확인하고 쿼리하며 대시보드를 작성하도록 허용 | MCP | OAuth 2.1 범위 |
| 작성한 자산을 로컬에서 검토 | Git | 조직에서 승인한 SSH 키 |
스토리지 직접 접근 자격 증명과 내부 서비스 엔드포인트는 고객 통합용 인터페이스가 아닙니다. Parquet를 내보낼 때는 스토리지 객체에 직접 접근하는 대신 API 결과 링크를 사용하세요.