MCP 서버
Wink의 MCP 도구는 툴셋으로 공개됩니다 — 각 엔드포인트는 하나의 작업을 다루는 집중된 엔드포인트입니다. AI 클라이언트는 작업에 맞는 한두 개의 엔드포인트에만 연결하며, 모든 엔드포인트에 연결하지 않습니다.
모든 엔드포인트는 대화형 OAuth2 로그인(PKCE 권한 코드 흐름)을 사용합니다: AI 에이전트가 브라우저 탭을 열고, Wink 계정으로 로그인하면 끝입니다. 클라이언트 시크릿을 관리할 필요가 없습니다.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http도구가 여러 엔드포인트로 분리된 이유
섹션 제목: “도구가 여러 엔드포인트로 분리된 이유”Wink는 약 500개의 도구를 제공합니다. 한 번에 모두 에이전트에 제공하는 것은 기술적으로 가능하지만, 좋은 방법이 아닙니다.
도구 정의는 컨텍스트 비용이 듭니다. MCP 서버가 광고하는 모든 도구는 작업을 수행하기 전에 모델의 컨텍스트 창에 로드되며, 설명과 전체 매개변수 스키마도 포함됩니다. 500개 도구는 실제 작업에 필요한 예산의 상당 부분을 매 요청마다 소비합니다.
목록이 길어질수록 선택 품질이 떨어집니다. 500개의 비슷한 이름 도구 중에서 선택하는 에이전트는 40개 중에서 선택하는 에이전트보다 더 나쁜 선택을 합니다. 채널 매니저를 통합한다면 약 20개의 도구가 관련 있고, 나머지 480개는 올바른 도구를 찾기 어렵게 만드는 잡음입니다.
작업은 실제로 분리 가능합니다. PMS에서 가용성을 동기화하는 사람과 제휴 랜딩 페이지를 큐레이션하는 사람은 거의 도구를 공유하지 않습니다. 작업별로 분리하면 각 연결이 하나의 작업 어휘를 담습니다.
엔드포인트 디렉터리
섹션 제목: “엔드포인트 디렉터리”두 개의 호스트가 툴셋을 제공합니다. 도구 수는 대략적이며 시간이 지남에 따라 증가합니다.
https://api.wink.travel — 플랫폼
섹션 제목: “https://api.wink.travel — 플랫폼”| 엔드포인트 | 도구 수 | 다루는 내용 |
|---|---|---|
/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)**을 지원합니다. 처음 연결할 때 다음이 발생합니다:
- AI 클라이언트가 MCP 엔드포인트의
/.well-known/oauth-protected-resource메타데이터에서 권한 서버를 발견합니다. - 클라이언트가 동적 클라이언트 등록을 통해 자체 등록합니다 — 수동 애플리케이션 설정 불필요.
- 클라이언트가
https://iam.wink.travel로 브라우저 탭을 열고, Wink 계정으로 로그인 후 동의 화면에서 권한을 승인합니다. - Wink가 계정에 연결된 범위가 지정된 액세스 토큰을 발급합니다.
- AI 클라이언트가 모든 MCP 요청에 토큰을 첨부합니다. 모든 도구 결과는 자동으로 관리 단체 범위 내에서 반환됩니다.
- 토큰은 3시간 후 만료됩니다. AI 클라이언트는 백그라운드에서 조용히 토큰을 갱신합니다.
모든 도구 호출은 로그인한 사용자 신원 하에 실행됩니다 — 웹 포털을 보호하는 동일한 ACL 규칙이 AI 에이전트에도 적용됩니다.
AI 클라이언트 연결하기
섹션 제목: “AI 클라이언트 연결하기”각 툴셋을 Claude에 커스텀 커넥터로 추가하세요. 설정 파일 편집이나 애플리케이션/시크릿 생성이 필요 없습니다.
-
Claude에서 Customize › Connectors를 열고, Add 클릭 후 Add custom connector 선택.
-
Name(예: Wink Link manager)을 입력하고, MCP server URL에 위 디렉터리에서 툴셋 URL을 입력하세요. 예:
https://api.wink.travel/mcp/link-managerContinue 클릭.
-
Claude가 Wink 로그인 감지를 합니다. Authentication: Sign in now와 OAuth client: Register automatically를 유지하고 Add 클릭.
-
Connect 클릭.
https://iam.wink.travel에서 Wink 로그인 페이지가 열립니다. 로그인 후 권한을 승인하세요. -
커넥터의 도구가 채팅에서 사용 가능해집니다. 작업에 필요한 각 툴셋마다 반복하세요; 각 툴셋은 별도의 커넥터입니다.
-
Claude Code가 최신인지 확인:
터미널 창 npm install -g @anthropic-ai/claude-code -
위 디렉터리에서 툴셋을 선택해 추가하세요. 예: 가격 및 가용성
터미널 창 claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code가 서버에 연락하고 권한 서버를 발견하며 기본 브라우저를 엽니다.
-
Wink에 로그인하고 동의 화면에서 권한 요청을 승인하세요.
-
Claude Code가 연결을 확인합니다.
/mcp를 입력해 서버가 나타나고 도구가 로드되었는지 확인하세요.
필요한 만큼 툴셋을 추가하세요 — 각 툴셋은 별도의 서버 항목과 이름을 가집니다:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport http로그인은 한 번만 하면 됩니다. 첫 브라우저 승인 후 Claude Code는 추가 Wink 엔드포인트에 대해 Wink 세션을 재사용합니다.
-
Claude Desktop 설정 파일 편집:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
MCP 서버 항목 추가:
claude_desktop_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Claude Desktop을 완전히 종료 후 재시작하세요 (메뉴에서 종료 사용 — 창 닫기만으로는 부족).
-
Claude Desktop이 새 서버마다 브라우저 탭을 엽니다. Wink에 로그인하고 권한을 승인하세요.
-
하단 툴바의 플러그 아이콘이 두 서버가 연결됨을 표시합니다.
-
Codex CLI가 설치되어 있는지 확인:
터미널 창 npm install -g @openai/codex -
Codex 설정 파일 열기(또는 생성):
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Wink MCP 서버 항목 추가:
~/.codex/config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Codex 시작. 첫 사용 시
https://iam.wink.travel로 브라우저 탭이 열립니다. -
Wink에 로그인하고 요청된 권한을 승인하세요.
-
Codex가 연결을 확인합니다.
codex를 실행하고 사용 가능한 도구 목록을 요청해 Wink 서버가 활성 상태인지 확인하세요.
MCP 서버 지원은 Plus, Pro, Team, Enterprise 구독자의 ChatGPT 데스크톱 앱에서 사용할 수 있습니다.
-
아직 설치하지 않았다면 ChatGPT 데스크톱 앱을 다운로드 및 설치하세요.
-
앱을 열고 우측 상단의 프로필 아이콘을 클릭한 후 설정 선택.
-
Connectors (또는 앱 버전에 따라 MCP Servers)로 이동 후 Add 클릭.
-
위 디렉터리에서 툴셋 URL 입력, 예:
https://api.wink.travel/mcp/extranet/ratesConnect 클릭.
-
ChatGPT가
https://iam.wink.travel로 브라우저 탭을 열고, Wink에 로그인 후 권한 승인. -
작업에 필요한 다른 툴셋도 4–5단계 반복, 예:
https://api.wink.travel/mcp/extranet/operations -
각 툴셋이 Connectors 목록에 나타납니다. 새 채팅을 시작하면 Wink 도구가 자동으로 사용 가능합니다.
-
Cursor MCP 설정 파일 열기(또는 생성):
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Wink MCP 서버 항목 추가:
~/.cursor/mcp.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Cursor 열기. Settings → Cursor Settings → MCP로 이동해 두 서버가 녹색 상태로 표시되는지 확인하세요. 빨간색이면 Refresh 클릭.
-
Cursor가
https://iam.wink.travel로 브라우저 탭을 엽니다. Wink에 로그인하고 권한 승인. -
채팅 열기(
Ctrl+L/Cmd+L) 후 Cursor에 Wink 도구 목록을 요청해 연결을 확인하세요.
-
Windsurf MCP 설정 파일 열기(또는 생성):
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Wink MCP 서버 항목 추가:
~/.codeium/windsurf/mcp_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Windsurf를 완전히 재시작하세요 (파일 → 종료 후 재실행).
-
Settings → MCP Servers로 이동해 두 서버가 연결됨을 확인하세요. 첫 사용 시 Windsurf가
https://iam.wink.travel로 브라우저 탭을 엽니다. -
Wink에 로그인하고 권한 승인. 인증되면 설정 패널에서 서버가 녹색으로 표시됩니다.
Cline은 MCP 서버 관리자가 내장된 VS Code 확장입니다. 수동 JSON 편집이 필요 없습니다.
-
VS Code 마켓플레이스에서 Cline 설치:
- VS Code 열고
Ctrl+Shift+X/Cmd+Shift+X누름 - Cline 검색 후 Install 클릭
- VS Code 열고
-
활동 표시줄(왼쪽 사이드바)에서 Cline 아이콘 클릭해 패널 열기.
-
Cline 툴바에서 MCP Servers 아이콘(플러그 아이콘) 클릭 후 Edit MCP Settings 선택.
-
VS Code가
cline_mcp_settings.json을 엽니다. Wink 항목 추가:cline_mcp_settings.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
파일 저장. Cline이 자동으로 다시 로드되고
https://iam.wink.travel로 브라우저 탭을 엽니다. -
Wink에 로그인하고 권한 승인. MCP Servers 패널에 두 서버가 활성 상태로 표시됩니다.
권한 범위(Scopes)
섹션 제목: “권한 범위(Scopes)”동의 화면에서 에이전트가 요청하는 권한 내역을 확인할 수 있습니다. 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 Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpClaude 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
