콘텐츠로 이동

MCP 서버

Wink의 MCP 도구는 툴셋으로 공개됩니다 — 각 엔드포인트는 하나의 작업을 다루는 집중된 엔드포인트입니다. AI 클라이언트는 작업에 맞는 한두 개의 엔드포인트에만 연결하며, 모든 엔드포인트에 연결하지 않습니다.

모든 엔드포인트는 대화형 OAuth2 로그인(PKCE 권한 코드 흐름)을 사용합니다: AI 에이전트가 브라우저 탭을 열고, Wink 계정으로 로그인하면 끝입니다. 클라이언트 시크릿을 관리할 필요가 없습니다.

채널 매니저 통합자가 하나의 엔드포인트에 연결하는 예
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
자체 요금을 관리하는 호텔리어가 다른 엔드포인트에 연결하는 예
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

도구가 여러 엔드포인트로 분리된 이유

섹션 제목: “도구가 여러 엔드포인트로 분리된 이유”

Wink는 약 500개의 도구를 제공합니다. 한 번에 모두 에이전트에 제공하는 것은 기술적으로 가능하지만, 좋은 방법이 아닙니다.

도구 정의는 컨텍스트 비용이 듭니다. MCP 서버가 광고하는 모든 도구는 작업을 수행하기 전에 모델의 컨텍스트 창에 로드되며, 설명과 전체 매개변수 스키마도 포함됩니다. 500개 도구는 실제 작업에 필요한 예산의 상당 부분을 매 요청마다 소비합니다.

목록이 길어질수록 선택 품질이 떨어집니다. 500개의 비슷한 이름 도구 중에서 선택하는 에이전트는 40개 중에서 선택하는 에이전트보다 더 나쁜 선택을 합니다. 채널 매니저를 통합한다면 약 20개의 도구가 관련 있고, 나머지 480개는 올바른 도구를 찾기 어렵게 만드는 잡음입니다.

작업은 실제로 분리 가능합니다. PMS에서 가용성을 동기화하는 사람과 제휴 랜딩 페이지를 큐레이션하는 사람은 거의 도구를 공유하지 않습니다. 작업별로 분리하면 각 연결이 하나의 작업 어휘를 담습니다.


두 개의 호스트가 툴셋을 제공합니다. 도구 수는 대략적이며 시간이 지남에 따라 증가합니다.

엔드포인트도구 수다루는 내용
/mcp/extranet/facilities약 64예약 가능 및 현장 재고: 객실 및 객실 유형, 스파, 레스토랑, 회의실, 액티비티, 명소, 장소, 기타 판매 가능한 항목
/mcp/extranet/property약 62숙소 기록 및 상업 조건: 프로필 및 콘텐츠, 추가 옵션, 취소 정책, 혜택, 공지사항
/mcp/settings약 60계정 관리: 관리 단체 프로필 및 브랜딩, 관리자 및 권한, 맞춤 설정, 웹훅, 알림 설정
/mcp/studio/embeds약 48큐레이션된 재고 게시: 위젯, 그리드 및 순위 그리드, 카드, 지도, 재고 및 공급자 페이지로의 딥 링크
/mcp/extranet/rates약 44가격 및 가용성: 재고 요금 기간 및 할당량, 요금제, 마스터 요금, 특별 및 프로모션 요금
/mcp/extranet/operations약 39라이브 숙소 운영: 예약 및 수명 주기, 고객 리뷰 및 응답, 캘린더 피드, 예약된 작업
/mcp/extranet/distribution약 37재고 판매처: 판매 채널 및 요금 조정자, 제휴 및 공급자 관계 요청, 등록, 리드 캡처
/mcp/studio/curation약 35판매 가능한 컬렉션 구축: 정적 및 동적 목록, 순위 목록, 저장된 검색, 숙소 집계
/mcp/link-manager약 28신디케이트 링크 컬렉션, 디자인, 카테고리 및 태그, 단축 URL
/mcp/reference약 24읽기 전용 조회 데이터: 국가, 통화 및 환율, 언어, 시간대, 지리 조회, IP 지리 위치
/mcp/analytics약 18예약 및 수익 분석: 개요, 선 그래프, 리더보드, 제휴 성과, 공유 지표
/mcp/payment약 18금융 운영: 원장, 출금 및 수수료 추정, 예약 자금 집계
/mcp/booking-engine약 17여행자 대상 쇼핑 경로: 검색 및 조회, 쇼핑 카트 및 체크아웃, 버킷 리스트, 캠페인 맞춤 설정
/mcp/social약 17연결된 소셜 계정, 게시 및 예약, 게시물 인사이트 읽기
/mcp/travel-agent약 8여행자를 대신한 에이전트 예약 및 에이전트 보고서

