# MCP ROOTE에 AI 어시스턴트를 연결하는 방법

> MCP ROOTE에 어시스턴트를 연결하는 방법: 서버 URL, HTTP 구성, 첫 검색, 결과 확인 및 오류 해결까지 안내합니다.

Source: https://www.roote.ai/ko/guides/mcp-roote-ia-%EC%96%B4%EC%8B%9C%EC%8A%A4%ED%84%B4%ED%8A%B8-%EC%97%B0%EA%B2%B0%EB%B0%A9%EB%B2%95/
Language: ko
Author: ROOTE

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" }
  }
}
```

[ROOTE 공식 연결 구성](https://doc.roote.ai/roote-mcp/connect-roote-mcp)

## 익명 접근 또는 인증 접근 선택하기

문서에는 Authorization 헤더 없는 익명 접근 방식을 제공하며, 이는 Free 프로젝션과 API 적용 제한에 따릅니다. 인증 접근이 필요하면 클라이언트의 보안 메커니즘을 활용해 Bearer 헤더로 토큰을 전송하세요.

```
Authorization: Bearer YOUR_API_TOKEN
```

YOUR_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 유효성 및 헤더 구성 |
| 제한 초과 | 활성 제한, 재시도 대기 시간, 호출 빈도 |
| 빈 결과 또는 부분 결과 | 좌표, 필터, 반경, 범위, 경고 |

[빈 결과와 API 오류 구별하기](https://www.roote.ai/ko/guides/%EA%B2%B0%EA%B3%BC%EC%97%86%EC%9D%8C-api%EC%98%A4%EB%A5%98-%EA%B5%AC%EB%B6%84%EB%B0%A9%EB%B2%95/)

[주소를 기반으로 한 완전한 어시스턴트 만들기](https://www.roote.ai/ko/guides/%EC%A3%BC%EC%86%8C-%EC%A3%BC%EB%B3%80-%EA%B5%90%ED%86%B5-%EB%AA%A8%EB%B9%8C%EB%A6%AC%ED%8B%B0-%EC%B0%BE%EA%B8%B0-%EB%8F%84%EC%9A%B0%EB%AF%B8-%EB%A7%8C%EB%93%9C%EB%8A%94-%EB%B2%95/)

[MCP 서버 역할 이해하기](https://www.roote.ai/ko/guides/mcp%EC%84%9C%EB%B2%84%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B4%EB%A9%B0-%EB%AC%B4%EC%97%87%EC%97%90-%EC%82%AC%EC%9A%A9%EB%90%98%EB%8A%94%EA%B0%80/)

## 예정: 다음 출발 및 여정 계산 기능

ROOTE는 MCP 확장으로 향후 Departures(다음 출발)와 경로 계산 기능을 계획하고 있습니다. 이 기능들은 아직 제공되지 않으며, 현재 MCP 서버가 제공하는 도구에는 포함되어 있지 않습니다. 기능이 출시되면, 서버에서 공지하는 도구, 인자 및 실제 반환 정보를 확인하여 통과 시점이나 경로를 안내해야 합니다.

## 자주 묻는 질문

### 토큰이 반드시 필요한가요?

문서에는 익명 Free 접근도 명시되어 있습니다. 사용자의 접근 권한과 제한은 서비스 정책을 따릅니다.

### 어시스턴트가 정류장 검색 후 시간을 알려주는 이유는?

transit_nearby 검색은 다음 출발 시간을 제공하지 않습니다. 어시스턴트에 실제 반환된 데이터를 언급하고 부재 사실을 알리도록 요청하세요.

### 애플리케이션 생성 없이 시험해 볼 수 있나요?

네, 원격 서버를 추가하고 도구를 실행할 수 있는 호환 클라이언트가 있다면 가능합니다.