MCP сървъри

Инструментите на Wink MCP се публикуват като toolsets — фокусирани крайни точки, всяка покриваща една задача. Свързвате вашия 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, и някой, който създава афилиейт страници, почти не споделят инструменти. Разделянето по задача означава, че всяка връзка носи речника на една задача.

Toolsets не са права

Изборът на тесен toolset не ограничава какво може да прави вашият акаунт, а изборът на широк не дава допълнителни права. Всеки инструмент прилага същите права на акаунта като уеб портала, под вашата влязла идентичност. Ако вашият акаунт не може да анулира резервация в Wink Portal, агентът също не може — независимо към коя крайна точка е свързан.

Избирайте toolsets за фокус, не за сигурност.

---

Директория на крайните точки

Два хоста обслужват toolsets. Броят инструменти е приблизителен и се увеличава с времето.

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

Крайна точка	Инструменти	Какво покрива
/mcp/extranet/facilities	~64	Резервируем и на място инвентар: стаи и типове стаи, спа, ресторанти, конферентни зали, активности, атракции, места, други продаваеми артикули
/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 срещу управление на собствени цени

Това са различни задачи за различни хора и не споделят крайна точка.

Продавач на channel manager, PMS или CRS интегрира веднъж чрез integrations.wink.travel/mcp/channel-manager и оттам насетне обменя имоти, цени, наличности и резервации през тази интеграция. Тази единична крайна точка е цялата повърхност.

Хотелиер, който променя собствените си цени ръчно, използва extranet toolsets на api.wink.travel — /mcp/extranet/rates и сродни. Те не са част от интеграция на channel manager и интегратор няма причина да се свързва с тях.

Администрацията на акаунта също е на api.wink.travel, на /mcp/settings. Няма /mcp/settings на интеграционния хост.

Всяка крайна точка също носи инструмент ping, за да потвърдите, че връзката е активна преди да поискате реална работа.

Agentic плащания

За пълния поток на резервация от пътника, свържете Wink Booking Engine на https://api.wink.travel/mcp/booking-engine и съвместим портфейл за плащане. Добавянето на Wink MCP отваря браузър за влизане и избор на разрешения; вашият клиент след това обработва удостоверяването.

Booking Engine включва търсене на дестинация, хотел и стая, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, извличане на резервации и разписки, когато agentic резервация и плащане са активирани за тази среда. Вижте Agentic Payments за настройка на връзката, разрешенията за избор и стъпките от търсене до потвърждение.

---

Кои toolsets ми трябват?

Ако сте…	Свържете се с
Интегрирате 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 включва основния резервационен работен поток. Той предоставя откриване на акаунт и персонализация, търсене на дестинация, наличност на хотели и детайли за цени на стаи, колички, плащане и управление на резервации на пътници. Инструментите за agentic резервация и плащане също са включени, когато са активирани за тази среда.

За търсене на хотели в град използвайте destination_lookup_search_suggestions за разрешаване на дестинацията, след това inventory_search_city за намиране на налични хотели и цени. И двата инструмента са в /mcp/booking-engine, така че този поток не изисква връзка с Reference.

Добавете /mcp/reference, когато имате нужда от поддържащи справки като държави, валути и курсове на обмен, поддържани езици, часови зони, по-широки географски търсения, OTA класификации или публични знания за имоти. Това са опционални добавки към резервационния поток.

Започнете с един. Добавете друг, когато откриете, че искате нещо, което първият не може да направи — всяка връзка е независима и добавянето на една не влияе на другите.

Все още искате всичко?

https://api.wink.travel/mcp и https://integrations.wink.travel/mcp остават достъпни и обслужват всеки инструмент на своя хост. Те са полезни за разглеждане на наличното, но не ги препоръчваме за ежедневна работа: списъкът с инструменти е достатъчно голям, за да затрупа вашата задача и да влоши избора на инструменти от агента. Предпочитайте горните toolsets.

---

Как работи удостоверяването

Wink MCP сървърите използват OAuth2 Authorization Code + PKCE поток и поддържат Dynamic Client Registration (RFC 7591). Ето какво се случва при първото свързване:

1. Вашият AI клиент открива authorization server от метаданните на MCP крайната точка /.well-known/oauth-protected-resource.
2. Клиентът се регистрира сам чрез Dynamic Client Registration — не е необходима ръчна настройка на приложението.
3. Клиентът отваря браузър таб към https://iam.wink.travel. Влизате с вашия Wink акаунт и одобрявате заявените разрешения на екрана за съгласие.
4. Wink издава access token, обвързан с вашия акаунт и идентичност.
5. AI клиентът прикача токена към всяка MCP заявка. Всички резултати от инструментите автоматично са ограничени до вашия управляващ субект.
6. Токените изтичат след 3 часа. Вашият AI клиент обновява тихо във фонов режим без да иска повторно влизане.

