Autentikasi

Setiap panggilan memerlukan akun TerraLab, kecuali dua dokumen publik: /v1/openapi.json dan /v1/meta/pricing. Ada dua cara mengirimnya: kunci API untuk kode, OAuth 2.1 untuk agen.

Kunci API

Pakai kunci untuk skrip, back end, dan notebook, yaitu apa pun yang tidak bisa membuka browser untuk masuk.

1. Masuk di terra-lab.ai/login.
2. Buka Dashboard, MCP, lalu Advanced, API keys.
3. Beri nama kunci, setujui ketentuan API, dan klik Create key.
4. Salin segera. Kunci diawali tlk_, diikuti 48 karakter heksadesimal, dan hanya ditampilkan sekali: TerraLab menyimpan hash, tidak pernah kuncinya.

Kirim di header Authorization:

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

Kunci tidak kedaluwarsa, dan satu akun bisa memiliki hingga 20 kunci aktif. Klik Revoke pada kunci di halaman yang sama bila kunci bocor atau proyek berakhir: panggilan berikutnya dengan kunci itu dijawab 401. Panggilan dengan kunci dihitung pada akun yang membuatnya.

Jangan simpan kunci di source control, kode front-end, atau tangkapan layar. Bacalah dari variabel lingkungan atau secret manager.

OAuth 2.1 untuk agen

Agen AI masuk tanpa kunci. Saat agen pertama kali memanggil https://mcp.terra-lab.ai/mcp tanpa token, server menjawab 401 dengan header WWW-Authenticate yang menunjuk ke metadatanya, lalu agen membuka halaman masuk TerraLab di browser Anda. Anda menyetujui sekali; setelah itu agen memegang token.

Sebagian besar agen mengurus semua ini sendiri: Anda cukup menempelkan URL server. Lihat server MCP.

Access token OAuth juga berfungsi di REST API, sebagai Bearer token di header yang sama.

Putuskan agen

Dashboard, MCP menampilkan daftar Connected apps Anda. Disconnect mencabut akses aplikasi itu: panggilan berikutnya dijawab 401 dengan access_revoked.