# Quickstart

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

Twee wegen: de REST API aanroepen vanuit code, of de MCP-server toevoegen aan een AI-agent. Beide gebruiken hetzelfde account en dezelfde 100 gratis aanroepen per maand.

## De API aanroepen vanuit code

### Een API-sleutel maken

1. Log in op [terra-lab.ai/login](https://terra-lab.ai/nl/login). Een account is gratis en heeft geen kaart nodig.
2. Open [Dashboard, MCP](https://terra-lab.ai/nl/dashboard/mcp), dan **Advanced**, **API keys**.
3. Geef de sleutel een naam, accepteer de API-voorwaarden en klik op **Create key**.
4. Kopieer de sleutel nu: hij begint met `tlk_` en wordt maar één keer getoond.

Bewaar hem in een omgevingsvariabele, nooit in je code:

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

### De sleutel controleren

`GET /v1/me` geeft je account terug en de aanroepen die je deze maand nog hebt.

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

Een `401` betekent dat de sleutel ontbreekt, verkeerd is getypt of is ingetrokken.

### Je eerste toolaanroep doen

Zoek de coördinaten van een adres met `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);
```

Het antwoord is een JSON-object: `structuredContent` bevat het resultaat met zijn `sources`, `content` hetzelfde resultaat als tekst, en `isError` geeft aan of de tool de aanvraag heeft geweigerd.

### Verder gaan

- Haal gebouwen en wegen voor een gebied op met [extract_open_data](https://terra-lab.ai/docs/api/extract_open_data).
- Haal hoogte, een profiel of hoogtelijnen op met [get_elevation](https://terra-lab.ai/docs/api/get_elevation).
- Bekijk alle 29 tools in de [API-referentie](https://terra-lab.ai/docs/api).

## TerraLab toevoegen aan een AI-agent

In Claude Code, met één commando:

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

Voer daarna `/mcp` uit in Claude Code en log in bij TerraLab. Voor Claude, ChatGPT, Cursor, Codex en VS Code, zie [MCP-server](https://terra-lab.ai/nl/docs/mcp).

Vraag bijvoorbeeld: "Toon de gebouwen binnen 500 m van station Lyon Part-Dieu en geef me een GeoPackage."

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