Claude 또는 ChatGPT 연결하기

Claude 또는 ChatGPT를 연결해 저장된 여행, 경로, 즐겨찾는 장소를 읽을 수 있게 하세요. 그런 다음 어시스턴트에게 일별 지도가 포함된 여행 문서를 준비해 달라고 요청할 수 있습니다. 문서는 어시스턴트가 자체 문서 도구를 사용해 만들며, WaypointGuru는 저장된 데이터와 브랜드가 표시된 지도 이미지를 제공합니다.

시작하기 전에

WaypointGuru 계정, 저장된 데이터, 그리고 사용자 지정 원격 MCP 연결을 허용하는 어시스턴트 계정이 필요합니다. 관리되는 워크스페이스에서는 관리자가 연결을 활성화하거나 추가해야 할 수 있습니다. 문서를 만들려면 해당 어시스턴트에 적절한 문서 및 이미지 도구도 필요합니다.

다음 MCP 서버 URL을 사용하세요:

https://waypoint.guru/mcp

인증 방식으로 OAuth와 자동 등록(또는 동적 클라이언트 등록이나 DCR라고도 함)을 선택하세요. WaypointGuru에는 API 키, personal access token, client secret 또는 사용자 지정 authorization header가 필요하지 않습니다. Client ID Metadata Documents (CIMD) 대신 자동 등록을 사용하세요.

웹에서 Claude 설정하기

Customize > Connectors를 연 다음 + Add > Add custom connector를 선택하세요. 관리형 워크스페이스의 경우 먼저 소유자가 Organization settings > Connectors에서 웹 커넥터를 추가해야 할 수 있습니다.
이름을 WaypointGuru로 지정하고 MCP 서버 URL로 https://waypoint.guru/mcp를 입력하세요.
인증 설정을 계속 진행하세요. OAuth 클라이언트에는 Sign in now와 Register automatically를 선택하세요. Claude의 공개 ID 대신 자동 등록을 사용하세요.
커넥터 추가를 마친 뒤 필요하면 Connect를 선택하세요. 아래의 WaypointGuru 로그인 및 권한 단계까지 완료하세요.
대화에서 + > Connectors를 열고 WaypointGuru를 활성화하세요.

메뉴 이름과 사용 가능 조건은 바뀔 수 있습니다. 계정에 다른 레이아웃이 표시되면 Claude의 사용자 지정 커넥터 안내를 참고하세요.

웹에서 ChatGPT 설정하기

ChatGPT는 현재 두 가지 설정 레이아웃을 안내합니다. 계정에서 사용할 수 있는 방식을 사용하세요.

Plugins 레이아웃의 경우:

Plugins를 열고 + > Add custom MCP server를 선택한 다음 이름을 WaypointGuru로 지정하세요.
Connection 아래에 https://waypoint.guru/mcp를 입력하세요. OAuth를 선택하고 DCR을 설정한 뒤 정적 클라이언트 자격 증명은 비워 두세요.
경고를 검토하고 Create as a plugin을 선택한 다음 생성된 플러그인을 설치하세요. 안내가 표시되면 WaypointGuru 로그인과 동의를 완료하세요.
채팅에서 **@**를 입력하고, 데이터 읽기를 요청할 때 WaypointGuru를 선택하세요.

OpenAI의 사용자 지정 MCP 서버 안내를 참고하세요.

Apps / developer mode 레이아웃의 경우, 허용되어 있다면 Settings > Apps > Advanced settings > Developer mode를 활성화하세요. 같은 URL과 OAuth/DCR 설정으로 앱을 만들고, 도구를 스캔하고, 로그인을 완료한 뒤 생성을 마치세요. 데이터 요청 시 채팅에서 해당 앱을 선택하고, 필요하면 후속 요청에서도 다시 선택하세요. 워크스페이스 관리자가 이 설정에 대한 접근을 제어합니다. OpenAI의 developer mode 안내를 참고하세요.

권한 선택하기

어시스턴트가 연 브라우저 창에서 WaypointGuru에 로그인하세요. 승인하기 전에 표시된 계정과 어시스턴트를 확인하세요. 모바일 앱에 이미 로그인되어 있더라도 다시 로그인해야 할 수 있습니다.

동의 화면에서는 다음 읽기 범주를 제공합니다:

범주	어시스턴트가 읽을 수 있는 내용
여행	저장된 여행 세부정보와 그 안에 포함된 일별 경로(지도에 필요한 일별 데이터 포함). 관련 없는 독립 저장 경로나 전체 즐겨찾기 모음에 대한 접근 권한은 부여하지 않습니다.
경로	계정에서 사용할 수 있는 저장된 경로(이름으로 찾기, 전체 경로 데이터, 지도 포함).
즐겨찾기	태그 검색, 주변 검색, 전체 세부정보를 포함한 즐겨찾는 장소.

여행 문서를 만들 때는 여행만으로 시작하세요. 어시스턴트가 다른 범주도 사용하길 원할 때만 추가하세요. 원하지 않는 범주의 선택을 해제하고 **선택 항목 승인**를 선택하거나, 요청된 모든 범주를 승인하세요. 취소하려면 **취소**를 선택하세요.

