快速开始
连接智能体
TerraLab 是一个基于 Streamable HTTP 的远程 MCP 服务器。一个网址适用于所有智能体:
https://mcp.terra-lab.ai/mcp
第一次使用时,你的智能体会请你登录 TerraLab。你的免费调用次数和余额显示在 Dashboard, MCP。
Claude
打开预填好的对话框:把 TerraLab 添加到 Claude。点击 Add,再点击 Connect,然后登录 TerraLab。
或者在 Claude 中打开 Settings,选择 Connectors,再选择 Add custom connector,粘贴服务器网址。
ChatGPT
打开 ChatGPT 中的 TerraLab 应用,点击 Add,然后在消息开头输入 @TerraLab。
Claude Code
在终端中运行:
claude mcp add --transport http terralab https://mcp.terra-lab.ai/mcp
然后在 Claude Code 中运行 /mcp 并登录 TerraLab。现成的 GIS 工作流以 plugin 的形式提供:
/plugin marketplace add TerraLabAI/mcp
/plugin install terralab@terralab-ai-apps
Codex
codex mcp add terralab --url https://mcp.terra-lab.ai/mcp
Codex 会添加服务器,并在浏览器中打开 TerraLab 登录页。之后它可以在命令行、IDE 扩展和应用中使用。~/.codex/config.toml 中的对应条目如下:
[mcp_servers.terralab]
url = "https://mcp.terra-lab.ai/mcp"
Cursor
打开安装链接:把 TerraLab 添加到 Cursor。Cursor 会显示该服务器:点击 Install,在提示时登录。
或者在 Cursor 的 MCP 设置中,于 .cursor/mcp.json 里添加一个远程服务器:
{
"mcpServers": {
"terralab": { "url": "https://mcp.terra-lab.ai/mcp" }
}
}
VS Code
打开安装链接:把 TerraLab 添加到 VS Code。点击 Install,登录 TerraLab,然后在 agent 模式下向 Copilot 提问。
或者在 .vscode/mcp.json 中添加:
{
"servers": {
"terralab": { "type": "http", "url": "https://mcp.terra-lab.ai/mcp" }
}
}
其他智能体
在任何支持远程 MCP 服务器的智能体中,用上面的网址添加即可;它会打开 TerraLab 登录页。Gemini CLI 的命令如下:
gemini mcp add --transport http -s user terralab https://mcp.terra-lab.ai/mcp
工具
服务器提供 29 个工具。每个工具的参数和请求示例都记录在 API 参考中:MCP 工具和 REST endpoint 使用相同的名称和参数。
- Places: Find places and addresses, Convert coordinates, Measure distance, area, radius or buffer
- Map data: Extract open map data for an area, Open, map and convert GIS data, Buffer, merge, clip or simplify features
- Terrain and routes: Elevation, profile and contour lines, Road route between places, Area reachable in a travel time
- Imagery and land: Satellite image of an area, Forest type (natural, planted, plantation), Estimate the population of an area
- France: French cadastral parcel and zoning, French building heights, Natural risks at an address or a point
- Data catalog: Find a dataset in the TerraLab catalogue, Extract a hosted dataset for an area, Ask TerraLab to add data it does not have
可以问什么
- “找出这 40 个地址的坐标,并给我一个可用于 QGIS 的 CSV。”
- “把安纳西火车站周围 1 km 内的建筑和道路提取为 GeoPackage。”
- “从霞慕尼到南针峰的高程剖面。”
- “安纳西 rue de la Paix 12 号有哪些自然风险?”
如果智能体支持,答案会在聊天中显示地图,并提供可在 QGIS、ArcGIS 或 Google Earth 中打开的文件。
故障排查
- TerraLab 在 Claude 中显示已连接,但没有工具。 如果你是在 2026 年 10 月 26 日之前添加的,请删除该 connector 并重新添加:Claude 随后会提供 TerraLab 登录。
- 智能体说免费调用已用完。 在 Dashboard, MCP 充值,或等到下个月 1 日。参见定价与免费调用。
- 工具返回错误。 其中的
message和hint会说明该改什么。参见错误与速率限制。
更新于 2026-10-27