Сервери MCP
Інструменти MCP Wink публікуються як набори інструментів — сфокусовані кінцеві точки, кожна з яких охоплює одну задачу. Ви підключаєте свій AI-клієнт до однієї або двох, що відповідають вашій роботі, а не до всіх одразу.
Кожна кінцева точка використовує інтерактивний вхід OAuth2 (PKCE authorization code flow): ваш 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Чому інструменти розділені по кінцевих точках
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, щоб ви могли підтвердити, що з’єднання активне, перш ніж просити виконати реальну роботу.
Агентські платежі
Section titled “Агентські платежі”Для повного потоку бронювання мандрівника підключіть 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 або 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 або публічна інформація про об’єкти. Це необов’язкові доповнення до потоку бронювання.
Починайте з одного. Додавайте інший, коли помітите, що потрібна функція відсутня — кожне підключення незалежне, і додавання одного не впливає на інші.
Як працює автентифікація
Section titled “Як працює автентифікація”Сервери MCP Wink використовують потік OAuth2 Authorization Code + PKCE і підтримують Dynamic Client Registration (RFC 7591). Ось що відбувається при першому підключенні:
- Ваш AI-клієнт знаходить сервер авторизації через метадані
/.well-known/oauth-protected-resourceкінцевої точки MCP. - Клієнт реєструється автоматично через Dynamic Client Registration — ручне налаштування додатку не потрібне.
- Клієнт відкриває вкладку браузера на
https://iam.wink.travel. Ви входите у свій акаунт Wink і погоджуєтеся з запитуваними дозволами на екрані згоди. - Wink видає токен доступу, прив’язаний до вашого акаунта та ідентичності.
- AI-клієнт додає токен до кожного запиту MCP. Всі результати інструментів автоматично обмежені вашою керуючою організацією.
- Токени діють 3 години. Ваш AI-клієнт оновлює їх у фоновому режимі без повторного запиту.
Кожен виклик інструменту виконується під вашим ідентифікатором — ті ж правила ACL, що захищають веб-портал, застосовуються до AI-агента.
Підключіть свій AI-клієнт
Section titled “Підключіть свій AI-клієнт”Додайте кожен набір інструментів у Claude як власний конектор. Немає конфігураційних файлів для редагування і не потрібно створювати додаток чи секрет.
-
У Claude відкрийте Customize › Connectors, натисніть Add, потім Add custom connector.
-
Введіть Name (наприклад Wink Link manager) і як MCP server URL — набір інструментів із каталогу вище, наприклад:
https://api.wink.travel/mcp/link-managerНатисніть Continue.
-
Claude виявляє вхід Wink. Залиште Authentication: Sign in now і OAuth client: Register automatically, потім натисніть Add.
-
Натисніть Connect. Відкриється сторінка входу Wink на
https://iam.wink.travel. Увійдіть у Wink і підтвердіть дозволи на екрані згоди. -
Інструменти конектора тепер доступні у ваших чатах. Повторіть для кожного набору інструментів, який потрібен для роботи; кожен — окремий конектор.
-
Переконайтеся, що Claude Code оновлено:
Terminal window npm install -g @anthropic-ai/claude-code -
Виберіть набір інструментів із каталогу вище і додайте його. Наприклад, ціни та доступність:
Terminal window 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 (використовуйте Quit у меню — просто закрити вікно недостатньо).
-
Claude Desktop відкриває вкладку браузера для кожного нового сервера. Увійдіть у Wink і підтвердіть дозволи.
-
Іконка вилки в нижній панелі показує обидва сервери як підключені.
-
Переконайтеся, що встановлено Codex CLI:
Terminal window npm install -g @openai/codex -
Відкрийте (або створіть) конфігураційний файл Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Додайте записи серверів 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"}}} -
Запустіть Codex. При першому використанні Codex відкриває вкладку браузера на
https://iam.wink.travel. -
Увійдіть у Wink і підтвердіть запит дозволів.
-
Codex підтверджує підключення. Запустіть
codexі попросіть перелік доступних інструментів, щоб перевірити активність серверів Wink.
Підтримка серверів MCP доступна у десктоп-додатку ChatGPT для підписників Plus, Pro, Team та Enterprise.
-
Завантажте та встановіть десктоп-додаток ChatGPT, якщо ще не зробили цього.
-
Відкрийте додаток і натисніть іконку профілю у верхньому правому куті, потім виберіть Settings.
-
Перейдіть до Connectors (або MCP Servers залежно від версії додатку) і натисніть Add.
-
Введіть URL набору інструментів із каталогу вище, наприклад:
https://api.wink.travel/mcp/extranet/ratesПотім натисніть Connect.
-
ChatGPT відкриває вкладку браузера на
https://iam.wink.travel. Увійдіть у Wink і підтвердіть дозволи. -
Повторіть кроки 4–5 для інших наборів інструментів, які потрібні для роботи, наприклад:
https://api.wink.travel/mcp/extranet/operations -
Кожен набір інструментів з’явиться у списку Connectors. Почніть новий чат — інструменти Wink будуть доступні автоматично.
-
Відкрийте (або створіть) конфігураційний файл MCP Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Додайте записи серверів 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"}}} -
Відкрийте Cursor. Перейдіть у Settings → Cursor Settings → MCP і переконайтеся, що обидва сервери відображаються зі статусом green. Якщо статус червоний, натисніть Refresh.
-
Cursor відкриває вкладку браузера на
https://iam.wink.travel. Увійдіть у Wink і підтвердіть дозволи. -
Відкрийте чат (
Ctrl+L/Cmd+L) і попросіть Cursor перелічити доступні інструменти Wink, щоб підтвердити підключення.
-
Відкрийте (або створіть) конфігураційний файл MCP Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Додайте записи серверів 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"}}} -
Повністю перезапустіть Windsurf (Файл → Вийти, потім знову відкрийте).
-
Перейдіть у Settings → MCP Servers і переконайтеся, що обидва сервери відображаються як підключені. Windsurf відкриває вкладку браузера на
https://iam.wink.travelпри першому запуску. -
Увійдіть у Wink і підтвердіть дозволи. Сервери стануть зеленими у панелі налаштувань після автентифікації.
Cline — це розширення VS Code з вбудованим менеджером серверів MCP. Ручне редагування JSON не потрібне.
-
Встановіть Cline з VS Code Marketplace:
- Відкрийте VS Code і натисніть
Ctrl+Shift+X/Cmd+Shift+X - Знайдіть Cline і натисніть Install
- Відкрийте VS Code і натисніть
-
Клікніть на іконку Cline у панелі активності (ліва бічна панель), щоб відкрити панель Cline.
-
Клікніть на іконку MCP Servers (іконка вилки) у панелі інструментів Cline, потім виберіть 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)
Section titled “Обсяги доступу (Scopes)”Коли ви погоджуєтеся на екрані згоди, ви побачите перелік запитуваних агентом дозволів. 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 не заважає інструментам там застосовувати власні обсяги. Авторизація визначається для кожного виклику інструменту на основі вашого токена і прав акаунта.
Вирішення проблем
Section titled “Вирішення проблем”Вкладка браузера не відкривається
Ваш 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 Codeclaude mcp remove wink-ratesclaude 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
