Để kết nối trợ lý IA với MCP ROOTE, thêm máy chủ từ xa https://mcp.roote.ai/mcp vào ứng dụng tương thích với MCP Streamable HTTP. Máy chủ cung cấp các công cụ đọc địa chỉ, di chuyển và dịch vụ gần đó.
Hướng dẫn này dựa trên cấu hình do ROOTE công bố và kiểm tra kết nối đến máy chủ. Tên menu có thể thay đổi theo ứng dụng khách; URL, phương thức truyền và cấu trúc công cụ là những yếu tố cần kiểm tra. Danh sách tools/list của máy chủ có thể thay đổi trước tài liệu: hãy sử dụng các khả năng được công bố thực sự.
Kiểm tra khả năng tương thích của ứng dụng khách
Ứng dụng của bạn cần hỗ trợ máy chủ MCP từ xa qua Streamable HTTP. Ứng dụng chỉ giới hạn dùng máy chủ cục bộ stdio không thể dùng URL này như một lệnh thực thi. Cũng kiểm tra xem tài khoản của bạn có cho phép thêm máy chủ tùy chỉnh không.
Nếu ứng dụng có biểu mẫu, điền ROOTE làm tên và URL máy chủ làm địa chỉ. Nếu chấp nhận file theo định dạng mcpServers, tài liệu ROOTE đưa ra cấu hình tối thiểu sau:
{
"mcpServers": {
"roote": { "url": "https://mcp.roote.ai/mcp" }
}
}Cấu hình kết nối ROOTE chính thức
Chọn truy cập ẩn danh hoặc xác thực
Tài liệu đưa ra truy cập ẩn danh không dùng Authorization header, áp dụng chính sách Free và giới hạn API đang hoạt động. Để truy cập có xác thực, dùng cơ chế bảo mật của ứng dụng để truyền token trong header Bearer.
Authorization: Bearer YOUR_API_TOKENYOUR_API_TOKEN là vị trí bạn sẽ thay thế trong cấu hình bảo mật của ứng dụng. Không dán token vào hội thoại, URL công khai hoặc bài viết. Token không hợp lệ hoặc bị thu hồi sẽ không tự động chuyển sang truy cập ẩn danh.
Xác nhận các công cụ có sẵn
Sau khi kết nối, mở danh sách công cụ của máy chủ trong ứng dụng. Tài liệu ROOTE mô tả chuỗi initialize, tools/list rồi tools/call; ứng dụng tương thích thường tự thực hiện các bước này cho bạn. Dùng phiên bản và khả năng do máy chủ thông báo.
Máy chủ cung cấp geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions và services_nearby. Nếu các công cụ này không có, có thể là do vấn đề kết nối, khám phá hay dịch vụ đã thay đổi. Luôn kiểm tra danh sách được máy chủ công bố. Journey và Departures chưa được cấp.
Thực hiện tìm kiếm đầu tiên có thể tái tạo
Bắt đầu với địa chỉ rõ ràng: “Dùng ROOTE để tìm địa chỉ 10 rue de Rivoli, Paris, France. Liệt kê các kết quả tìm được cùng tọa độ.” Xem kỹ kết quả công cụ, không chỉ câu trả lời được tạo bởi mô hình.
{
"name": "geocode",
"arguments": {
"q": "10 rue de Rivoli, Paris",
"language": "fr",
"country": "FR"
}
}Khối này minh họa tên và đối số của một cuộc gọi; không phải yêu cầu HTTP đầy đủ. Ứng dụng bạn sẽ đóng gói cuộc gọi MCP. Nếu có nhiều kết quả hợp lý, chọn đúng kết quả trước khi tìm kiếm quanh điểm đó.
Sau đó bạn có thể thử giao tiếp quanh một điểm tham chiếu tại Bordeaux. Tọa độ dưới đây dùng để thử nghiệm và không tuyên bố xuất phát từ địa chỉ tại Paris trước đó.
{
"name": "transit_nearby",
"arguments": {
"lat": 44.8416106,
"lon": -0.5810938,
"radius": 600,
"modes": ["bus", "tram"],
"limit": 10
}
}Đọc kết quả trước khi kết luận
Kiểm tra trạng thái, các thực thể trả về, phạm vi, cảnh báo và giới hạn áp dụng. Kết quả một phần có thể chứa thông tin hữu ích. Kết quả trống không chứng minh không có phương tiện giao thông trong thành phố.
Kết quả mong đợi từ thử nghiệm là phản hồi có cấu trúc hoặc lỗi rõ ràng, không phải số lượng điểm dừng xác định sẵn. Nguồn và phạm vi có thể thay đổi. Tìm điểm dừng không trả về lịch trình khởi hành tiếp theo.
Khắc phục lỗi kết nối
| Triệu chứng | Kiểm tra hữu ích |
|---|---|
| Không phát hiện được công cụ | URL chính xác, giao thức từ xa và ủy quyền của ứng dụng |
| Lỗi đối số | Kiểu, giá trị được phép và các trường trong sơ đồ công cụ thông báo |
| Lỗi xác thực | Tính hợp lệ của Bearer và cấu hình header |
| Vượt giới hạn | Giới hạn đang hoạt động, thời gian chờ và tần suất gọi API |
| Kết quả trống hoặc một phần | Tọa độ, bộ lọc, bán kính, phạm vi và cảnh báo |
Phân biệt kết quả trống và lỗi API
Tạo trợ lý hoàn chỉnh từ một địa chỉ
Sắp tới: lịch khởi hành và tính toán lộ trình
ROOTE dự định mở rộng MCP sang chức năng khởi hành tiếp theo và tính tuyến đường. Những tính năng này sẽ được cập nhật trong tương lai và chưa thuộc các công cụ hiện tại được máy chủ MCP cung cấp. Khi các tính năng sẵn có, hãy kiểm tra các công cụ thông báo bởi máy chủ, các tham số và thông tin thực sự trả về trước khi thông báo chuyến đi hoặc hành trình.
Các câu hỏi thường gặp
Có bắt buộc phải có token không?
Tài liệu quy định truy cập ẩn danh Free. Giới hạn và khả năng truy cập bạn có vẫn do dịch vụ áp dụng.
Tại sao trợ lý của tôi báo lịch trình sau khi tìm điểm dừng?
Tìm kiếm transit_nearby không cung cấp lịch trình khởi hành kế tiếp. Hãy yêu cầu trợ lý nêu rõ dữ liệu thực tế nhận được và báo lỗi thiếu này.
Có thể thử mà không cần tạo ứng dụng không?
Có, với ứng dụng tương thích cho phép thêm máy chủ từ xa và sử dụng công cụ của nó.