# Panduan cepat

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

Dua jalur: memanggil REST API dari kode, atau menambahkan server MCP ke agen AI. Keduanya memakai akun yang sama dan 100 panggilan gratis per bulan yang sama.

## Panggil API dari kode

### Buat kunci API

1. Masuk di [terra-lab.ai/login](https://terra-lab.ai/id/login). Akun gratis dan tidak perlu kartu.
2. Buka [Dashboard, MCP](https://terra-lab.ai/id/dashboard/mcp), lalu **Advanced**, **API keys**.
3. Beri nama kunci, setujui ketentuan API, dan klik **Create key**.
4. Salin kunci sekarang: diawali `tlk_` dan hanya ditampilkan sekali.

Simpan di variabel lingkungan, jangan pernah di kode Anda:

```bash
export TERRALAB_API_KEY="tlk_your_key_here"
```

### Periksa kunci

`GET /v1/me` mengembalikan akun Anda dan sisa panggilan bulan ini.

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

`401` berarti kunci tidak ada, salah ketik, atau sudah dicabut.

### Lakukan panggilan tool pertama

Cari koordinat sebuah alamat dengan `find_places`:

```bash
curl -X POST https://mcp.terra-lab.ai/v1/tools/find_places \
  -H "Authorization: Bearer $TERRALAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"12 rue de la Paix, Annecy"}'
```

```python
import os
import requests

response = requests.post(
    "https://mcp.terra-lab.ai/v1/tools/find_places",
    headers={"Authorization": f"Bearer {os.environ['TERRALAB_API_KEY']}"},
    json={"query": "12 rue de la Paix, Annecy"},
    timeout=120,
)
response.raise_for_status()
print(response.json()["structuredContent"])
```

```javascript
const response = await fetch('https://mcp.terra-lab.ai/v1/tools/find_places', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TERRALAB_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query: '12 rue de la Paix, Annecy' }),
});
const data = await response.json();
console.log(data.structuredContent);
```

Jawabannya berupa objek JSON: `structuredContent` berisi hasil beserta `sources`-nya, `content` hasil yang sama dalam bentuk teks, dan `isError` menunjukkan apakah tool menolak permintaan.

### Lanjutkan

- Ekstrak bangunan dan jalan untuk sebuah area dengan [extract_open_data](https://terra-lab.ai/docs/api/extract_open_data).
- Dapatkan elevasi, profil, atau garis kontur dengan [get_elevation](https://terra-lab.ai/docs/api/get_elevation).
- Telusuri semua 29 tool di [referensi API](https://terra-lab.ai/docs/api).

## Tambahkan TerraLab ke agen AI

Di Claude Code, satu perintah:

```bash
claude mcp add --transport http terralab https://mcp.terra-lab.ai/mcp
```

Lalu jalankan `/mcp` di Claude Code dan masuk ke TerraLab. Untuk Claude, ChatGPT, Cursor, Codex, dan VS Code, lihat [server MCP](https://terra-lab.ai/id/docs/mcp).

Tanyakan, misalnya: "Tampilkan bangunan dalam radius 500 m dari stasiun Lyon Part-Dieu dan beri saya GeoPackage."

Source: https://terra-lab.ai/id/docs/quickstart · Updated 2026-10-27