Conectar um agente

A TerraLab é um servidor MCP remoto sobre Streamable HTTP. Uma única URL funciona em todos os agentes:

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

Na primeira vez, seu agente pede que você entre na TerraLab. Suas chamadas gratuitas e seu saldo aparecem em Dashboard, MCP.

Claude

Abra o diálogo já preenchido: adicionar a TerraLab ao Claude. Clique em Add, depois em Connect, e entre na TerraLab.

Ou, no Claude, abra Settings, Connectors, Add custom connector e cole a URL do servidor.

ChatGPT

Abra o app TerraLab no ChatGPT, clique em Add e comece sua mensagem com @TerraLab.

Claude Code

Execute isto no seu terminal:

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

Depois execute /mcp no Claude Code e entre na TerraLab. Fluxos de trabalho de SIG prontos vêm como um plugin:

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

Codex

codex mcp add terralab --url https://mcp.terra-lab.ai/mcp

O Codex adiciona o servidor e abre o login da TerraLab no seu navegador. Depois ele funciona na CLI, na extensão da IDE e no app. A mesma entrada em ~/.codex/config.toml:

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

Cursor

Abra o link de instalação: adicionar a TerraLab ao Cursor. O Cursor mostra o servidor: clique em Install e entre quando ele pedir.

Ou adicione um servidor remoto nas configurações de MCP do Cursor, em .cursor/mcp.json:

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

VS Code

Abra o link de instalação: adicionar a TerraLab ao VS Code. Clique em Install, entre na TerraLab e depois pergunte ao Copilot no modo agente.

Ou em .vscode/mcp.json:

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

Outros agentes

Adicione um servidor MCP remoto com a URL acima em qualquer agente que aceite uma; ele abre o login da TerraLab. Gemini CLI:

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

Ferramentas

O servidor expõe 29 ferramentas. Cada uma está documentada com seus parâmetros e um exemplo de requisição na referência da API: a ferramenta MCP e o endpoint REST têm o mesmo nome e os mesmos 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

O que pedir

• "Encontre as coordenadas destes 40 endereços e me dê um CSV para o QGIS."
• "Extraia os edifícios e as vias em 1 km ao redor da estação de Annecy como um GeoPackage."
• "Perfil de elevação de Chamonix até a Aiguille du Midi."
• "Quais riscos naturais se aplicam a 12 rue de la Paix, Annecy?"

As respostas mostram um mapa no chat quando o agente suporta isso, e entregam arquivos que abrem no QGIS, no ArcGIS ou no Google Earth.

Solução de problemas

• A TerraLab aparece como conectada no Claude, mas não tem ferramentas. Se você a adicionou antes de 26 de outubro de 2026, remova o conector e adicione-o de novo: o Claude passa então a oferecer o login da TerraLab.
• O agente diz que as chamadas gratuitas acabaram. Recarregue em Dashboard, MCP ou espere o dia 1º do mês. Veja Preços e chamadas gratuitas.
• Uma ferramenta responde com um erro. Seu message e seu hint dizem o que mudar. Veja Erros e limites de taxa.