要将人工智能助手连接到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" }
}
}选择匿名访问或认证访问
文档支持无Authorization头的匿名访问，受Free投影和API当前限制约束。认证访问时，通过客户端安全机制，在Bearer头传递令牌。
Authorization: Bearer YOUR_API_TOKENYOUR_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有效性及头部配置 |
| 达到限制 | 当前限制，恢复时间及调用频率 |
| 空或部分结果 | 坐标、过滤器、半径、覆盖和警告信息 |
未来功能：下一班车及路线规划
ROOTE 计划将其 MCP 扩展到近期出发（Departures）和路径规划（Journey）功能。这些功能尚未上线，目前不在 MCP 服务器公开的工具列表中。功能上线后，请务必核实服务器公布的工具、参数及实际返回的数据，然后再公布经过时间或路径。
常见问题
是否必须有令牌？
文档支持匿名Free访问。您的访问限制和功能仍由服务端执行。
为何助手在公交停点搜索后显示时间？
transit_nearby搜索不返回下一班车。请让助手说明返回的实际数据并指出缺失。
能否不创建应用就测试？
可以，使用允许添加远程服务器并执行工具的兼容客户端即可。