# 如何将人工智能助手连接到MCP ROOTE？

> 将助手连接到MCP ROOTE：服务器URL，HTTP配置，首次搜索，结果读取及错误排查。

Source: https://www.roote.ai/zh/guides/comment-connecter-un-assistant-ia-au-mcp-roote/
Language: zh
Author: ROOTE

要将人工智能助手连接到MCP ROOTE，请在支持MCP Streamable HTTP的应用中添加远程服务器 https://mcp.roote.ai/mcp。该服务器提供地址、出行和附近服务的读取工具。

本教程遵循 ROOTE 发布的配置步骤，并包含服务器连接验证。菜单名称因客户端不同而异；需重点确认 URL、传输方式和工具结构。服务器的 tools/list 列表可能在文档更新前发生变化，请使用服务器实际公布的功能。

## 确认客户端兼容性

您的应用必须支持作为远程MCP服务器的Streamable HTTP。仅限本地stdio服务器的客户端无法将此URL当作可执行命令使用。还请确认账户允许添加自定义服务器。

若应用提供表单，请填写ROOTE作为名称，服务器URL作为地址。若支持mcpServers格式文件，ROOTE文档给出最小配置示例：

```
{
  "mcpServers": {
    "roote": { "url": "https://mcp.roote.ai/mcp" }
  }
}
```

[ROOTE官方连接配置](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## 选择匿名访问或认证访问

文档支持无Authorization头的匿名访问，受Free投影和API当前限制约束。认证访问时，通过客户端安全机制，在Bearer头传递令牌。

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_API_TOKEN为需替换的位置，填入客户端安全配置中。请勿在对话、公开URL或文章中贴出令牌。无效或被撤销令牌不会自动降级为匿名访问。

## 确认工具可用性

连接后，在客户端打开服务器工具列表。ROOTE文档描述初始化、tools/list及tools/call流程；兼容客户端通常自动完成。使用服务器公布的版本和功能。

服务器提供 geocode、place_search、reverse_geocode、nearby、mobility_nearby、transit_nearby、transit_disruptions 和 services_nearby 工具。若缺少这些工具，可能存在连接、发现或服务调整问题。务必查看服务器公布的工具列表。Journey 和 Departures 目前尚未公开。

## 进行首次可复现搜索

从明确地址开始："使用ROOTE搜索法国巴黎Rivoli街10号。列出候选结果及其坐标。"检查工具结果，而非模型生成的文字回答。

```
{
  "name": "geocode",
  "arguments": {
    "q": "10 rue de Rivoli, Paris",
    "language": "fr",
    "country": "FR"
  }
}
```

此块展示调用名称及参数，不是完整HTTP请求。您的客户端封装MCP调用。若返回多个合理候选，先选对再进行周边搜索。

然后可以测试波尔多参考点附近的交通。以下坐标用于测试，不代表前述巴黎地址。

```
{
  "name": "transit_nearby",
  "arguments": {
    "lat": 44.8416106,
    "lon": -0.5810938,
    "radius": 600,
    "modes": ["bus", "tram"],
    "limit": 10
  }
}
```

## 在结论前阅读结果

检查状态、返回实体、覆盖范围、警告及限制。部分响应可能含有效信息。空结果不代表城市无交通。

测试结果应是结构化响应或明确错误，而非固定公交停点数。数据来源和覆盖可变。公交搜寻不含下一班车信息。

## 解决连接错误

| 症状 | 有用检查点 |
| --- | --- |
| 无工具被发现 | 核对URL准确性、远程传输和客户端权限 |
| 参数错误 | 校验类型、允许值及声明的模式字段 |
| 认证错误 | Bearer有效性及头部配置 |
| 达到限制 | 当前限制，恢复时间及调用频率 |
| 空或部分结果 | 坐标、过滤器、半径、覆盖和警告信息 |

[区分空结果和API错误](https://www.roote.ai/zh/guides/api-no-result-vs-error-chinese/)

[从地址创建完整助手](https://www.roote.ai/zh/guides/create-mobility-assistant-around-address/)

[了解MCP服务器的作用](https://www.roote.ai/zh/guides/mcp-%E6%9C%8D%E5%8A%A1%E5%99%A8-%E6%98%AF%E4%BB%80%E4%B9%88%E5%8F%8A%E5%85%B6%E7%94%A8%E9%80%94/)

## 未来功能：下一班车及路线规划

ROOTE 计划将其 MCP 扩展到近期出发（Departures）和路径规划（Journey）功能。这些功能尚未上线，目前不在 MCP 服务器公开的工具列表中。功能上线后，请务必核实服务器公布的工具、参数及实际返回的数据，然后再公布经过时间或路径。

## 常见问题

### 是否必须有令牌？

文档支持匿名Free访问。您的访问限制和功能仍由服务端执行。

### 为何助手在公交停点搜索后显示时间？

transit_nearby搜索不返回下一班车。请让助手说明返回的实际数据并指出缺失。

### 能否不创建应用就测试？

可以，使用允许添加远程服务器并执行工具的兼容客户端即可。