Panduan cepat

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. Akun gratis dan tidak perlu kartu.
2. Buka 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:

export TERRALAB_API_KEY="tlk_your_key_here"

Periksa kunci

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

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:

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"}'

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"])

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.
• Dapatkan elevasi, profil, atau garis kontur dengan get_elevation.
• Telusuri semua 29 tool di referensi API.

Tambahkan TerraLab ke agen AI

Di Claude Code, satu perintah:

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.

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