Démarrage rapide

Deux voies : appeler l'API REST depuis du code, ou ajouter le serveur MCP à un agent IA. Les deux utilisent le même compte et les mêmes 100 appels gratuits par mois.

Appeler l'API depuis du code

Créer une clé API

1. Connectez-vous sur terra-lab.ai/login. Un compte est gratuit et ne demande aucune carte.
2. Ouvrez Tableau de bord, MCP, puis Advanced, API keys.
3. Nommez la clé, acceptez les conditions de l'API et cliquez sur Create key.
4. Copiez la clé maintenant : elle commence par tlk_ et ne s'affiche qu'une seule fois.

Gardez-la dans une variable d'environnement, jamais dans votre code :

export TERRALAB_API_KEY="tlk_your_key_here"

Vérifier la clé

GET /v1/me renvoie votre compte et les appels qu'il vous reste ce mois-ci.

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

Un 401 signifie que la clé est absente, mal saisie ou révoquée.

Faire votre premier appel d'outil

Trouvez les coordonnées d'une adresse avec 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);

La réponse est un objet JSON : structuredContent contient le résultat avec ses sources, content le même résultat sous forme de texte, et isError indique si l'outil a refusé la requête.

Aller plus loin

• Extrayez les bâtiments et les routes d'une zone avec extract_open_data.
• Obtenez l'altitude, un profil ou des courbes de niveau avec get_elevation.
• Parcourez les 29 outils dans la référence de l'API.

Ajouter TerraLab à un agent IA

Dans Claude Code, une seule commande :

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

Lancez ensuite /mcp dans Claude Code et connectez-vous à TerraLab. Pour Claude, ChatGPT, Cursor, Codex et VS Code, voir Serveur MCP.

Demandez par exemple : « Montre les bâtiments à moins de 500 m de la gare de Lyon Part-Dieu et donne-moi un GeoPackage. »