MCP 서버

Wink는 두 개의 인증된 MCP 서버를 제공합니다. 두 서버 모두 인터랙티브 OAuth2 로그인(PKCE 권한 코드 흐름)을 사용하며, AI 에이전트가 브라우저 탭을 열어 Wink 계정으로 로그인합니다. 클라이언트 시크릿을 관리할 필요가 없습니다.

서버	URL	기능
Inventory API	https://api.wink.travel/mcp	인벤토리, 예약, 요금, 판매 채널, 분석 및 모든 플랫폼 운영
Integrations	https://integrations.wink.travel/mcp	채널 관리자 통합 — OTA와 숙소, 요금, 가용성 동기화

---

인증 작동 방식

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 에이전트에도 적용됩니다.

---

AI 클라이언트 연결하기

Claude Code

1. Claude Code가 최신 버전인지 확인하세요:

   npm install -g @anthropic-ai/claude-code

2. Wink Inventory MCP 서버를 추가하세요:

   claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

3. Claude Code가 서버에 접속하여 권한 서버를 발견하고 기본 브라우저를 엽니다.

4. Wink에 로그인하고 동의 화면에서 권한 요청을 승인하세요.

5. Claude Code가 연결을 확인합니다. /mcp를 입력하여 서버가 나타나고 도구가 로드되었는지 확인하세요.

Integrations 서버도 추가하려면:

claude mcp add wink-integrations https://integrations.wink.travel/mcp --transport http

팀과 공유하기

claude mcp add 명령에 --scope project를 추가하면 Claude Code가 서버 URL을 저장소 루트의 .mcp.json에 기록합니다. 해당 파일을 커밋하면 각 팀원이 처음 연결 시 자신의 브라우저에서 로그인 절차를 완료할 수 있습니다.

Claude Desktop

1. 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

2. MCP 서버 항목을 추가하세요:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Claude Desktop을 완전히 종료 후 재시작하세요 (메뉴 바에서 종료 사용 — 창 닫기만으로는 충분하지 않습니다).

4. Claude Desktop이 새 서버마다 브라우저 탭을 엽니다. Wink에 로그인하고 권한을 승인하세요.

5. 하단 툴바의 플러그 아이콘이 두 서버가 연결되었음을 표시합니다.

OpenAI Codex

1. Codex CLI가 설치되어 있는지 확인하세요:

   npm install -g @openai/codex

2. Codex 설정 파일을 열거나 생성하세요:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Wink MCP 서버 항목을 추가하세요:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. Codex를 시작하세요. 첫 사용 시 Codex가 https://iam.wink.travel로 브라우저 탭을 엽니다.

5. Wink에 로그인하고 요청된 권한을 승인하세요.

6. Codex가 연결을 확인합니다. codex를 실행하고 사용 가능한 도구 목록을 요청하여 Wink 서버가 활성 상태인지 확인하세요.

참고

Codex CLI의 MCP 지원은 버전 1.0 이상이 필요합니다. codex --version으로 버전을 확인하고, npm install -g @openai/codex로 업그레이드하세요.

ChatGPT

MCP 서버 지원은 Plus, Pro, Team, Enterprise 구독자를 위한 ChatGPT 데스크톱 앱에서 제공됩니다.

1. 아직 설치하지 않았다면 ChatGPT 데스크톱 앱을 다운로드 및 설치하세요.

2. 앱을 열고 오른쪽 상단의 프로필 아이콘을 클릭한 후 설정을 선택하세요.

3. 커넥터(또는 앱 버전에 따라 MCP 서버)로 이동하여 추가를 클릭하세요.

4. Wink Inventory 서버 URL을 입력하세요:

   https://api.wink.travel/mcp

   그리고 연결을 클릭하세요.

5. ChatGPT가 https://iam.wink.travel로 브라우저 탭을 열고, Wink에 로그인하여 권한을 승인하세요.

6. Integrations 서버도 4~5단계를 반복하세요:

   https://integrations.wink.travel/mcp

7. 두 서버가 커넥터 목록에 나타납니다. 새 채팅을 시작하면 Wink 도구가 자동으로 사용 가능합니다.

웹 앱 제한 사항

MCP 서버는 데스크톱 앱에서만 구성할 수 있습니다. chatgpt.com 웹 인터페이스는 사용자 지정 MCP 서버를 지원하지 않습니다.

Cursor

1. Cursor MCP 설정 파일을 열거나 생성하세요:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Wink MCP 서버 항목을 추가하세요:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Cursor를 열고 설정 → Cursor 설정 → MCP로 이동하여 두 서버가 녹색 상태 표시와 함께 나타나는지 확인하세요. 빨간색이면 새로고침을 클릭하세요.

