# Connecter un agent

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

TerraLab est un serveur MCP distant en Streamable HTTP. Une seule URL fonctionne dans tous les agents :

```text
https://mcp.terra-lab.ai/mcp
```

La première fois, votre agent vous demande de vous connecter à TerraLab. Vos appels gratuits et votre solde s'affichent sur [Tableau de bord, MCP](https://terra-lab.ai/fr/dashboard/mcp).

## Claude

Ouvrez la boîte de dialogue préremplie : [ajouter TerraLab à Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). Cliquez sur **Add**, puis **Connect**, et connectez-vous à TerraLab.

Ou, dans Claude, ouvrez **Settings**, **Connectors**, **Add custom connector**, et collez l'URL du serveur.

## ChatGPT

Ouvrez l'[app TerraLab dans ChatGPT](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), cliquez sur **Add**, puis commencez votre message par `@TerraLab`.

## Claude Code

Lancez ceci dans votre terminal :

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

Lancez ensuite `/mcp` dans Claude Code et connectez-vous à TerraLab. Des workflows SIG prêts à l'emploi sont fournis sous forme de plugin :

```text
/plugin marketplace add TerraLabAI/mcp
/plugin install terralab@terralab-ai-apps
```

## Codex

```bash
codex mcp add terralab --url https://mcp.terra-lab.ai/mcp
```

Codex ajoute le serveur et ouvre la connexion TerraLab dans votre navigateur. Il fonctionne ensuite dans la CLI, l'extension d'IDE et l'app. La même entrée dans `~/.codex/config.toml` :

```toml
[mcp_servers.terralab]
url = "https://mcp.terra-lab.ai/mcp"
```

## Cursor

Ouvrez le lien d'installation : [ajouter TerraLab à Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). Cursor affiche le serveur : cliquez sur **Install**, puis connectez-vous quand il le demande.

Ou ajoutez un serveur distant dans les réglages MCP de Cursor, dans `.cursor/mcp.json` :

```json
{
  "mcpServers": {
    "terralab": { "url": "https://mcp.terra-lab.ai/mcp" }
  }
}
```

## VS Code

Ouvrez le lien d'installation : [ajouter TerraLab à VS Code](vscode:mcp/install?%7B%22name%22%3A%22terralab%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp%22%7D). Cliquez sur **Install**, connectez-vous à TerraLab, puis interrogez Copilot en mode agent.

Ou dans `.vscode/mcp.json` :

```json
{
  "servers": {
    "terralab": { "type": "http", "url": "https://mcp.terra-lab.ai/mcp" }
  }
}
```

## Autres agents

Ajoutez un serveur MCP distant avec l'URL ci-dessus dans tout agent qui en accepte un ; il ouvre la connexion TerraLab. Gemini CLI :

```bash
gemini mcp add --transport http -s user terralab https://mcp.terra-lab.ai/mcp
```

## Outils

Le serveur expose 29 outils. Chacun est documenté avec ses paramètres et un exemple de requête dans la [référence de l'API](https://terra-lab.ai/docs/api) : l'outil MCP et l'endpoint REST portent le même nom et prennent les mêmes arguments.

- **Places**: [Find places and addresses](https://terra-lab.ai/docs/api/find_places), [Convert coordinates](https://terra-lab.ai/docs/api/convert_coordinates), [Measure distance, area, radius or buffer](https://terra-lab.ai/docs/api/measure)
- **Map data**: [Extract open map data for an area](https://terra-lab.ai/docs/api/extract_open_data), [Open, map and convert GIS data](https://terra-lab.ai/docs/api/open_gis_file), [Buffer, merge, clip or simplify features](https://terra-lab.ai/docs/api/process_geometry)
- **Terrain and routes**: [Elevation, profile and contour lines](https://terra-lab.ai/docs/api/get_elevation), [Road route between places](https://terra-lab.ai/docs/api/get_route), [Area reachable in a travel time](https://terra-lab.ai/docs/api/get_travel_area)
- **Imagery and land**: [Satellite image of an area](https://terra-lab.ai/docs/api/get_satellite_image), [Forest type (natural, planted, plantation)](https://terra-lab.ai/docs/api/get_forest_type), [Estimate the population of an area](https://terra-lab.ai/docs/api/estimate_population)
- **France**: [French cadastral parcel and zoning](https://terra-lab.ai/docs/api/french_parcel), [French building heights](https://terra-lab.ai/docs/api/french_building_heights), [Natural risks at an address or a point](https://terra-lab.ai/docs/api/get_natural_risks)
- **Data catalog**: [Find a dataset in the TerraLab catalogue](https://terra-lab.ai/docs/api/find_datasets), [Extract a hosted dataset for an area](https://terra-lab.ai/docs/api/extract_dataset), [Ask TerraLab to add data it does not have](https://terra-lab.ai/docs/api/request_data)

## Quoi demander

- « Trouve les coordonnées de ces 40 adresses et donne-moi un CSV pour QGIS. »
- « Extrais les bâtiments et les routes à moins de 1 km de la gare d'Annecy en GeoPackage. »
- « Profil d'altitude de Chamonix à l'Aiguille du Midi. »
- « Quels risques naturels concernent le 12 rue de la Paix, Annecy ? »

Les réponses affichent une carte dans la conversation quand l'agent le permet, et fournissent des fichiers qui s'ouvrent dans QGIS, ArcGIS ou Google Earth.

## Dépannage

- **TerraLab apparaît comme connecté dans Claude mais n'a aucun outil.** Si vous l'avez ajouté avant le 26 octobre 2026, supprimez le connecteur et ajoutez-le à nouveau : Claude propose alors la connexion TerraLab.
- **L'agent dit que les appels gratuits sont épuisés.** Rechargez sur [Tableau de bord, MCP](https://terra-lab.ai/fr/dashboard/mcp) ou attendez le 1er du mois. Voir [Tarifs et appels gratuits](https://terra-lab.ai/fr/docs/pricing).
- **Un outil répond par une erreur.** Son `message` et son `hint` disent quoi changer. Voir [Erreurs et limites de débit](https://terra-lab.ai/fr/docs/errors).

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