# クイックスタート

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

方法は 2 つあります。コードから REST API を呼び出す方法と、AI エージェントに MCP サーバーを追加する方法です。どちらも同じアカウントと、毎月 100 回の同じ無料の呼び出しを使います。

## コードから API を呼び出す

### API キーを作成する

1. [terra-lab.ai/login](https://terra-lab.ai/ja/login) でサインインします。アカウントは無料で、カードは不要です。
2. [ダッシュボード、MCP](https://terra-lab.ai/ja/dashboard/mcp) を開き、**Advanced**、**API keys** の順に進みます。
3. キーに名前を付け、API 利用規約に同意して、**Create key** をクリックします。
4. 今すぐキーをコピーしてください。`tlk_` で始まり、表示は 1 回だけです。

キーはコードに書かず、環境変数に入れて使います。

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

### キーを確認する

`GET /v1/me` は、アカウント情報と、今月の残りの呼び出し回数を返します。

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

`401` は、キーがない、入力が間違っている、または無効化されていることを意味します。

### 最初のツール呼び出しを行う

`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);
```

回答は JSON オブジェクトです。`structuredContent` には `sources` 付きの結果、`content` には同じ結果のテキスト、`isError` にはツールがリクエストを拒否したかどうかが入ります。

### さらに進む

- [extract_open_data](https://terra-lab.ai/docs/api/extract_open_data) で、エリアの建物と道路を抽出します。
- [get_elevation](https://terra-lab.ai/docs/api/get_elevation) で、標高、断面、等高線を取得します。
- 29 個のすべてのツールは、[API リファレンス](https://terra-lab.ai/docs/api)で確認できます。

## AI エージェントに TerraLab を追加する

Claude Code なら、コマンド 1 つで追加できます。

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

その後、Claude Code で `/mcp` を実行して、TerraLab にサインインします。Claude、ChatGPT、Cursor、Codex、VS Code については、[MCP サーバー](https://terra-lab.ai/ja/docs/mcp)をご覧ください。

たとえば、次のように頼んでみてください。「リヨン・パールデュー駅から 500 m 以内の建物を表示して、GeoPackage を作ってください。」

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