# Guía rápida

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

Dos caminos: llamar a la API REST desde código, o añadir el servidor MCP a un agente de IA. Ambos usan la misma cuenta y las mismas 100 llamadas gratuitas al mes.

## Llamar a la API desde código

### Crear una clave de API

1. Inicia sesión en [terra-lab.ai/login](https://terra-lab.ai/es/login). Una cuenta es gratuita y no requiere tarjeta.
2. Abre [Dashboard, MCP](https://terra-lab.ai/es/dashboard/mcp), luego **Advanced**, **API keys**.
3. Ponle un nombre a la clave, acepta los términos de la API y haz clic en **Create key**.
4. Copia la clave ahora: empieza por `tlk_` y solo se muestra una vez.

Guárdala en una variable de entorno, nunca en tu código:

```bash
export TERRALAB_API_KEY="tlk_your_key_here"
```

### Comprobar la clave

`GET /v1/me` devuelve tu cuenta y las llamadas que te quedan este mes.

```bash
curl https://mcp.terra-lab.ai/v1/me \
  -H "Authorization: Bearer $TERRALAB_API_KEY"
```

Un `401` significa que la clave falta, está mal escrita o ha sido revocada.

### Hacer tu primera llamada a una herramienta

Busca las coordenadas de una dirección con `find_places`:

```bash
curl -X POST https://mcp.terra-lab.ai/v1/tools/find_places \
  -H "Authorization: Bearer $TERRALAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"12 rue de la Paix, Annecy"}'
```

```python
import os
import requests

response = requests.post(
    "https://mcp.terra-lab.ai/v1/tools/find_places",
    headers={"Authorization": f"Bearer {os.environ['TERRALAB_API_KEY']}"},
    json={"query": "12 rue de la Paix, Annecy"},
    timeout=120,
)
response.raise_for_status()
print(response.json()["structuredContent"])
```

```javascript
const response = await fetch('https://mcp.terra-lab.ai/v1/tools/find_places', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TERRALAB_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ query: '12 rue de la Paix, Annecy' }),
});
const data = await response.json();
console.log(data.structuredContent);
```

La respuesta es un objeto JSON: `structuredContent` contiene el resultado con sus `sources`, `content` el mismo resultado como texto, e `isError` indica si la herramienta rechazó la solicitud.

### Ir más lejos

- Extrae edificios y carreteras de un área con [extract_open_data](https://terra-lab.ai/docs/api/extract_open_data).
- Obtén la elevación, un perfil o curvas de nivel con [get_elevation](https://terra-lab.ai/docs/api/get_elevation).
- Explora las 29 herramientas en la [referencia de la API](https://terra-lab.ai/docs/api).

## Añadir TerraLab a un agente de IA

En Claude Code, un solo comando:

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

Después ejecuta `/mcp` en Claude Code e inicia sesión en TerraLab. Para Claude, ChatGPT, Cursor, Codex y VS Code, consulta [Servidor MCP](https://terra-lab.ai/es/docs/mcp).

Pregunta, por ejemplo: "Muestra los edificios a menos de 500 m de la estación de Lyon Part-Dieu y dame un GeoPackage."

Source: https://terra-lab.ai/es/docs/quickstart · Updated 2026-10-27