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

Zwei Wege: die REST API aus Code aufrufen oder den MCP-Server zu einem KI-Agenten hinzufügen. Beide nutzen dasselbe Konto und dieselben 100 kostenlosen Aufrufe pro Monat.

## Die API aus Code aufrufen

### Einen API-Key erstellen

1. Melden Sie sich unter [terra-lab.ai/login](https://terra-lab.ai/de/login) an. Ein Konto ist kostenlos und braucht keine Karte.
2. Öffnen Sie [Dashboard, MCP](https://terra-lab.ai/de/dashboard/mcp), dann **Advanced**, **API keys**.
3. Benennen Sie den Key, akzeptieren Sie die API-Bedingungen und klicken Sie auf **Create key**.
4. Kopieren Sie den Key jetzt: Er beginnt mit `tlk_` und wird nur einmal angezeigt.

Bewahren Sie ihn in einer Umgebungsvariable auf, nie in Ihrem Code:

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

### Den Key prüfen

`GET /v1/me` liefert Ihr Konto und die Aufrufe, die Ihnen diesen Monat noch bleiben.

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

Ein `401` bedeutet, dass der Key fehlt, falsch geschrieben oder widerrufen ist.

### Ihren ersten Tool-Aufruf machen

Finden Sie die Koordinaten einer Adresse mit `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);
```

Die Antwort ist ein JSON-Objekt: `structuredContent` enthält das Ergebnis mit seinen `sources`, `content` dasselbe Ergebnis als Text, und `isError` zeigt, ob das Tool die Anfrage abgelehnt hat.

### Weiter geht es

- Extrahieren Sie Gebäude und Straßen für ein Gebiet mit [extract_open_data](https://terra-lab.ai/docs/api/extract_open_data).
- Holen Sie Höhe, ein Profil oder Höhenlinien mit [get_elevation](https://terra-lab.ai/docs/api/get_elevation).
- Stöbern Sie in allen 29 Tools in der [API-Referenz](https://terra-lab.ai/docs/api).

## TerraLab zu einem KI-Agenten hinzufügen

In Claude Code mit einem Befehl:

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

Führen Sie dann `/mcp` in Claude Code aus und melden Sie sich bei TerraLab an. Für Claude, ChatGPT, Cursor, Codex und VS Code siehe [MCP-Server](https://terra-lab.ai/de/docs/mcp).

Fragen Sie zum Beispiel: „Zeige die Gebäude im Umkreis von 500 m um den Bahnhof Lyon Part-Dieu und gib mir ein GeoPackage.“

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