AI 어시스턴트를 MCP ROOTE에 연결하려면 MCP Streamable HTTP를 지원하는 애플리케이션에 원격 서버 https://mcp.roote.ai/mcp를 추가하세요. 이 서버는 주소, 모빌리티, 근처 서비스 조회를 위한 도구를 제공합니다.
이 튜토리얼은 ROOTE가 발표한 설정과 서버 연결 확인 절차를 따릅니다. 메뉴 명칭은 클라이언트에 따라 다를 수 있으며, URL, 전송 방식 및 도구 구조를 확인해야 합니다. tools/list 서버 목록은 문서보다 먼저 변경될 수 있으니 실제 공지된 기능을 사용하세요.
클라이언트 호환성 확인
사용하는 애플리케이션이 Streamable HTTP 원격 MCP 서버를 허용해야 합니다. 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 문서는 initialize, tools/list, tools/call 순서를 설명하며, 호환 클라이언트는 이를 자동 처리합니다. 서버가 발표한 버전과 기능을 활용하세요.
서버는 geocode, place_search, reverse_geocode, nearby, mobility_nearby, transit_nearby, transit_disruptions, services_nearby 도구를 제공합니다. 이 도구들이 없으면 연결 문제, 탐색 오류 또는 서비스 변경 가능성이 있습니다. 항상 서버가 공지하는 목록을 확인하세요. Journey와 Departures는 아직 제공되지 않습니다.
첫 검색 시도하기
명확한 주소로 시작하세요: “ROOTE를 이용해 프랑스 파리 리볼리 거리 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(다음 출발)와 경로 계산 기능을 계획하고 있습니다. 이 기능들은 아직 제공되지 않으며, 현재 MCP 서버가 제공하는 도구에는 포함되어 있지 않습니다. 기능이 출시되면, 서버에서 공지하는 도구, 인자 및 실제 반환 정보를 확인하여 통과 시점이나 경로를 안내해야 합니다.
자주 묻는 질문
토큰이 반드시 필요한가요?
문서에는 익명 Free 접근도 명시되어 있습니다. 사용자의 접근 권한과 제한은 서비스 정책을 따릅니다.
어시스턴트가 정류장 검색 후 시간을 알려주는 이유는?
transit_nearby 검색은 다음 출발 시간을 제공하지 않습니다. 어시스턴트에 실제 반환된 데이터를 언급하고 부재 사실을 알리도록 요청하세요.
애플리케이션 생성 없이 시험해 볼 수 있나요?
네, 원격 서버를 추가하고 도구를 실행할 수 있는 호환 클라이언트가 있다면 가능합니다.