Dostęp przez MCP#

Połącz klienta MCP z https://mcp.supernova.ai/mcp. Supernova używa OAuth 2.1 z PKCE, pokazuje organizację powiązaną z aktywną sesją i wyświetla dokładne zakresy przed przyznaniem dostępu.

Zakresy#

Zakres	Przyznaje
`files:read`	Metadane jeziora, odczyt repozytorium danych i dashboardów oraz wykrywanie konektorów
`files:write`	Commity repozytorium danych i dashboardów
`files:admin`	Inicjowanie nowych repozytoriów danych organizacji
`query:execute`	`run_query`

Tokeny dostępu są ważne przez 1 godzinę. Tokeny odświeżania są ważne przez 30 dni i można je unieważnić. Unieważnienie zapobiega wystawianiu nowych tokenów dostępu; już wystawiony token wygasa w zwykłym terminie.

Wykrywanie OAuth#

Klient MCP może wykryć serwer autoryzacji z adresu metadanych chronionego zasobu dla endpointu MCP albo z nieuwierzytelnionej odpowiedzi 401 tego endpointu:

Metadane chronionego zasobu: https://mcp.supernova.ai/.well-known/oauth-protected-resource/mcp
Metadane serwera autoryzacji: https://mcp.supernova.ai/.well-known/oauth-authorization-server

Dla klientów, które nie tworzą adresu właściwego dla ścieżki, dostępny jest też adres metadanych chronionego zasobu na poziomie origin.

Narzędzia#

Narzędzie	Przeznaczenie
`list_files`	Przeglądanie wirtualnego drzewa schematów
`read_file`	Odczyt schematu tabeli i kwalifikowanej nazwy SQL
`run_query`	Wykonanie jednej instrukcji SQL tylko do odczytu
`list_repo_files`	Lista plików repozytorium danych organizacji dla odwołania Git
`read_repo_file`	Odczyt jednego pliku UTF-8 z repozytorium danych
`write_repo_file`	Zapis commitu jednego pliku UTF-8 w repozytorium danych
`list_dashboards`	Lista aktywnych dashboardów dla odwołania Git
`read_dashboard`	Odczyt jednego aktywnego dokumentu dashboardu w Markdown
`write_dashboard`	Zapis commitu jednego aktywnego dokumentu dashboardu w Markdown
`connect_data`	Znalezienie adresu konfiguracji dostępnego źródła albo ścieżki zgłoszenia brakującego konektora

Dane i zapytania#

Wirtualne drzewo organizuje metadane tabel jako <schema>/<table>.json. Każdy dokument tabeli wskazuje qualifiedName, źródło metadanych i silnik zapytań. Organizacje bez starszego jeziora MCP oraz organizacje korzystające z Neutron odczytują metadane z Titan Catalog i wykonują zapytania MCP tylko na Neutron. Te żądania nigdy nie przechodzą awaryjnie na DuckDB.

Te same metadane całego jeziora można odpytywać jako titan.information_schema.schemata, titan.information_schema.tables i titan.information_schema.columns. W Neutron Supernova rozwiązuje te relacje z bieżącego inwentarza jeziora Titan, również gdy instrukcja nie odwołuje się bezpośrednio do żadnej tabeli danych.

Łączenie danych#

Gdy potrzebne źródło danych nie jest połączone w Supernova, connect_data przeszukuje ten sam katalog konektorów właściwy dla organizacji, który pokazuje aplikacja. Dokładne lub unikatowe dopasowanie zwraca nazwę konektora i bezwzględny adres konfiguracji w /apps/new. Wiele dopasowań zwraca ich nazwy i adresy, aby można było doprecyzować właściwe źródło.

Jeśli żaden dostępny konektor nie pasuje, wynik pyta, czy należy go zgłosić, i zwraca istniejący adres strony zgłoszenia. Ustawia również requestSubmitted na false: otwarcie lub wywołanie narzędzia nie wysyła zgłoszenia bez takiej zgody.

Repozytorium i dashboardy#

Narzędzia repozytorium i dashboardów domyślnie używają refs/heads/main i przyjmują odwołania do gałęzi. Każdy wynik dashboardu zawiera url aktywnego dashboardu w Supernova, świadomy gałęzi, oraz previewImageUrl krótkotrwałego, dokładnego co do piksela obrazu PNG. Aktywny adres otwiera interaktywny dashboard. Podgląd PNG służy do weryfikacji układu, stylu, prezentacji danych i wyniku komponentów niestandardowych podczas kolejnych zmian.

Podgląd przedstawia cały rzeczywisty dashboard, a nie miniaturę. Chromium renderuje ten sam DashboardView, motyw, wyniki zapytań i komponenty niestandardowe co aplikacja, w stałym desktopowym widoku 1440 × 900, po czym przechwytuje pełną wysokość przy skali 1×. Czcionki, obrazy, zapytania i komponenty muszą zakończyć pracę przed przechwyceniem, dzięki czemu wizualne porównania rewizji są deterministyczne.

Każdy previewImageUrl zawiera podpisany token bearer, który wygasa po 1 godzinie i jest powiązany z organizacją, użytkownikiem, ścieżką dashboardu i odwołaniem Git. Odpowiedzi podglądu są prywatne i używają buforowania no-store.

Limity zapytań#

Zapytania MCP przekraczają limit czasu po 5 minutach. Zwracane podglądy są ograniczone do 500 wierszy lub 100 KB. Użyj where, order by i limit, aby jawnie określić żądany wynik.

sql

select id, amount, currency
from titan.stripe.charges
where status = 'succeeded' and not _deleted
order by created_at desc
limit 50

SQL zmieniający jezioro jest odrzucany na granicy dopuszczenia instrukcji. Usługa MCP ma zakres organizacji i nie przechowuje stanu; token jednej organizacji nie może wskazać fizycznego jeziora ani repozytorium danych innej organizacji.