Collegare un agente

TerraLab è un server MCP remoto su Streamable HTTP. Un solo URL funziona in ogni agente:

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

La prima volta, il tuo agente ti chiede di accedere a TerraLab. Le tue chiamate gratuite e il tuo saldo compaiono su Dashboard, MCP.

Claude

Apri la finestra precompilata: aggiungi TerraLab a Claude. Clicca Add, poi Connect, e accedi a TerraLab.

Oppure, in Claude, apri Settings, Connectors, Add custom connector, e incolla l'URL del server.

ChatGPT

Apri l'app TerraLab in ChatGPT, clicca Add, poi inizia il messaggio con @TerraLab.

Claude Code

Esegui questo nel terminale:

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

Poi esegui /mcp in Claude Code e accedi a TerraLab. I flussi di lavoro GIS già pronti arrivano come 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 aggiunge il server e apre l'accesso TerraLab nel browser. Poi funziona nella CLI, nell'estensione per IDE e nell'app. La stessa voce in ~/.codex/config.toml:

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

Cursor

Apri il link di installazione: aggiungi TerraLab a Cursor. Cursor mostra il server: clicca Install, poi accedi quando lo chiede.

Oppure aggiungi un server remoto nelle impostazioni MCP di Cursor, in .cursor/mcp.json:

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

VS Code

Apri il link di installazione: aggiungi TerraLab a VS Code. Clicca Install, accedi a TerraLab, poi interroga Copilot in modalità agente.

Oppure in .vscode/mcp.json:

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

Altri agenti

In qualsiasi agente che accetti un server MCP remoto, aggiungilo con l'URL qui sopra; si apre l'accesso TerraLab. Gemini CLI:

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

Tool

Il server espone 29 tool. Ognuno è documentato con i suoi parametri e un esempio di richiesta nel riferimento API: il tool MCP e l'endpoint REST hanno lo stesso nome e gli stessi argomenti.

• 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

Cosa chiedere

• "Trova le coordinate di questi 40 indirizzi e dammi un CSV per QGIS."
• "Estrai gli edifici e le strade entro 1 km dalla stazione di Annecy come GeoPackage."
• "Profilo altimetrico da Chamonix all'Aiguille du Midi."
• "Quali rischi naturali riguardano 12 rue de la Paix, Annecy?"

Le risposte mostrano una mappa nella chat quando l'agente lo supporta, e forniscono file che si aprono in QGIS, ArcGIS o Google Earth.

Risoluzione dei problemi

• TerraLab risulta collegato in Claude ma non ha tool. Se lo hai aggiunto prima del 26 ottobre 2026, rimuovi il connettore e aggiungilo di nuovo: Claude ti proporrà allora l'accesso a TerraLab.
• L'agente dice che le chiamate gratuite sono esaurite. Ricarica su Dashboard, MCP oppure attendi il 1° del mese. Vedi Prezzi e chiamate gratuite.
• Un tool risponde con un errore. Il suo message e il suo hint indicano cosa cambiare. Vedi Errori e limiti di frequenza.