https://integrations.wink.travel — 채널 매니저 통합

섹션 제목: “https://integrations.wink.travel — 채널 매니저 통합”

한 개의 엔드포인트만 존재하며, 이 호스트는 한 가지 작업을 위해 존재합니다.

엔드포인트도구 수다루는 내용
/mcp/channel-manager약 9채널 매니저, PMS 또는 CRS 통합 연결 및 검증

모든 엔드포인트는 ping 도구도 포함하여, 실제 작업 요청 전에 연결이 활성 상태인지 확인할 수 있습니다.

완전한 여행자 예약 흐름을 위해, https://api.wink.travel/mcp/booking-engine의 Wink Booking Engine과 호환되는 결제 지갑을 연결하세요. Wink MCP를 추가하면 브라우저 로그인 및 권한 선택이 열리고, 클라이언트가 인증을 처리합니다.

Booking Engine은 목적지 조회, 호텔 및 객실 검색, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, 예약 조회 및 영수증을 포함하며, 해당 환경에서 에이전틱 예약 및 결제가 활성화된 경우에만 작동합니다. 연결 설정, 선택할 권한 및 검색부터 확인까지의 단계는 Agentic Payments를 참조하세요.


상황연결할 엔드포인트
채널 매니저, PMS 또는 CRS 통합integrations.wink.travel/mcp/channel-manager — 이 하나만
숙소 콘텐츠 관리/mcp/extranet/property + /mcp/extranet/facilities
객실 및 객실 유형 관리/mcp/extranet/facilities
가격 및 가용성 관리/mcp/extranet/rates
일상 예약 운영/mcp/extranet/operations
유통 확대/mcp/extranet/distribution + /mcp/analytics
제휴 페이지 구축/mcp/studio/curation + /mcp/studio/embeds
링크 인 바이오 페이지 운영/mcp/link-manager + /mcp/social
여행자를 대신한 예약/mcp/travel-agent
금융 정산/mcp/payment
AI 에이전트로 객실 예약/mcp/booking-engine + 호환 결제 지갑 — Agentic Payments 참조
예약 경험 구축/mcp/booking-engine; 추가 조회가 필요하면 선택적으로 /mcp/reference

Booking Engine은 핵심 예약 워크플로우를 포함합니다. 계정 및 맞춤 설정 검색, 목적지 조회, 호텔 가용성 및 객실 요금 세부 정보, 쇼핑 카트, 체크아웃, 여행자 예약 관리 기능을 제공합니다. 해당 환경에서 활성화된 경우 에이전틱 예약 및 결제 도구도 포함됩니다.

도시 기반 호텔 검색 시 destination_lookup_search_suggestions로 목적지를 확인하고, inventory_search_city로 이용 가능한 호텔과 요금을 찾으세요. 두 도구 모두 /mcp/booking-engine에 있으므로, 이 흐름에는 Reference 연결이 필요 없습니다.

국가, 통화 및 환율, 지원 언어, 시간대, 광역 지리 검색, OTA 분류, 공개 숙소 정보 등 지원 조회가 필요하면 /mcp/reference를 추가하세요. 예약 흐름에 선택적으로 추가할 수 있습니다.

처음에는 하나만 시작하세요. 필요에 따라 다른 것을 추가하세요 — 각 연결은 독립적이며, 하나를 추가해도 다른 연결에 영향을 주지 않습니다.


