# Een agent verbinden

> 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 is een remote MCP-server via Streamable HTTP. Eén URL werkt in elke agent:

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

De eerste keer vraagt je agent je om in te loggen bij TerraLab. Je gratis aanroepen en saldo staan op [Dashboard, MCP](https://terra-lab.ai/nl/dashboard/mcp).

## Claude

Open het vooraf ingevulde dialoogvenster: [TerraLab toevoegen aan Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). Klik op **Add**, dan op **Connect**, en log in bij TerraLab.

Of open in Claude **Settings**, **Connectors**, **Add custom connector**, en plak de server-URL.

## ChatGPT

Open de [TerraLab-app in ChatGPT](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), klik op **Add**, en begin je bericht met `@TerraLab`.

## Claude Code

Voer dit uit in je terminal:

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

Voer daarna `/mcp` uit in Claude Code en log in bij TerraLab. Kant-en-klare GIS-workflows zijn er als 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 voegt de server toe en opent de TerraLab-login in je browser. Daarna werkt het in de CLI, de IDE-extensie en de app. Dezelfde invoer in `~/.codex/config.toml`:

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

## Cursor

Open de installatielink: [TerraLab toevoegen aan Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). Cursor toont de server: klik op **Install** en log in wanneer erom wordt gevraagd.

Of voeg een remote server toe in de MCP-instellingen van Cursor, in `.cursor/mcp.json`:

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

## VS Code

Open de installatielink: [TerraLab toevoegen aan 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). Klik op **Install**, log in bij TerraLab en vraag het daarna aan Copilot in agent mode.

Of in `.vscode/mcp.json`:

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

## Andere agents

Voeg een remote MCP-server toe met de URL hierboven in elke agent die er een accepteert; die opent de TerraLab-login. Gemini CLI:

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

## Tools

De server biedt 29 tools aan. Elke tool is gedocumenteerd met zijn parameters en een voorbeeldaanvraag in de [API-referentie](https://terra-lab.ai/docs/api): de MCP-tool en het REST-endpoint delen dezelfde naam en dezelfde argumenten.

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

## Wat je kunt vragen

- "Zoek de coördinaten van deze 40 adressen en geef me een CSV voor QGIS."
- "Haal de gebouwen en wegen binnen 1 km van station Annecy op als GeoPackage."
- "Hoogteprofiel van Chamonix naar de Aiguille du Midi."
- "Welke natuurrisico's gelden op 12 rue de la Paix, Annecy?"

Antwoorden tonen een kaart in de chat als de agent dat ondersteunt, en leveren bestanden die in QGIS, ArcGIS of Google Earth openen.

## Problemen oplossen

- **TerraLab staat in Claude als verbonden, maar heeft geen tools.** Als je het vóór 26 oktober 2026 hebt toegevoegd, verwijder de connector dan en voeg hem opnieuw toe: Claude biedt dan de TerraLab-login aan.
- **De agent zegt dat de gratis aanroepen op zijn.** Waardeer op via [Dashboard, MCP](https://terra-lab.ai/nl/dashboard/mcp) of wacht tot de 1e van de maand. Zie [Prijzen en gratis aanroepen](https://terra-lab.ai/nl/docs/pricing).
- **Een tool antwoordt met een fout.** Het `message` en de `hint` zeggen wat je moet aanpassen. Zie [Fouten en rate limits](https://terra-lab.ai/nl/docs/errors).

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