---
title: Dostęp przez MCP
description: Połącz klienta MCP z Supernova, aby korzystać z metadanych, ograniczonego SQL, konfiguracji źródeł, plików repozytorium danych i tworzenia dashboardów na żywo.
species: guide
---

# 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.