---
title: Narzędzia zewnętrzne
description: Korzystaj z działających granic API, MCP i Git, aby odczytywać dane i zarządzać tworzonymi zasobami poza aplikacją.
species: reference
---
# 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](/docs/api/authentication) i [API zapytań](/docs/api/queries).

## 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](/docs/access/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.