# Collegare un agente

> 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 è un server MCP remoto su Streamable HTTP. Un solo URL funziona in ogni agente:

```text
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](https://terra-lab.ai/it/dashboard/mcp).

## Claude

Apri la finestra precompilata: [aggiungi TerraLab a Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). 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](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), clicca **Add**, poi inizia il messaggio con `@TerraLab`.

## Claude Code

Esegui questo nel terminale:

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

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

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

## Cursor

Apri il link di installazione: [aggiungi TerraLab a Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). 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`:

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

## VS Code

Apri il link di installazione: [aggiungi TerraLab a 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). Clicca **Install**, accedi a TerraLab, poi interroga Copilot in modalità agente.

Oppure in `.vscode/mcp.json`:

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

```bash
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](https://terra-lab.ai/docs/api): il tool MCP e l'endpoint REST hanno lo stesso nome e gli stessi argomenti.

- **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)

## 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](https://terra-lab.ai/it/dashboard/mcp) oppure attendi il 1° del mese. Vedi [Prezzi e chiamate gratuite](https://terra-lab.ai/it/docs/pricing).
- **Un tool risponde con un errore.** Il suo `message` e il suo `hint` indicano cosa cambiare. Vedi [Errori e limiti di frequenza](https://terra-lab.ai/it/docs/errors).

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