# Démarrage rapide

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

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](https://terra-lab.ai/fr/login). Un compte est gratuit et ne demande aucune carte.
2. Ouvrez [Tableau de bord, MCP](https://terra-lab.ai/fr/dashboard/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 :

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

```bash
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` :

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

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](https://terra-lab.ai/docs/api/extract_open_data).
- Obtenez l'altitude, un profil ou des courbes de niveau avec [get_elevation](https://terra-lab.ai/docs/api/get_elevation).
- Parcourez les 29 outils dans la [référence de l'API](https://terra-lab.ai/docs/api).

## Ajouter TerraLab à un agent IA

Dans Claude Code, une seule commande :

```bash
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](https://terra-lab.ai/fr/docs/mcp).

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

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