Сервери MCP

Інструменти MCP Wink публікуються як набори інструментів — сфокусовані кінцеві точки, кожна з яких охоплює одну задачу. Ви підключаєте свій AI-клієнт до однієї або двох, що відповідають вашій роботі, а не до всіх одразу.

Кожна кінцева точка використовує інтерактивний вхід OAuth2 (PKCE authorization code flow): ваш AI-агент відкриває вкладку браузера, ви входите у свій акаунт Wink, і все. Немає секретів клієнта для керування.

Інтегратор channel manager підключається до однієї кінцевої точки

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 інструментів з подібними назвами, робить гірші вибори, ніж той, що обирає з 40. Якщо ви інтегруєте channel manager, приблизно двадцять інструментів релевантні для вас; інші 480 — це шум, що ускладнює пошук потрібного інструменту.

Роботу справді можна розділити. Хтось, хто синхронізує доступність з PMS, і хтось, хто курує афілійовані лендинг-сторінки, майже не мають спільних інструментів. Розподіл за задачами означає, що кожне підключення несе словник однієї задачі.

Набори інструментів — це не права доступу

Вибір вузького набору інструментів не обмежує можливості вашого акаунта, а вибір широкого не надає нічого додаткового. Кожен інструмент застосовує ті ж права акаунта, що й веб-портал, під вашим увійденим ідентифікатором. Якщо ваш акаунт не може скасувати бронювання у Wink Portal, агент теж не зможе — незалежно від того, до якої кінцевої точки він підключений.

Обирайте набори інструментів для фокусу, а не для безпеки.

---

Каталог кінцевих точок

Два хости обслуговують набори інструментів. Кількість інструментів приблизна і з часом зростає.

https://api.wink.travel — платформа

Кінцева точка	Інструменти	Що охоплює
/mcp/extranet/facilities	~64	Бронювальний та onsite інвентар: гостьові кімнати та типи кімнат, спа, ресторани, конференц-зали, активності, атракції, місця, інші товари для продажу
/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 — інтеграції channel manager

Одна кінцева точка, бо цей хост існує для однієї задачі.

Кінцева точка	Інструменти	Що охоплює
/mcp/channel-manager	~9	Підключення та перевірка інтеграції channel manager, PMS або CRS

Інтеграція channel manager vs. керування власними тарифами

Це різні задачі для різних людей, і вони не ділять кінцеву точку.

Постачальник channel manager, PMS або CRS інтегрується один раз через integrations.wink.travel/mcp/channel-manager, і відтоді обмінюється об’єктами, тарифами, доступністю та бронюваннями через цю інтеграцію. Ця одна кінцева точка — вся поверхня.

Готельєр, що змінює власні тарифи вручну, використовує набори інструментів екстранету на api.wink.travel — /mcp/extranet/rates та інші. Вони не є частиною інтеграції channel manager, і інтегратор не має причин підключатися до них.

Адміністрування акаунта також на api.wink.travel, за адресою /mcp/settings. На хості інтеграцій немає /mcp/settings.

Кожна кінцева точка також має інструмент ping, щоб ви могли підтвердити, що з’єднання активне, перш ніж просити виконати реальну роботу.

Агентські платежі

Для повного потоку бронювання мандрівника підключайте Wink Booking Engine за адресою https://api.wink.travel/mcp/booking-engine та сумісний платіжний гаманець. Додавання MCP Wink відкриває вхід у браузері та вибір дозволів; ваш клієнт потім обробляє автентифікацію.

Booking Engine включає пошук напрямку, пошук готелів і кімнат, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, отримання бронювань і квитанцій, коли агентське бронювання та оплата увімкнені для цього середовища. Дивіться Agentic Payments для налаштування підключення, вибору дозволів і кроків від пошуку до підтвердження.

---

Які набори інструментів мені потрібні?

Якщо ви…	Підключайтеся до
Інтегруєте channel manager, 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
Керуєте сторінками link-in-bio	/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.

Додавайте /mcp/reference, коли потрібні допоміжні пошуки, такі як країни, валюти та курси обміну, підтримувані мови, часові пояси, ширші географічні пошуки, класифікації OTA або публічна інформація про об’єкти. Це необов’язкові доповнення до потоку бронювання.

Починайте з одного. Додавайте інший, коли помітите, що щось не може зробити перший — кожне підключення незалежне, і додавання одного не впливає на інші.

Все ще хочете все?

https://api.wink.travel/mcp та https://integrations.wink.travel/mcp залишаються доступними і обслуговують усі інструменти на своєму хості. Вони корисні для ознайомлення з наявним, але ми не рекомендуємо їх для щоденної роботи: список інструментів занадто великий, щоб не заважати вашому завданню і погіршувати вибір інструментів агентом. Віддавайте перевагу наведеним вище наборам інструментів.

