# Uwierzytelnianie

> Index of the TerraLab docs for agents: [llms.txt](https://terra-lab.ai/docs/llms.txt). Every docs page is also served as markdown: add .md to its URL.

Każde wywołanie wymaga konta TerraLab, poza dwoma publicznymi dokumentami: [`/v1/openapi.json`](https://mcp.terra-lab.ai/v1/openapi.json) i [`/v1/meta/pricing`](https://mcp.terra-lab.ai/v1/meta/pricing). Są dwa sposoby: klucz API dla kodu, OAuth 2.1 dla agentów.

## Klucze API

Użyj klucza w skryptach, backendach i notebookach, wszędzie tam, gdzie nie da się otworzyć przeglądarki do logowania.

1. Zaloguj się na [terra-lab.ai/login](https://terra-lab.ai/pl/login).
2. Otwórz [Panel, MCP](https://terra-lab.ai/pl/dashboard/mcp), potem **Advanced**, **API keys**.
3. Nazwij klucz, zaakceptuj warunki API i kliknij **Create key**.
4. Skopiuj go od razu. Klucz zaczyna się od `tlk_`, po którym następuje 48 znaków szesnastkowych, i jest pokazywany tylko raz: TerraLab przechowuje skrót, nigdy sam klucz.

Wyślij go w nagłówku `Authorization`:

```bash
curl https://mcp.terra-lab.ai/v1/me \
  -H "Authorization: Bearer $TERRALAB_API_KEY"
```

Klucze nie wygasają, a konto może mieć do 20 aktywnych kluczy. Gdy klucz wycieknie albo projekt się skończy, użyj **Revoke** na tej samej stronie: kolejne wywołanie z tym kluczem zwróci `401`. Wywołania wykonane kluczem są liczone na koncie, które go utworzyło.

Nie trzymaj kluczy w repozytorium kodu, w kodzie front-endu ani na zrzutach ekranu. Czytaj je ze zmiennej środowiskowej lub menedżera sekretów.

## OAuth 2.1 dla agentów

Agenci AI logują się zamiast używać klucza. Gdy agent po raz pierwszy wywołuje `https://mcp.terra-lab.ai/mcp` bez tokena, serwer odpowiada `401` z nagłówkiem `WWW-Authenticate`, który wskazuje jego metadane, a agent otwiera w przeglądarce logowanie TerraLab. Zatwierdzasz raz, a agent dostaje token.

| Co | Wartość |
| --- | --- |
| Metadane chronionego zasobu | `https://mcp.terra-lab.ai/.well-known/oauth-protected-resource` |
| Serwer autoryzacji | `https://terra-lab.ai` |
| Metadane serwera | `https://terra-lab.ai/.well-known/oauth-authorization-server` |
| Grant | Kod autoryzacji z PKCE (`S256`), klienci publiczni |
| Rejestracja klienta | Rejestracja dynamiczna lub dokument metadanych identyfikatora klienta |
| Zakres | `data` |
| Ważność access tokena | 1 godzina, odnawiana refresh tokenem ważnym 30 dni |

Większość agentów robi to wszystko sama: wklejasz tylko adres URL serwera. Zobacz [Serwer MCP](https://terra-lab.ai/pl/docs/mcp).

Access token OAuth działa też w REST API, jako token Bearer w tym samym nagłówku.

## Odłączanie agenta

[Panel, MCP](https://terra-lab.ai/pl/dashboard/mcp) pokazuje Twoje **Connected apps**. **Disconnect** cofa dostęp tej aplikacji: jej następne wywołanie zwróci `401` z `access_revoked`.

Source: https://terra-lab.ai/pl/docs/authentication · Updated 2026-10-27