# Início rápido

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

Dois caminhos: chamar a REST API pelo código, ou adicionar o servidor MCP a um agente de IA. Os dois usam a mesma conta e as mesmas 100 chamadas gratuitas por mês.

## Chamar a API pelo código

### Criar uma chave de API

1. Entre em [terra-lab.ai/login](https://terra-lab.ai/pt-BR/login). A conta é gratuita e não pede cartão.
2. Abra [Dashboard, MCP](https://terra-lab.ai/pt-BR/dashboard/mcp), depois **Advanced**, **API keys**.
3. Dê um nome à chave, aceite os termos da API e clique em **Create key**.
4. Copie a chave agora: ela começa com `tlk_` e é mostrada uma única vez.

Guarde-a em uma variável de ambiente, nunca no seu código:

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

### Verificar a chave

`GET /v1/me` retorna sua conta e as chamadas que ainda restam neste mês.

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

Um `401` significa que a chave está ausente, digitada errado ou revogada.

### Fazer sua primeira chamada de ferramenta

Encontre as coordenadas de um endereço com `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);
```

A resposta é um objeto JSON: `structuredContent` traz o resultado com suas `sources`, `content` o mesmo resultado em texto, e `isError` indica se a ferramenta recusou a requisição.

### Ir além

- Extraia edifícios e vias de uma área com [extract_open_data](https://terra-lab.ai/docs/api/extract_open_data).
- Obtenha a elevação, um perfil ou curvas de nível com [get_elevation](https://terra-lab.ai/docs/api/get_elevation).
- Veja as 29 ferramentas na [referência da API](https://terra-lab.ai/docs/api).

## Adicionar a TerraLab a um agente de IA

No Claude Code, um único comando:

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

Depois execute `/mcp` no Claude Code e entre na TerraLab. Para Claude, ChatGPT, Cursor, Codex e VS Code, veja [Servidor MCP](https://terra-lab.ai/pt-BR/docs/mcp).

Peça, por exemplo: "Mostre os edifícios em 500 m da estação Lyon Part-Dieu e me dê um GeoPackage."

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