Uwierzytelnianie

Każde wywołanie wymaga konta TerraLab, poza dwoma publicznymi dokumentami: /v1/openapi.json i /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.
2. Otwórz Panel, 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:

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.

Większość agentów robi to wszystko sama: wklejasz tylko adres URL serwera. Zobacz Serwer MCP.

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

Odłączanie agenta

Panel, MCP pokazuje Twoje Connected apps. Disconnect cofa dostęp tej aplikacji: jej następne wywołanie zwróci 401 z access_revoked.