권한은 승인된 각 범주 전체에 적용되며, 나중에 저장한 항목과 계정이 일반적으로 접근할 수 있는 공유 항목도 포함됩니다. 하나의 여행이나 하나의 대화에만 제한되지 않습니다. 기존 공유, 개인정보 보호, 구독 제한은 그대로 적용됩니다. 링크를 제공해도 이를 우회할 수는 없습니다.

접근은 읽기 전용입니다. 어시스턴트는 WaypointGuru 데이터를 수정, 삭제 또는 게시할 수 없습니다. 하지만 읽기 접근으로 인해 데이터는 어시스턴트 제공업체로 전송되며, 해당 업체의 저장 및 개인정보 보호 설정이 적용됩니다. 연결이 유효한 동안 접근 권한은 자동으로 갱신되므로 일반적인 사용에서는 반복 승인할 필요가 없습니다. 다만 장기간 사용하지 않으면 다시 연결해야 할 수 있습니다.

여행 문서 요청하기

대화에서 WaypointGuru를 활성화한 상태로 다음과 같이 요청해 보세요:

WaypointGuru를 사용해 “Coastal holiday”라는 내 저장된 여행을 찾아줘. 여행 세부정보와 각 날짜별 섹션이 있는 문서를 만들어줘. 가능한 각 날짜에는 WaypointGuru 지도를 포함하고, 저장된 경유지 세부정보를 바탕으로 정차 지점 범례를 작성해줘. 휴식일과 사용할 수 없는 경로를 표시해줘. 저장된 통계와 재계산된 통계는 분리해서 보여주고, 데이터를 가져오지 못했거나 이미지를 불러오지 못한 경우 알려줘.

계정이 접근할 수 있는 전체 저장 여행 링크 또는 저장 경로 링크를 제공할 수도 있습니다. 내보낸 경로가 포함된 단축 링크와 저장되지 않은 경로는 지원되지 않습니다.

문서가 완성되었다고 하기 전에 모든 페이지와 스냅샷 청크를 끝까지 가져오라고 어시스턴트에게 요청하세요. 여행과 경로는 저장된 데이터에서 최대 24시간 유지되는 스냅샷으로 캡처됩니다. 이후의 수정은 이 캡처에 반영되지 않으며, 저장되지 않은 수정은 제외됩니다. 새로 저장한 변경 사항을 포함하거나 만료된 캡처를 복구하려면 새 스냅샷과 새 지도를 요청하세요.

지도는 기본적으로 WebP, 전체 크기, 표준 스타일, 날짜별 색상으로 제공됩니다. JPEG와 PNG도 지원하며, 미리보기 크기, 위성 스타일, 야간 색상도 사용할 수 있습니다. 문서 도구가 WebP를 삽입할 수 없다면 PNG를 요청하세요. WaypointGuru 브랜딩과 지도 제공업체 표시는 계속 보이도록 유지해야 합니다. 주변 설명 텍스트와 정차 지점 범례는 어시스턴트가 작성합니다.

WaypointGuru는 캡처된 경로와 여행 일차의 주행 거리와 소요 시간을 자동으로 계산하며, 저장된 추정치가 없는 가져온 경로도 포함됩니다. 가능한 경우 Google과 일치하는 추정치를 사용하고, Valhalla 추정치는 대체값으로 표시됩니다. 주행 시간에는 정차 시간은 포함되지 않습니다. 저장된 추정치는 별도로 유지됩니다. 경로 및 일차 세부정보에는 단순화된 경로 윤곽과, 라우팅에서 제공되는 경우 주요 도로명이 포함됩니다. 특정 구간을 확인해야 할 때 어시스턴트는 특정 구간이나 거리 범위에 대한 상세 지오메트리를 요청할 수 있습니다.

지도는 일반적으로 MCP 이미지와 보호된 리소스 참조로 전달됩니다. 이미지 URL이 필요한 문서 도구의 경우 어시스턴트에게 delivery: "url"을 요청하게 하세요. Google Docs의 경우 format: "png" 또는 "jpeg"도 함께 요청하세요. 형식을 지정하지 않으면 기본값은 WebP입니다.

다운로드 링크는 15분 동안 작동하며, 저장된 스냅샷이 더 빨리 만료되면 그 시점까지만 유효합니다. 링크를 가진 사람은 어시스턴트의 연결과 사용자의 접근 권한이 유효한 동안 해당 이미지를 가져올 수 있습니다. 링크는 비공개로 취급하세요. 어시스턴트 연결을 해제하거나 리소스 접근 권한을 잃으면 이후 다운로드는 차단되지만, 이미 문서에 삽입된 사본은 제거할 수 없습니다. 삽입 전에 링크가 만료되면 어시스턴트에게 새 링크를 요청하세요. 그래도 삽입에 실패하면 성공했다고 하지 말고 누락된 지도를 보고하도록 요청하세요.

