Quickstart

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 an. Ein Konto ist kostenlos und braucht keine Karte.
2. Öffnen Sie 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:

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.

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:

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);

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.
• Holen Sie Höhe, ein Profil oder Höhenlinien mit get_elevation.
• Stöbern Sie in allen 29 Tools in der API-Referenz.

TerraLab zu einem KI-Agenten hinzufügen

In Claude Code mit einem Befehl:

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.

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