# Podłącz agenta

> 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 to zdalny serwer MCP przez Streamable HTTP. Jeden adres URL działa w każdym agencie:

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

Za pierwszym razem agent poprosi Cię o zalogowanie do TerraLab. Darmowe wywołania i saldo zobaczysz w [Panelu, MCP](https://terra-lab.ai/pl/dashboard/mcp).

## Claude

Otwórz gotowe okno: [dodaj TerraLab do Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp). Kliknij **Add**, potem **Connect** i zaloguj się do TerraLab.

Albo w Claude otwórz **Settings**, **Connectors**, **Add custom connector** i wklej adres URL serwera.

## ChatGPT

Otwórz [aplikację TerraLab w ChatGPT](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4), kliknij **Add**, a potem zacznij wiadomość od `@TerraLab`.

## Claude Code

Uruchom w terminalu:

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

Następnie uruchom `/mcp` w Claude Code i zaloguj się do TerraLab. Gotowe workflow GIS są dostępne jako 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 dodaje serwer i otwiera w przeglądarce logowanie TerraLab. Potem działa w CLI, w rozszerzeniu IDE i w aplikacji. Ten sam wpis w `~/.codex/config.toml`:

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

## Cursor

Otwórz link instalacyjny: [dodaj TerraLab do Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D). Cursor pokaże serwer: kliknij **Install** i zaloguj się, gdy o to poprosi.

Albo dodaj zdalny serwer w ustawieniach MCP w Cursor, w `.cursor/mcp.json`:

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

## VS Code

Otwórz link instalacyjny: [dodaj TerraLab do 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). Kliknij **Install**, zaloguj się do TerraLab, a potem zapytaj Copilota w trybie agenta.

Albo w `.vscode/mcp.json`:

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

## Inni agenci

Dodaj zdalny serwer MCP z powyższym adresem URL w dowolnym agencie, który to umożliwia; otworzy się logowanie TerraLab. Gemini CLI:

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

## Narzędzia

Serwer udostępnia 29 narzędzi. Każde z nich jest opisane z parametrami i przykładem zapytania w [dokumentacji API](https://terra-lab.ai/docs/api): narzędzie MCP i endpoint REST mają tę samą nazwę i te same argumenty.

- **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 co zapytać

- "Find the coordinates of these 40 addresses and give me a CSV for QGIS."
- "Extract the buildings and roads within 1 km of Annecy station as a GeoPackage."
- "Elevation profile from Chamonix to the Aiguille du Midi."
- "Which natural risks apply at 12 rue de la Paix, Annecy?"

Odpowiedzi pokazują mapę w czacie, jeśli agent to obsługuje, i dają pliki, które otwierają się w QGIS, ArcGIS lub Google Earth.

## Rozwiązywanie problemów

- **TerraLab jest w Claude oznaczony jako połączony, ale nie ma narzędzi.** Jeśli dodano go przed 26 października 2026, usuń konektor i dodaj go ponownie: Claude zaproponuje wtedy logowanie TerraLab.
- **Agent mówi, że darmowe wywołania się skończyły.** Doładuj saldo w [Panelu, MCP](https://terra-lab.ai/pl/dashboard/mcp) albo poczekaj do 1. dnia miesiąca. Zobacz [Cennik i darmowe wywołania](https://terra-lab.ai/pl/docs/pricing).
- **Narzędzie odpowiada błędem.** Jego `message` i `hint` mówią, co zmienić. Zobacz [Błędy i limity zapytań](https://terra-lab.ai/pl/docs/errors).

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