연결 해제 또는 접근 변경하기

WaypointGuru 웹 앱에서 **WaypointGuru 설정 > 사용자 계정 > 연결된 앱**를 여세요.
어시스턴트 이름, 승인된 범주, 마지막 사용 정보를 검토하세요.
하나의 연결만 해제하려면 **연결 해제**를 선택하고, 해당 계정의 모든 어시스턴트 연결을 취소하려면 **모두 연결 해제**을 선택하세요.

브라우저 핸드오프를 지원하는 모바일 버전에서는 계정 메뉴의 **연결된 앱**가 브라우저에서 이 설정을 엽니다. 요청되면 সেখানে 로그인하세요.

연결을 해제하면 아직 만료되지 않은 자격 증명을 사용하는 요청을 포함해 이후 데이터 읽기, 지도 가져오기, 자동 갱신이 중단됩니다. 하지만 어시스턴트가 이미 다운로드한 텍스트, 이미지, 문서는 회수할 수 없습니다. 해당 콘텐츠는 제공업체에서 별도로 관리하세요.

승인된 범주를 변경하려면 기존 연결을 해제하고 새 동의로 다시 연결하세요. Claude 또는 ChatGPT에서 커넥터, 앱 또는 플러그인을 제거할 수도 있습니다. 한 대화에서만 꺼 두는 것은 WaypointGuru 권한을 취소하지 않으므로, 접근을 취소하려면 WaypointGuru의 연결 해제 제어를 사용하세요.

문제 해결

문제	시도할 방법
연결 추가 옵션이 없음	위의 제공업체 안내를 따라 계정 사용 가능 여부와 워크스페이스 관리자 권한을 확인하세요.
연결 설정 또는 등록 실패	서버 URL이 `https://waypoint.guru/mcp`인지 확인하세요. OAuth와 자동 등록/DCR을 선택하세요. CIMD나 Claude의 공개 ID는 선택하지 마세요.
로그인은 끝났지만 동의 화면이 나타나지 않음	대기 중인 연결 창으로 돌아가세요. 일시적 오류라면 다시 시도 제어를 사용하세요. 요청이 만료되었거나 취소되었다면 어시스턴트에서 새 연결을 시작하세요.
잘못된 계정이 표시됨	동의를 취소하세요. 해당 브라우저에서 올바른 WaypointGuru 계정으로 로그인한 뒤 다시 시작하세요.
도구가 없거나 권한이 거부됨	연결된 앱의 범주와 어시스턴트에서 활성화된 도구를 확인하세요. 필요하면 필요한 범주로 다시 연결하세요. 여행만 선택하면 관련 없는 경로와 전체 즐겨찾기 접근은 의도적으로 제외됩니다.
여행, 경로 또는 공유 링크를 사용할 수 없음	먼저 변경 사항을 저장하고, 같은 계정으로 WaypointGuru에서 해당 항목을 열 수 있는지 확인하세요. 공유 및 구독 접근도 확인하세요. 비공개, 삭제됨, 접근 불가 항목은 모두 사용할 수 없는 것으로 보일 수 있습니다.
결과가 불완전해 보임	어시스턴트에게 페이지네이션을 계속하고 모든 스냅샷 청크를 읽으라고 요청하세요. 빈 검색 페이지가 보여도 추가 페이지가 있을 수 있습니다.
스냅샷이 만료됨	새 캡처를 요청하세요. 이전 캡처는 24시간 후 만료되며 접근 권한이 취소되면 사용할 수 없게 됩니다.
지도가 대기 중이거나 일시적으로 실패함	반환된 재시도 대기 시간을 따르고 같은 캡처를 재사용하세요. 새 캡처를 반복해서 시작하지 마세요.
지도가 할당량 또는 크기 제한에 걸림	안내된 할당량 재시도 시간까지 기다리세요. 다시 연결해도 할당량은 초기화되지 않습니다. 크기 제한 결과는 같은 캡처를 반복 재시도해도 해결되지 않으므로, 이를 보고하거나 더 작은 저장 경로를 사용하세요.
지도를 삽입할 수 없음	URL이 필요한 문서 도구의 경우 `delivery: "url"`을 요청하세요. Google Docs의 경우 PNG 또는 JPEG를 선택하세요. 15분 유효 시간이 지났다면 새 링크를 요청하세요. 다운로드 링크는 비공개로 취급하고, 삽입이 계속 실패하면 누락된 지도를 보고하세요.
어시스턴트가 계속 로그인을 요구함	연결된 앱을 확인한 뒤 다시 연결하세요. 연결 해제 후 또는 장기간 비활성 상태 후에는 갱신이 실패할 수 있습니다. 활성 연결 중 반복적으로 표시되는 요청은 신고해야 합니다.

도움이 필요하면 날짜, 어시스턴트, 계정 요금제/워크스페이스 유형, 설정 단계, 표시된 오류를 포함해 support@waypoint.guru로 이메일을 보내세요. 비밀번호, 토큰, 승인 링크, 비공개 여행 내용은 포함하지 마세요.