Всяко извикване на инструмент се изпълнява под вашата идентичност — същите ACL правила, които защитават уеб портала, важат и за AI агента.

---

Свържете вашия AI клиент

Claude Code

1. Уверете се, че Claude Code е актуален:

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

2. Изберете toolset от директорията по-горе и го добавете. Например, цени и наличности:

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

3. Claude Code се свързва със сървъра, открива authorization server и отваря вашия браузър по подразбиране.

4. Влезте в Wink и одобрете заявката за разрешения на екрана за съгласие.

5. Claude Code потвърждава връзката. Въведете /mcp, за да проверите дали сървърът се появява и инструментите са заредени.

Добавете толкова toolsets, колкото вашата работа изисква — всеки е отделен запис със собствено име:

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 в корена на репото. Качете този файл — всеки член на екипа получава същите toolsets и всеки прави собствено влизане в браузъра при първото свързване.

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

   ~/.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 сървърите са активни.

Note

Поддръжката на MCP в Codex CLI изисква версия 1.0 или по-нова. Изпълнете codex --version, за да проверите, и npm install -g @openai/codex, за да обновите.

ChatGPT

Поддръжката на MCP сървъри е налична в ChatGPT desktop app за Plus, Pro, Team и Enterprise абонати.

1. Изтеглете и инсталирайте ChatGPT desktop app, ако още не сте го направили.

2. Отворете приложението и кликнете върху вашия профилен икон в горния десен ъгъл, след това изберете Settings.

3. Отидете на Connectors (или MCP Servers в зависимост от версията на приложението) и кликнете Add.

4. Въведете URL на toolset от директорията по-горе, например:

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

   След това кликнете Connect.

5. ChatGPT отваря браузър таб към https://iam.wink.travel. Влезте в Wink и одобрете разрешенията.

6. Повторете стъпки 4–5 за всеки друг toolset, който ви е необходим, например:

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

7. Всеки toolset се появява в списъка ви с Connectors. Започнете нов чат — инструментите на Wink са налични автоматично.

Ограничение на уеб приложението

MCP сървърите могат да се конфигурират само в desktop app. Уеб интерфейсът на 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-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 и потвърдете, че и двата сървъра се показват със зелен индикатор. Ако са червени, кликнете Refresh.

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-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 (File → Quit, след това отворете отново).

4. Отидете на Settings → MCP Servers и проверете дали и двата сървъра са свързани. Windsurf отваря браузър таб към https://iam.wink.travel при първа употреба.

5. Влезте в Wink и одобрете разрешенията. Сървърите стават зелени в панела с настройки след удостоверяване.

Note

Поддръжката на Windsurf MCP изисква версия 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 в Activity Bar (ляв страничен панел), за да отворите панела на 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 на toolset като https://api.wink.travel/mcp/extranet/rates директно. Cline автоматично попълва конфигурацията и обработва удостоверяването без ръчна редакция на JSON.

---

Обхвати

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

Две неща са специфични за MCP:

• Обхватите mcp.read, mcp.write, mcp.remove са допълнително изисквани за отваряне на MCP транспорта. Клиент, който има mcp.* обхват, има достъп до всяка Wink MCP крайна точка, но всеки инструмент, който извиква, все още прилага обхвата на секцията на крайната точка, която обвива (например booking.read).
• AI клиентът иска само обхватите, от които се нуждае. Можете да откажете отделни разрешения на екрана за съгласие — инструментите, които изискват отказан обхват, ще върнат грешка при извикване.

Toolsets не променят нищо от това. Крайната точка, към която се свързвате, решава кои инструменти са изброени, а не какво им е разрешено да правят. Свързването към /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 при извикване на конкретен инструмент

Инструментът изисква обхват, който не сте одобрили на екрана за съгласие, или разрешение, което акаунтът ви няма. Свържете отново сървъра — екранът за съгласие ще се появи отново и можете да одобрите липсващото разрешение. Ако все още не работи, инструментът изисква разрешение, което нямате; свързването към друг toolset няма да помогне, защото toolsets не дават права.

Инструментът, който ми трябва, не е в списъка

Вероятно сте свързани с toolset, който не покрива тази задача. Проверете директорията на крайните точки и добавете toolset, който го покрива — връзките са независими, така че добавянето на един не променя другите. Ако не сте сигурни кой го има, свържете се временно с https://api.wink.travel/mcp, намерете инструмента и после проверете кой toolset го изброява.

404 Not Found на крайна точка на toolset

Проверете пътя внимателно — вложените toolsets имат два сегмента (/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 desktop app 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 — промените в конфигурацията не винаги се засичат без рестарт.

Windsurf MCP сървърите не се показват в настройките

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