MCP 액세스#
MCP 클라이언트를 https://mcp.supernova.ai/mcp에 연결합니다. Supernova는 PKCE를 사용하는 OAuth 2.1을 지원하며, 현재 세션에 연결된 조직을 표시하고 액세스를 허용하기 전에 정확한 권한 범위를 나열합니다.
권한 범위#
| 범위 | 허용하는 작업 |
|---|---|
files:read | 레이크 메타데이터, 데이터 저장소 읽기, 대시보드 읽기, 커넥터 검색 |
files:write | 데이터 저장소 및 대시보드 커밋 |
files:admin | 조직의 새 데이터 저장소 초기화 |
query:execute | run_query |
액세스 토큰의 유효 기간은 1시간입니다. 새로 고침 토큰의 유효 기간은 30일이며 폐기할 수 있습니다. 폐기하면 새 액세스 토큰을 발급할 수 없지만, 이미 발급한 액세스 토큰은 원래 만료 시각까지 유효합니다.
OAuth 검색#
MCP 클라이언트는 MCP 엔드포인트의 보호 리소스 메타데이터 URL 또는 해당 엔드포인트에서 인증 없이 받은 401 응답을 통해 권한 부여 서버를 찾을 수 있습니다.
보호 리소스 메타데이터:
https://mcp.supernova.ai/.well-known/oauth-protected-resource/mcp권한 부여 서버 메타데이터:
https://mcp.supernova.ai/.well-known/oauth-authorization-server
경로별 URL을 구성하지 않는 클라이언트를 위해 오리진 수준의 보호 리소스 메타데이터 URL도 제공합니다.
도구#
| 도구 | 용도 |
|---|---|
list_files | 가상 스키마 트리 탐색 |
read_file | 테이블 스키마와 정규화된 SQL 이름 읽기 |
run_query | 읽기 전용 SQL 문 1개 실행 |
list_repo_files | Git ref에서 조직 데이터 저장소 파일 목록 조회 |
read_repo_file | UTF-8 데이터 저장소 파일 1개 읽기 |
write_repo_file | UTF-8 데이터 저장소 파일 1개 커밋 |
list_dashboards | Git ref에서 활성 대시보드 목록 조회 |
read_dashboard | 활성 대시보드 Markdown 문서 1개 읽기 |
write_dashboard | 활성 대시보드 Markdown 문서 1개 커밋 |
connect_data | 사용 가능한 데이터 소스의 설정 URL 또는 없는 커넥터의 요청 경로 찾기 |
데이터와 쿼리#
가상 트리는 테이블 메타데이터를 <schema>/<table>.json 형태로 구성합니다. 각 테이블 문서는 qualifiedName, 메타데이터 소스, 쿼리 엔진을 명시합니다. 레거시 MCP 레이크가 없는 조직과 Neutron 사용을 선택한 조직은 Titan Catalog에서 메타데이터를 읽고 MCP 쿼리를 Neutron에서만 실행합니다. 이러한 요청은 DuckDB로 대체 실행되지 않습니다.
동일한 레이크 전체 메타데이터를 titan.information_schema.schemata, titan.information_schema.tables, titan.information_schema.columns로 쿼리할 수도 있습니다. Neutron에서는 SQL 문이 데이터 테이블을 직접 참조하지 않더라도 Supernova가 Titan의 현재 레이크 목록에서 이러한 관계를 확인합니다.
데이터 연결#
필요한 데이터 소스가 Supernova에 연결되어 있지 않으면 connect_data는 앱에 표시되는 것과 동일한 조직별 커넥터 카탈로그를 검색합니다. 정확히 일치하거나 유일하게 일치하는 항목이 있으면 커넥터 이름과 /apps/new 아래의 절대 설정 URL을 반환합니다. 여러 항목이 일치하면 사용자가 원하는 소스를 명확히 지정할 수 있도록 이름과 설정 URL을 반환합니다.
일치하는 사용 가능한 커넥터가 없으면 결과에서 커넥터를 요청할지 묻고 기존 커넥터 요청 페이지 URL을 반환합니다. 또한 requestSubmitted를 false로 설정합니다. 이 도구를 열거나 호출하는 것만으로는 동의 없이 요청이 제출되지 않습니다.
저장소와 대시보드#
저장소 및 대시보드 도구는 기본적으로 refs/heads/main을 사용하며 브랜치 ref도 받습니다. 모든 대시보드 결과에는 Supernova에서 해당 브랜치의 실시간 대시보드로 연결되는 url과 유효 기간이 짧고 픽셀 단위로 정확한 PNG 캡처인 previewImageUrl이 포함됩니다. 실시간 URL은 Supernova에서 대화형 대시보드를 엽니다. 미리보기 PNG는 대시보드를 수정하는 동안 레이아웃, 스타일, 데이터 표현, 사용자 지정 컴포넌트 출력을 비교하는 시각적 검증 자료입니다.
미리보기는 축소판이 아닌 실제 전체 대시보드입니다. Chromium은 1440 x 900으로 고정된 데스크톱 뷰포트에서 앱과 동일한 DashboardView, 테마, 쿼리 결과, 사용자 지정 컴포넌트를 렌더링하고 대시보드의 전체 세로 영역을 1x 배율로 캡처합니다. 글꼴, 이미지, 쿼리, 사용자 지정 컴포넌트가 모두 준비된 뒤 캡처하므로 리비전 간 시각적 비교 결과가 일관됩니다.
각 previewImageUrl에는 1시간 뒤 만료되는 서명된 bearer 토큰이 포함되며, 이 토큰은 조직, 사용자, 대시보드 경로, Git ref에 바인딩됩니다. 미리보기 응답은 비공개이며 no-store 캐싱을 사용합니다.
쿼리 제한#
MCP 쿼리는 5분 뒤 시간 초과됩니다. 반환되는 미리보기는 최대 500행 또는 100 KB로 제한됩니다. where, order by, limit을 사용해 원하는 결과를 명확히 지정하세요.
select id, amount, currency
from titan.stripe.charges
where status = 'succeeded' and not _deleted
order by created_at desc
limit 50레이크를 변경하는 SQL은 SQL 문을 허용하는 단계에서 거부됩니다. MCP 서비스는 조직 범위로 동작하며 상태를 저장하지 않습니다. 한 조직의 토큰으로 다른 조직의 물리적 레이크나 데이터 저장소를 지정할 수 없습니다.