Wink MCP 서버는 OAuth2 권한 코드 + PKCE 흐름을 사용하며 **동적 클라이언트 등록(RFC 7591)**을 지원합니다. 처음 연결할 때 다음이 발생합니다:

  1. AI 클라이언트가 MCP 엔드포인트의 /.well-known/oauth-protected-resource 메타데이터에서 권한 서버를 발견합니다.
  2. 클라이언트가 동적 클라이언트 등록을 통해 자체 등록합니다 — 수동 애플리케이션 설정 불필요.
  3. 클라이언트가 https://iam.wink.travel로 브라우저 탭을 열고, Wink 계정으로 로그인 후 동의 화면에서 권한을 승인합니다.
  4. Wink가 계정에 연결된 범위가 지정된 액세스 토큰을 발급합니다.
  5. AI 클라이언트가 모든 MCP 요청에 토큰을 첨부합니다. 모든 도구 결과는 자동으로 관리 단체 범위 내에서 반환됩니다.
  6. 토큰은 3시간 후 만료됩니다. AI 클라이언트는 백그라운드에서 조용히 토큰을 갱신합니다.

모든 도구 호출은 로그인한 사용자 신원 하에 실행됩니다 — 웹 포털을 보호하는 동일한 ACL 규칙이 AI 에이전트에도 적용됩니다.


각 툴셋을 Claude에 커스텀 커넥터로 추가하세요. 설정 파일 편집이나 애플리케이션/시크릿 생성이 필요 없습니다.

  1. Claude에서 Customize › Connectors를 열고, Add 클릭 후 Add custom connector 선택.

  2. Name(예: Wink Link manager)을 입력하고, MCP server URL에 위 디렉터리에서 툴셋 URL을 입력하세요. 예:

    https://api.wink.travel/mcp/link-manager

    Continue 클릭.

  3. Claude가 Wink 로그인 감지를 합니다. Authentication: Sign in now와 OAuth client: Register automatically를 유지하고 Add 클릭.

  4. Connect 클릭. https://iam.wink.travel에서 Wink 로그인 페이지가 열립니다. 로그인 후 권한을 승인하세요.

  5. 커넥터의 도구가 채팅에서 사용 가능해집니다. 작업에 필요한 각 툴셋마다 반복하세요; 각 툴셋은 별도의 커넥터입니다.


동의 화면에서 에이전트가 요청하는 권한 내역을 확인할 수 있습니다. MCP 클라이언트는 플랫폼의 다른 부분과 동일한 권한 어휘를 사용합니다 — 전체 내용은 인증 페이지의 권한 범위 참조를 참고하세요.

MCP에 특화된 세 가지 사항:

  • mcp.read, mcp.write, mcp.remove 권한이 추가로 필요하여 MCP 전송을 엽니다. mcp.* 권한을 가진 클라이언트는 모든 Wink MCP 엔드포인트에 접근할 수 있지만, 호출하는 각 도구는 여전히 해당 엔드포인트의 섹션 권한(예: booking.read)을 적용합니다.
  • MCP는 항상 로그인한 사용자로 작동합니다. AI 클라이언트는 로그인 과정을 통해 mcp.* 권한을 받으며, 사용자가 생성한 애플리케이션에서 받지 않습니다. 머신 대 머신(클라이언트 자격 증명) 토큰은 MCP 전송을 열 수 없으며, 서버 간 작업에는 REST API를 사용하세요.
  • AI 클라이언트는 필요한 권한만 요청합니다. 동의 화면에서 개별 권한을 거부할 수 있으며, 거부된 권한이 필요한 도구는 호출 시 오류를 반환합니다.

툴셋은 이 내용을 변경하지 않습니다. 연결하는 엔드포인트가 나열된 도구를 결정할 뿐, 허용된 작업을 결정하지 않습니다. /mcp/payment에 연결해도 기존에 없는 금융 권한이 부여되지 않으며, /mcp/reference에 연결해도 도구가 자체 권한을 적용하는 것을 막지 않습니다. 권한 부여는 토큰과 계정 권한에 따라 도구 호출별로 결정됩니다.


브라우저 탭이 열리지 않음

AI 클라이언트가 대화형 PKCE 흐름을 아직 지원하지 않을 수 있습니다. 최신 버전을 사용 중인지 확인하세요:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT 데스크톱: 앱 내장 업데이트로 최신화

로그인 후 401 Unauthorized

캐시된 토큰이 만료되었을 수 있습니다. 서버를 제거 후 다시 추가해 새 로그인 과정을 트리거하세요:

터미널 창
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Claude Desktop과 ChatGPT는 설정에서 서버 항목을 제거 후 앱 재시작 후 다시 추가하세요.

특정 도구 호출 시 403 Forbidden

도구가 동의 화면에서 승인하지 않은 권한이나 계정에 없는 권한을 요구합니다. 서버를 다시 연결하면 동의 화면이 다시 나타나며 누락된 권한을 승인할 수 있습니다. 계속 실패하면 도구가 요구하는 계정 권한이 없다는 뜻이며, 다른 툴셋에 연결해도 권한이 부여되지 않습니다.

필요한 도구가 목록에 없음

작업을 다루지 않는 툴셋에 연결되어 있을 가능성이 큽니다. 엔드포인트 디렉터리를 확인하고 해당 작업을 다루는 툴셋을 추가하세요. 연결은 독립적이므로 하나를 추가해도 다른 연결에는 영향이 없습니다. 어떤 툴셋에 있는지 모르면 임시로 https://api.wink.travel/mcp에 연결해 도구를 찾고, 어느 툴셋에 포함되어 있는지 확인하세요.

툴셋 엔드포인트에서 404 Not Found

경로를 정확히 확인하세요 — 중첩된 툴셋은 두 개 세그먼트(/mcp/extranet/rates), 평면 툴셋은 한 개 세그먼트(/mcp/link-manager)입니다. 인증되지 않은 /mcp 하위 경로 요청은 401을 반환하며, 401만으로 엔드포인트 존재 여부를 판단할 수 없습니다.

api.wink.travel/mcp/channel-manager에 연결했는데 아무것도 없음

해당 엔드포인트는 존재하지 않습니다. 채널 매니저 통합은 https://integrations.wink.travel/mcp/channel-manager에서만 제공됩니다. 숙소의 자체 요금을 직접 읽거나 쓰려면 별도의 작업이며 /mcp/extranet/rates를 사용하세요.

서버는 나타나지만 도구 호출 시 “account not found”

관리 단체가 없는 Wink 계정으로 로그인한 상태입니다. Wink Portal에서 계정 설정을 완료한 후 MCP 서버를 사용하세요.

세션 중 토큰 만료

토큰은 3시간 유효합니다. Claude Code와 Claude Desktop은 조용히 토큰을 갱신합니다. 장시간 유휴 후 인증 오류가 발생하면 새 메시지를 입력하세요 — 클라이언트가 자동으로 재인증합니다.

Codex CLI가 “MCP server unreachable” 표시

~/.codex/config.json이 유효한 JSON인지(후행 쉼표 없음) 확인하고 "type": "http"가 설정되어 있는지 확인하세요. Codex는 원격 서버에 HTTP 전송을 요구하며, stdio 전송은 로컬 바이너리에만 사용됩니다.

ChatGPT “Connectors” 메뉴가 없음

MCP 지원은 ChatGPT 데스크톱 앱 버전 1.2024.352 이상과 Plus, Pro, Team, Enterprise 구독이 필요합니다. 앱을 업데이트하고 설정 → 계정에서 플랜을 확인하세요.

Cursor 서버가 빨간색 / “Failed to connect”

~/.cursor/mcp.json이 유효한 JSON이고 "type": "http"가 포함되어 있는지 확인하세요. Settings → Cursor Settings → MCP에서 Refresh 클릭. 오류가 계속되면 Cursor를 완전히 재시작하세요 — 설정 변경이 즉시 반영되지 않을 수 있습니다.

Windsurf MCP 서버가 설정에 표시되지 않음

Windsurf는 mcp_config.json 변경 사항을 인식하려면 완전 재시작이 필요합니다 (창 새로고침만으로는 부족). File → Quit 후 재실행하세요. 여전히 안 보이면 Windsurf 버전이 1.4 이상인지 Help → About Windsurf에서 확인하세요.

Cline에서 “Add Server” 옵션이 보이지 않음

MCP 서버 관리자는 Cline 2.0 이상이 필요합니다. VS Code 확장 패널에서 Cline을 찾아 업데이트가 있으면 설치하세요. 업데이트 후 VS Code를 다시 로드하세요 (Ctrl+Shift+P → “Developer: Reload Window”).


Wink Portal 열기 GitHub의 Wink