---

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

Сервери 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. Оберіть набір інструментів із каталогу вище і додайте його. Наприклад, ціни та доступність:

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

3. Claude Code зв’язується з сервером, знаходить сервер авторизації і відкриває ваш браузер за замовчуванням.

4. Увійдіть у Wink і підтвердіть запит дозволів на екрані згоди.

5. Claude Code підтверджує підключення. Введіть /mcp, щоб перевірити, що сервер з’явився і його інструменти завантажені.

Додавайте стільки наборів інструментів, скільки потрібно для вашої роботи — кожен це окремий запис сервера з власною назвою:

claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics  https://api.wink.travel/mcp/analytics           --transport http

Ви входите лише один раз. Після першого підтвердження у браузері Claude Code повторно використовує вашу сесію Wink для додаткових кінцевих точок Wink.

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

Додайте --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-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"
       }
     }
   }

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. Додайте записи серверів MCP Wink:

   ~/.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"
       }
     }
   }

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 Servers залежно від версії додатку) і натисніть Додати.

4. Введіть URL набору інструментів із каталогу вище, наприклад:

   https://api.wink.travel/mcp/extranet/rates

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

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

6. Повторіть кроки 4–5 для інших наборів інструментів, які потрібні для вашої роботи, наприклад:

   https://api.wink.travel/mcp/extranet/operations

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

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

Сервери MCP можна налаштовувати лише у десктоп-додатку. Веб-інтерфейс ChatGPT на chatgpt.com не підтримує кастомні сервери MCP.

Cursor

1. Відкрийте (або створіть) конфігураційний файл MCP Cursor:

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

2. Додайте записи серверів MCP Wink:

   ~/.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"
       }
     }
   }

3. Відкрийте Cursor. Перейдіть у Settings → Cursor Settings → MCP і переконайтеся, що обидва сервери відображаються зі статусом green. Якщо показують red, натисніть Refresh.

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

5. Відкрийте чат (Ctrl+L / Cmd+L) і попросіть Cursor показати доступні інструменти Wink, щоб підтвердити підключення.

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

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

Windsurf

1. Відкрийте (або створіть) конфігураційний файл MCP Windsurf:

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

2. Додайте записи серверів MCP Wink:

   ~/.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"
       }
     }
   }

3. Повністю перезапустіть Windsurf (Файл → Вийти, потім знову відкрийте).

4. Перейдіть у Settings → MCP Servers і переконайтеся, що обидва сервери відображаються як підключені. Windsurf відкриває вкладку браузера на https://iam.wink.travel при першому запуску.

5. Увійдіть у Wink і підтвердіть дозволи. Сервери стануть зеленими у панелі налаштувань після автентифікації.

Заувага

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

Cline (VS Code)

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

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

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

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

3. Натисніть іконку MCP Servers (іконка вилки) на панелі інструментів Cline, потім оберіть Edit MCP Settings.

4. 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"
       }
     }
   }

5. Збережіть файл. Cline автоматично перезавантажиться і відкриє вкладку браузера на https://iam.wink.travel.

6. Увійдіть у Wink і підтвердіть дозволи. Обидва сервери з’являться активними у панелі MCP Servers.

Альтернатива: додати через URL

У панелі MCP Servers натисніть Add Server і вставте URL набору інструментів, наприклад https://api.wink.travel/mcp/extranet/rates безпосередньо. Cline автоматично заповнить конфігурацію і обробить автентифікацію без ручного редагування JSON.

---

Обсяги доступу (Scopes)

Коли ви підтверджуєте екран згоди, ви побачите розподіл того, що запитує агент. MCP клієнти використовують ту ж словникову базу дозволів, що й решта платформи — дивіться повний довідник обсягів на сторінці автентифікації.

Два моменти специфічні для MCP:

• Обсяги mcp.read, mcp.write, mcp.remove додатково потрібні для відкриття MCP транспорту. Клієнт із обсягом mcp.* допускається до будь-якої кінцевої точки Wink MCP, але кожен виклик інструменту все одно застосовує обсяг секції кінцевої точки, яку він обгортає (наприклад, booking.read).
• 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 desktop: оновіть через вбудований оновлювач додатку

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/extranet-rates), а плоскі — один (/mcp/link-manager). Зверніть увагу, що неавторизований запит до будь-якого шляху під /mcp повертає 401, а не 404, тому лише 401 не означає, що кінцева точка існує.

Підключився до api.wink.travel/mcp/channel-manager і нічого не отримав

Такої кінцевої точки немає. Інтеграція 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 транспорт — лише для локальних бінарників.

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

Підтримка 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 — зміни конфігурації не завжди застосовуються без перезапуску.

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

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

Опція “Add Server” у Cline не видна

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

---

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