Conectar un agente

TerraLab es un servidor MCP remoto sobre Streamable HTTP. Una sola URL funciona en todos los agentes:

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.

Claude

Abre el diálogo ya rellenado: añadir TerraLab a Claude. 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, haz clic en Add y empieza tu mensaje con @TerraLab.

Claude Code

Ejecuta esto en tu terminal:

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:

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

Codex

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:

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

Cursor

Abre el enlace de instalación: añadir TerraLab a Cursor. 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:

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

VS Code

Abre el enlace de instalación: añadir TerraLab a VS Code. Haz clic en Install, inicia sesión en TerraLab y pregunta a Copilot en modo agente.

O en .vscode/mcp.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:

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: la herramienta MCP y el endpoint REST comparten el mismo nombre y los mismos argumentos.

• 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

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 o espera al día 1 del mes. Consulta Precios y llamadas gratuitas.
• Una herramienta responde con un error. Su message y su hint indican qué cambiar. Consulta Errores y límites de uso.