はじめに

クイックスタート

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

コードから API を呼び出す

API キーを作成する

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

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

export TERRALAB_API_KEY="tlk_your_key_here"

キーを確認する

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

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

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

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

find_places で、住所の座標を調べます。

cURLPythonJavaScript

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"}'

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"])

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 で、エリアの建物と道路を抽出します。
get_elevation で、標高、断面、等高線を取得します。
29 個のすべてのツールは、API リファレンスで確認できます。

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

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

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

その後、Claude Code で /mcp を実行して、TerraLab にサインインします。Claude、ChatGPT、Cursor、Codex、VS Code については、MCP サーバーをご覧ください。

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

2026-10-27 更新