Перейти до вмісту

Сервери 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

Чому інструменти розділені по кінцевих точках

Section titled “Чому інструменти розділені по кінцевих точках”

Wink надає близько 500 інструментів. Передавати всі одразу агенту технічно можливо — але це погана ідея.

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

Якість вибору падає зі збільшенням списку. Агент, що обирає з 500 інструментів з подібними назвами, робить гірші вибори, ніж той, хто обирає з 40. Якщо ви інтегруєте channel manager, приблизно двадцять інструментів релевантні для вас; інші 480 — це шум, що ускладнює пошук потрібного інструменту.

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


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

Section titled “Каталог кінцевих точок”

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

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

Section titled “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

Section titled “https://integrations.wink.travel — інтеграції channel manager”

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

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

Кожна кінцева точка також має інструмент 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 для налаштування підключення, вибору дозволів і кроків від пошуку до підтвердження.


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

Section titled “Які набори інструментів мені потрібні?”
Якщо ви…Підключайтеся до
Інтегруєте channel manager, PMS або CRSintegrations.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 або публічна інформація про об’єкти. Це необов’язкові доповнення до потоку бронювання.

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


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

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

Сервери 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-клієнт

Section titled “Підключіть свій AI-клієнт”

Додайте кожен набір інструментів у Claude як власний конектор. Немає конфігураційних файлів для редагування і не потрібно створювати додаток чи секрет.

  1. У Claude відкрийте Customize › Connectors, натисніть Add, потім Add custom connector.

  2. Введіть Name (наприклад Wink Link manager) і як MCP server URL — набір інструментів із каталогу вище, наприклад:

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

    Натисніть Continue.

  3. Claude виявляє вхід Wink. Залиште Authentication: Sign in now і OAuth client: Register automatically, потім натисніть Add.

  4. Натисніть Connect. Відкриється сторінка входу Wink на https://iam.wink.travel. Увійдіть у Wink і підтвердіть дозволи на екрані згоди.

  5. Інструменти конектора тепер доступні у ваших чатах. Повторіть для кожного набору інструментів, який потрібен для роботи; кожен — окремий конектор.


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

Три особливості MCP:

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

401 Unauthorized після входу

Ваш кешований токен може бути застарілим. Видаліть і додайте сервер знову, щоб викликати новий вхід:

Terminal window
# 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. Оновіть додаток і перевірте план у Settings → Account.

Сервер 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