# 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 ist ein Remote-MCP-Server über Streamable HTTP. Eine URL funktioniert in jedem Agenten:

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

Beim ersten Mal bittet Ihr Agent Sie, sich bei TerraLab anzumelden. Ihre kostenlosen Aufrufe und Ihr Guthaben sehen Sie im [Dashboard, MCP](https://terra-lab.ai/de/dashboard/mcp).

## Claude

Öffnen Sie den vorausgefüllten Dialog: [TerraLab zu Claude hinzufügen](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). Klicken Sie auf **Add**, dann auf **Connect**, und melden Sie sich bei TerraLab an.

Oder öffnen Sie in Claude **Settings**, **Connectors**, **Add custom connector** und fügen Sie die Server-URL ein.

## ChatGPT

Öffnen Sie die [TerraLab-App in ChatGPT](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), klicken Sie auf **Add** und beginnen Sie Ihre Nachricht mit `@TerraLab`.

## Claude Code

Führen Sie dies in Ihrem Terminal aus:

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

Führen Sie dann `/mcp` in Claude Code aus und melden Sie sich bei TerraLab an. Fertige GIS-Workflows gibt es 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 fügt den Server hinzu und öffnet die TerraLab-Anmeldung in Ihrem Browser. Danach funktioniert er in der CLI, in der IDE-Erweiterung und in der App. Der gleiche Eintrag in `~/.codex/config.toml`:

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

## Cursor

Öffnen Sie den Installationslink: [TerraLab zu Cursor hinzufügen](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). Cursor zeigt den Server an: Klicken Sie auf **Install** und melden Sie sich an, wenn danach gefragt wird.

Oder fügen Sie in den MCP-Einstellungen von Cursor einen Remote-Server hinzu, in `.cursor/mcp.json`:

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

## VS Code

Öffnen Sie den Installationslink: [TerraLab zu VS Code hinzufügen](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). Klicken Sie auf **Install**, melden Sie sich bei TerraLab an und fragen Sie dann Copilot im Agent-Modus.

Oder in `.vscode/mcp.json`:

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

## Andere Agenten

Fügen Sie in jedem Agenten, der einen Remote-MCP-Server annimmt, diesen mit der obigen URL hinzu; er öffnet die TerraLab-Anmeldung. Gemini CLI:

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

## Tools

Der Server stellt 29 Tools bereit. Jedes ist mit seinen Parametern und einem Anfragebeispiel in der [API-Referenz](https://terra-lab.ai/docs/api) dokumentiert: Das MCP-Tool und der REST-Endpoint haben denselben Namen und dieselben Argumente.

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

## Was Sie fragen können

- „Finde die Koordinaten dieser 40 Adressen und gib mir eine CSV für QGIS.“
- „Extrahiere die Gebäude und Straßen im Umkreis von 1 km um den Bahnhof Annecy als GeoPackage.“
- „Höhenprofil von Chamonix zur Aiguille du Midi.“
- „Welche Naturgefahren gelten bei 12 rue de la Paix, Annecy?“

Die Antworten zeigen im Chat eine Karte, wenn der Agent das unterstützt, und liefern Dateien, die sich in QGIS, ArcGIS oder Google Earth öffnen lassen.

## Fehlerbehebung

- **TerraLab erscheint in Claude als verbunden, hat aber keine Tools.** Wenn Sie es vor dem 26. Oktober 2026 hinzugefügt haben, entfernen Sie den Connector und fügen Sie ihn erneut hinzu: Claude bietet dann die TerraLab-Anmeldung an.
- **Der Agent meldet, die kostenlosen Aufrufe seien aufgebraucht.** Laden Sie Guthaben im [Dashboard, MCP](https://terra-lab.ai/de/dashboard/mcp) auf oder warten Sie bis zum 1. des Monats. Siehe [Preise und kostenlose Aufrufe](https://terra-lab.ai/de/docs/pricing).
- **Ein Tool antwortet mit einem Fehler.** Sein `message` und sein `hint` sagen, was zu ändern ist. Siehe [Fehler und Rate Limits](https://terra-lab.ai/de/docs/errors).

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