# エージェントを接続する

> 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 は、Streamable HTTP のリモート MCP サーバーです。どのエージェントでも、1 つの URL で使えます。

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

初回は、エージェントが TerraLab へのサインインを求めます。無料の呼び出しの残りと残高は、[ダッシュボード、MCP](https://terra-lab.ai/ja/dashboard/mcp) で確認できます。

## Claude

入力済みのダイアログを開きます：[TerraLab を Claude に追加](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TerraLab&connectorUrl=https%3A%2F%2Fmcp.terra-lab.ai%2Fmcp)。**Add**、**Connect** の順にクリックして、TerraLab にサインインします。

または、Claude で **Settings**、**Connectors**、**Add custom connector** の順に開き、サーバーの URL を貼り付けます。

## ChatGPT

[ChatGPT の TerraLab アプリ](https://chatgpt.com/apps/terralab/asdk_app_6abeb2f16190819199cc1be0ed69e8d4)を開いて **Add** をクリックし、メッセージを `@TerraLab` から始めます。

## Claude Code

ターミナルで次を実行します。

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

その後、Claude Code で `/mcp` を実行して、TerraLab にサインインします。すぐに使える GIS ワークフローは 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 がサーバーを追加し、ブラウザーで TerraLab のサインイン画面を開きます。その後は CLI、IDE 拡張機能、アプリで使えます。`~/.codex/config.toml` の同じエントリーは次のとおりです。

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

## Cursor

インストールリンクを開きます：[TerraLab を Cursor に追加](cursor://anysphere.cursor-deeplink/mcp/install?name=terralab&config=eyJ1cmwiOiJodHRwczovL21jcC50ZXJyYS1sYWIuYWkvbWNwIn0%3D)。Cursor にサーバーが表示されるので、**Install** をクリックし、求められたらサインインします。

または、Cursor の MCP 設定でリモートサーバーを追加します。`.cursor/mcp.json` には次のように書きます。

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

## VS Code

インストールリンクを開きます：[TerraLab を 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)。**Install** をクリックして TerraLab にサインインし、エージェントモードの Copilot に質問します。

または、`.vscode/mcp.json` に次のように書きます。

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

## その他のエージェント

リモート MCP サーバーの URL を指定できるエージェントなら、上の URL を追加するだけで、TerraLab のサインイン画面が開きます。Gemini CLI の場合は次のとおりです。

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

## ツール

サーバーは 29 個のツールを提供しています。各ツールのパラメーターとリクエスト例は、[API リファレンス](https://terra-lab.ai/docs/api)に載っています。MCP のツールと REST の endpoint は、同じ名前と同じ引数を共有します。

- **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)

## 質問の例

- 「この 40 件の住所の座標を調べて、QGIS 用の CSV にしてください。」
- 「アヌシー駅から 1 km 以内の建物と道路を、GeoPackage として抽出してください。」
- 「シャモニーからエギーユ・デュ・ミディまでの標高断面を出してください。」
- 「アヌシーのリュ・ド・ラ・ペ 12 番地には、どの自然リスクがありますか。」

エージェントが対応していれば、回答にはチャット内の地図が表示され、QGIS、ArcGIS、Google Earth で開けるファイルも提供されます。

## トラブルシューティング

- **Claude では TerraLab が接続済みと表示されるのに、ツールがない。** 2026 年 10 月 26 日より前に追加した場合は、コネクターを削除してから追加し直してください。そうすると Claude が TerraLab のサインインを案内します。
- **エージェントが、無料の呼び出しを使い切ったと言う。** [ダッシュボード、MCP](https://terra-lab.ai/ja/dashboard/mcp) でチャージするか、翌月 1 日まで待ってください。[料金と無料の呼び出し](https://terra-lab.ai/ja/docs/pricing)をご覧ください。
- **ツールがエラーを返す。** `message` と `hint` に、何を変更すればよいかが書かれています。[エラーとレート制限](https://terra-lab.ai/ja/docs/errors)をご覧ください。

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