Narzędzia zewnętrzne#
Supernova udostępnia 3 obsługiwane granice zewnętrzne: publiczne API do automatyzacji, MCP dla narzędzi agentowych i Git dla repozytorium danych organizacji. Każda z nich używa danych uwierzytelniających o węższym zakresie niż interaktywna sesja przeglądarki.
Publiczne API#
Użyj osobistego tokenu dostępu lub tokenu dostępu OAuth, aby przesyłać zapytania, przeglądać zasoby, uruchamiać obsługiwane działania i pobierać wyniki. Ścieżki API nie zawierają segmentu wersji. Mogą pojawiać się nowe pola; zmiana niezgodna wstecz wymaga nowego kontraktu, a nie cichej zmiany zachowania istniejącej ścieżki.
Zacznij od uwierzytelniania API i API zapytań.
MCP#
Użyj https://mcp.supernova.ai/mcp, aby korzystać z metadanych jeziora, ograniczonego SQL tylko do odczytu, plików w repozytorium danych organizacji i tworzenia dashboardów na żywo z podpisanymi podglądami wizualnymi. Zakresy OAuth rozdzielają odczyt, zapis i wykonywanie zapytań. Zobacz dostęp przez MCP.
Git#
Po dodaniu klucza SSH sklonuj repozytorium danych organizacji przy użyciu skonfigurowanego adresu Git. Modele, dashboardy, motywy, pakiety i typesql.lock są zwykłymi plikami podlegającymi przeglądowi. Wypchnięty commit staje się nową, ustaloną rewizją repozytorium używaną w kolejnych uruchomieniach.
Podsumowanie granic#
| Potrzeba | Granica | Dane uwierzytelniające |
|---|---|---|
| Odpytywanie lub automatyzowanie zasobów | Publiczne API | PAT lub token bearer OAuth |
| Dostęp agenta do przeglądania, zapytań i tworzenia dashboardów | MCP | Zakresy OAuth 2.1 |
| Lokalny przegląd tworzonych zasobów | Git | Klucz SSH autoryzowany przez organizację |
Bezpośrednie dane uwierzytelniające do magazynu i wewnętrzne endpointy usług nie są interfejsami integracji dla klientów. Zamiast samodzielnie odwoływać się do obiektów magazynu, używaj łączy wyników API do eksportu Parquet.