Connecter un agent

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

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.

Claude

Ouvrez la boîte de dialogue préremplie : ajouter TerraLab à Claude. 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, cliquez sur Add, puis commencez votre message par @TerraLab.

Claude Code

Lancez ceci dans votre terminal :

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 :

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

Codex

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 :

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

Cursor

Ouvrez le lien d'installation : ajouter TerraLab à Cursor. 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 :

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

VS Code

Ouvrez le lien d'installation : ajouter TerraLab à VS Code. Cliquez sur Install, connectez-vous à TerraLab, puis interrogez Copilot en mode agent.

Ou dans .vscode/mcp.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 :

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 : l'outil MCP et l'endpoint REST portent le même nom et prennent les mêmes arguments.

• Places: Find places and addresses, Convert coordinates, Measure distance, area, radius or buffer
• Map data: Extract open map data for an area, Open, map and convert GIS data, Buffer, merge, clip or simplify features
• Terrain and routes: Elevation, profile and contour lines, Road route between places, Area reachable in a travel time
• Imagery and land: Satellite image of an area, Forest type (natural, planted, plantation), Estimate the population of an area
• France: French cadastral parcel and zoning, French building heights, Natural risks at an address or a point
• Data catalog: Find a dataset in the TerraLab catalogue, Extract a hosted dataset for an area, Ask TerraLab to add data it does not have

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 ou attendez le 1er du mois. Voir Tarifs et appels gratuits.
• Un outil répond par une erreur. Son message et son hint disent quoi changer. Voir Erreurs et limites de débit.