4. Cursor가 https://iam.wink.travel로 브라우저 탭을 열고, Wink에 로그인하여 권한을 승인하세요.

5. 채팅을 열고(Ctrl+L / Cmd+L) Cursor에게 사용 가능한 Wink 도구 목록을 요청하여 연결을 확인하세요.

프로젝트 범위 설정

~/.cursor/ 대신 프로젝트 루트에 mcp.json 파일을 배치할 수도 있습니다. 프로젝트 수준 설정이 우선 적용되며, 프로젝트를 여는 모든 팀원이 서버를 사용할 수 있습니다.

Windsurf

1. Windsurf MCP 설정 파일을 열거나 생성하세요:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Wink MCP 서버 항목을 추가하세요:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Windsurf를 완전히 재시작하세요 (파일 → 종료 후 다시 열기).

4. 설정 → MCP 서버로 이동하여 두 서버가 연결됨을 확인하세요. 첫 사용 시 Windsurf가 https://iam.wink.travel로 브라우저 탭을 엽니다.

5. Wink에 로그인하고 권한을 승인하세요. 인증되면 설정 패널에서 서버가 녹색으로 표시됩니다.

참고

Windsurf MCP 지원은 버전 1.4 이상이 필요합니다. 도움말 → Windsurf 정보에서 버전을 확인하고, 필요 시 Windsurf 웹사이트에서 업데이트하세요.

Cline (VS Code)

Cline은 MCP 서버 관리자가 내장된 VS Code 확장입니다. JSON을 수동으로 편집할 필요가 없습니다.

1. VS Code 마켓플레이스에서 Cline을 설치하세요:

   • VS Code를 열고 Ctrl+Shift+X / Cmd+Shift+X를 누르세요
   • Cline을 검색하고 설치를 클릭하세요

2. 활동 표시줄(왼쪽 사이드바)에서 Cline 아이콘을 클릭하여 Cline 패널을 엽니다.

3. Cline 툴바에서 MCP 서버 아이콘(플러그 아이콘)을 클릭한 후 MCP 설정 편집을 선택하세요.

4. VS Code가 cline_mcp_settings.json을 열면 Wink 항목을 추가하세요:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. 파일을 저장하세요. Cline이 자동으로 다시 로드되고 https://iam.wink.travel로 브라우저 탭을 엽니다.

6. Wink에 로그인하고 권한을 승인하세요. MCP 서버 패널에 두 서버가 활성 상태로 표시됩니다.

대안: URL로 추가

MCP 서버 패널에서 서버 추가를 클릭하고 https://api.wink.travel/mcp를 직접 붙여넣으세요. Cline이 자동으로 설정을 채우고 JSON 편집 없이 인증을 처리합니다.

---

권한 범위(Scopes)

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

MCP에만 해당하는 두 가지 사항:

• mcp.read, mcp.write, mcp.remove 권한 범위가 추가로 필요하여 MCP 전송을 엽니다. mcp.* 권한을 가진 클라이언트는 /mcp에 접근할 수 있지만, 호출하는 각 도구는 여전히 해당 엔드포인트의 섹션 권한(예: booking.read)을 적용합니다.
• AI 클라이언트는 필요한 권한만 요청합니다. 동의 화면에서 개별 권한을 거부할 수 있으며, 거부된 권한이 필요한 도구는 호출 시 오류를 반환합니다.

---

문제 해결

브라우저 탭이 열리지 않음

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-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

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

특정 도구 호출 시 403 Forbidden 오류

도구가 동의 화면에서 승인하지 않은 권한을 요구합니다. 서버를 다시 연결하면 동의 화면이 다시 나타나며 누락된 권한을 승인할 수 있습니다.

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

관리 엔터티가 없는 Wink 계정으로 로그인한 상태입니다. Wink 포털에서 계정 설정을 확인한 후 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 서버가 빨간색 / “연결 실패” 표시

~/.cursor/mcp.json이 올바른 JSON이고 "type": "http"가 포함되어 있는지 확인하세요. 그런 다음 설정 → Cursor 설정 → MCP에서 새로고침을 클릭하세요. 오류가 계속되면 Cursor를 완전히 재시작하세요 — 설정 변경 사항이 재시작 없이는 반영되지 않을 수 있습니다.

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

Windsurf는 mcp_config.json 변경 사항을 반영하려면 완전한 재시작이 필요합니다(창 새로고침만으로는 안 됨). 파일 → 종료 후 재실행하세요. 여전히 서버가 나타나지 않으면 도움말 → Windsurf 정보에서 버전이 1.4 이상인지 확인하세요.

Cline에서 “서버 추가” 옵션이 보이지 않음

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

---

Wink 포털 열기 GitHub의 Wink