# Conectar um 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.

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

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

## Claude

Abra o diálogo já preenchido: [adicionar a TerraLab ao Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). 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](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), clique em **Add** e comece sua mensagem com `@TerraLab`.

## Claude Code

Execute isto no seu terminal:

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

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

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

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

## Cursor

Abra o link de instalação: [adicionar a TerraLab ao Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). 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`:

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

## VS Code

Abra o link de instalação: [adicionar a TerraLab ao 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). Clique em **Install**, entre na TerraLab e depois pergunte ao Copilot no modo agente.

Ou em `.vscode/mcp.json`:

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

```bash
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](https://terra-lab.ai/docs/api): a ferramenta MCP e o endpoint REST têm o mesmo nome e os mesmos 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)

## 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](https://terra-lab.ai/pt-BR/dashboard/mcp) ou espere o dia 1º do mês. Veja [Preços e chamadas gratuitas](https://terra-lab.ai/pt-BR/docs/pricing).
- **Uma ferramenta responde com um erro.** Seu `message` e seu `hint` dizem o que mudar. Veja [Erros e limites de taxa](https://terra-lab.ai/pt-BR/docs/errors).

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