# Conectar 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 es un servidor MCP remoto sobre Streamable HTTP. Una sola URL funciona en todos los agentes:

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

La primera vez, tu agente te pide iniciar sesión en TerraLab. Tus llamadas gratuitas y tu saldo aparecen en [Dashboard, MCP](https://terra-lab.ai/es/dashboard/mcp).

## Claude

Abre el diálogo ya rellenado: [añadir TerraLab a Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). Haz clic en **Add**, luego en **Connect**, e inicia sesión en TerraLab.

O, en Claude, abre **Settings**, **Connectors**, **Add custom connector** y pega la URL del servidor.

## ChatGPT

Abre la [app de TerraLab en ChatGPT](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), haz clic en **Add** y empieza tu mensaje con `@TerraLab`.

## Claude Code

Ejecuta esto en tu terminal:

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

Después ejecuta `/mcp` en Claude Code e inicia sesión en TerraLab. Los flujos de trabajo SIG listos para usar vienen como un 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 añade el servidor y abre en tu navegador el inicio de sesión de TerraLab. Después funciona en la CLI, en la extensión del IDE y en la app. La misma entrada en `~/.codex/config.toml`:

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

## Cursor

Abre el enlace de instalación: [añadir TerraLab a Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). Cursor muestra el servidor: haz clic en **Install** e inicia sesión cuando te lo pida.

O añade un servidor remoto en los ajustes de MCP de Cursor, en `.cursor/mcp.json`:

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

## VS Code

Abre el enlace de instalación: [añadir 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). Haz clic en **Install**, inicia sesión en TerraLab y pregunta a Copilot en modo agente.

O en `.vscode/mcp.json`:

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

## Otros agentes

Añade un servidor MCP remoto con la URL anterior en cualquier agente que lo admita; se abre el inicio de sesión de TerraLab. Gemini CLI:

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

## Herramientas

El servidor expone 29 herramientas. Cada una está documentada con sus parámetros y un ejemplo de solicitud en la [referencia de la API](https://terra-lab.ai/docs/api): la herramienta MCP y el endpoint REST comparten el mismo nombre y los mismos argumentos.

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

## Qué pedir

- "Busca las coordenadas de estas 40 direcciones y dame un CSV para QGIS."
- "Extrae los edificios y las carreteras a menos de 1 km de la estación de Annecy como GeoPackage."
- "Perfil de elevación de Chamonix a la Aiguille du Midi."
- "¿Qué riesgos naturales afectan al 12 rue de la Paix, Annecy?"

Las respuestas muestran un mapa en el chat cuando el agente lo admite, y entregan archivos que se abren en QGIS, ArcGIS o Google Earth.

## Solución de problemas

- **TerraLab aparece como conectado en Claude pero no tiene herramientas.** Si lo añadiste antes del 26 de octubre de 2026, elimina el conector y vuelve a añadirlo: Claude te ofrecerá entonces el inicio de sesión de TerraLab.
- **El agente dice que las llamadas gratuitas se han agotado.** Recarga en [Dashboard, MCP](https://terra-lab.ai/es/dashboard/mcp) o espera al día 1 del mes. Consulta [Precios y llamadas gratuitas](https://terra-lab.ai/es/docs/pricing).
- **Una herramienta responde con un error.** Su `message` y su `hint` indican qué cambiar. Consulta [Errores y límites de uso](https://terra-lab.ai/es/docs/errors).

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