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, за да потвърдите, че връзката е активна преди да поискате реална работа.

---

Кои 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
Създавате резервационен опит	/mcp/booking-engine + /mcp/reference

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

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

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 сървъра от метаданните на 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 сървъра и отваря вашия браузър.

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. Добавете 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 сървърите са активни.

Note

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

ChatGPT

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

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

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 сървърите могат да се конфигурират само в десктоп приложението. Уеб интерфейсът на ChatGPT на chatgpt.com не поддържа персонализирани MCP сървъри.

Cursor

1. Отворете (или създайте) конфигурационния файл на Cursor MCP:

   • 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 и потвърдете, че и двата сървъра се показват със зелен индикатор. Ако са червени, кликнете 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. Добавете 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 (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 десктоп приложението 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