Сервери MCP

Wink надає два аутентифіковані сервери MCP. Обидва використовують інтерактивний вхід через OAuth2 (PKCE authorization code flow) — ваш AI-агент відкриває вкладку браузера, щоб ви могли увійти за допомогою облікового запису Wink. Немає необхідності керувати секретами клієнта.

Сервер	URL	Що робить
Inventory API	https://api.wink.travel/mcp	Інвентар, бронювання, тарифи, канали продажу, аналітика та всі операції платформи
Integrations	https://integrations.wink.travel/mcp	Інтеграції з менеджерами каналів — синхронізація об’єктів, тарифів і доступності з OTA

---

Як працює аутентифікація

Сервери MCP Wink використовують потік OAuth2 Authorization Code + PKCE та підтримують Dynamic Client Registration (RFC 7591). Ось що відбувається при першому підключенні:

1. Ваш AI-клієнт виявляє сервер авторизації з метаданих /.well-known/oauth-protected-resource кінцевої точки MCP.
2. Клієнт самостійно реєструється через Dynamic Client Registration — налаштування вручну не потрібне.
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

Поділіться з командою

Додайте --scope project до claude mcp add, і 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 (використовуйте Quit у меню — просто закрити вікно недостатньо).

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.

Заувага

Підтримка MCP у Codex CLI вимагає версії 1.0 або новішої. Перевірте за допомогою codex --version і оновіть через npm install -g @openai/codex.

ChatGPT

Підтримка серверів MCP доступна у десктопному додатку ChatGPT для підписників Plus, Pro, Team та Enterprise.

1. Завантажте та встановіть десктопний додаток ChatGPT, якщо ще не зробили цього.

2. Відкрийте додаток і натисніть вашу іконку профілю у верхньому правому куті, потім оберіть Налаштування.

3. Перейдіть до Підключень (або Сервери MCP залежно від версії додатку) і натисніть Додати.

4. Введіть URL сервера Wink Inventory:

   https://api.wink.travel/mcp

   Потім натисніть Підключити.

5. ChatGPT відкриває вкладку браузера на https://iam.wink.travel. Увійдіть у Wink і підтвердіть дозволи.

6. Повторіть кроки 4–5 для сервера Integrations:

   https://integrations.wink.travel/mcp

7. Обидва сервери з’являться у списку підключень. Почніть новий чат — інструменти Wink будуть доступні автоматично.

Обмеження веб-додатку

Сервери MCP можна налаштовувати лише у десктопному додатку. Веб-інтерфейс ChatGPT на 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, щоб підтвердити підключення.

Конфігурація на рівні проєкту

Ви також можете розмістити файл mcp.json у корені вашого проєкту замість ~/.cursor/. Конфігурація на рівні проєкту має пріоритет і робить сервери доступними для кожного члена команди, який відкриває проєкт у Cursor.

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 і підтвердіть дозволи. Сервери стануть зеленими у панелі налаштувань після аутентифікації.

Заувага

Підтримка MCP у Windsurf вимагає версії 1.4 або новішої. Перевірте через Довідка → Про Windsurf і оновіть з офіційного сайту, якщо потрібно.

Cline (VS Code)

Cline — це розширення для VS Code з вбудованим менеджером серверів MCP. Редагування JSON вручну не потрібне.

1. Встановіть Cline з VS Code Marketplace:

   • Відкрийте VS Code і натисніть Ctrl+Shift+X / Cmd+Shift+X
   • Знайдіть Cline і натисніть Встановити

2. Натисніть іконку Cline у панелі активності (ліва бічна панель), щоб відкрити панель Cline.

3. Натисніть іконку Сервери MCP (іконка штекера) на панелі інструментів Cline, потім оберіть Редагувати налаштування 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 desktop: оновіть через вбудований оновлювач додатку

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 Portal і переконайтеся, що ваш обліковий запис налаштовано перед використанням сервера MCP.

Токен закінчується під час сесії

Токени дійсні 3 години. Claude Code і Claude Desktop оновлюють токени у фоновому режимі без переривання сесії. Якщо після тривалої бездіяльності з’являються помилки аутентифікації, надішліть нове повідомлення — клієнт автоматично повторно аутентифікується.

Codex CLI показує “MCP server unreachable”

Перевірте, що ваш ~/.codex/config.json є валідним JSON (без зайвих ком) і що "type": "http" встановлено. Codex вимагає HTTP-транспорт для віддалених серверів; stdio-транспорт призначений лише для локальних бінарних файлів.

Меню “Connectors” у ChatGPT відсутнє

Підтримка MCP вимагає версії десктопного додатку ChatGPT 1.2024.352 або новішої та активної підписки Plus, Pro, Team або Enterprise. Оновіть додаток і перевірте план у Налаштуваннях → Обліковий запис.

Сервер Cursor показує червоний статус / “Failed to connect”

Перевірте, що ваш ~/.cursor/mcp.json є валідним JSON і містить "type": "http". Потім перейдіть у Налаштування → Налаштування Cursor → MCP і натисніть Оновити. Якщо помилка не зникає, повністю перезапустіть Cursor — зміни конфігурації не завжди застосовуються без перезапуску.

Сервери Windsurf MCP не відображаються в налаштуваннях

Windsurf вимагає повного перезапуску (не лише перезавантаження вікна) для застосування змін у mcp_config.json. Використовуйте Файл → Вийти і знову відкрийте додаток. Якщо сервери все ще не з’являються, переконайтеся, що у вас Windsurf версії 1.4+ через Довідка → Про Windsurf.

Опція “Add Server” у Cline не відображається

Менеджер серверів MCP вимагає Cline версії 2.0 або новішої. Відкрийте панель розширень VS Code, знайдіть Cline і натисніть Оновити, якщо доступне оновлення. Після оновлення перезавантажте VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Відкрити Wink Portal Wink на GitHub