MCP сървъри

Wink предоставя два автентикирани MCP сървъра. И двата използват интерактивно OAuth2 влизане (PKCE authorization code flow) — вашият AI агент отваря браузър таб, за да влезете с вашия Wink акаунт. Няма нужда от управление на client secrets.

Сървър	URL	Какво прави
Inventory API	https://api.wink.travel/mcp	Инвентар, резервации, цени, продажбени канали, анализи и всички операции на платформата
Integrations	https://integrations.wink.travel/mcp	Интеграции с channel manager — синхронизиране на имоти, цени и наличности с OTAs

---

Как работи автентикацията

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

1. Вашият AI клиент открива authorization сървъра от метаданните на MCP endpoint /.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. Добавете Wink Inventory MCP сървъра:

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

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

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

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

За да добавите и Integrations сървъра:

claude mcp add wink-integrations https://integrations.wink.travel/mcp --transport http

Споделете с вашия екип

Добавете --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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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 на Wink Inventory сървъра:

   https://api.wink.travel/mcp

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

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

6. Повторете стъпки 4–5 за Integrations сървъра:

   https://integrations.wink.travel/mcp

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

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

MCP сървърите могат да се конфигурират само в desktop приложението. Уеб интерфейсът на 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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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

6. Влезте в Wink и одобрете разрешенията. И двата сървъра се показват като активни в панела MCP Servers.

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

В панела MCP Servers кликнете Add Server и поставете директно https://api.wink.travel/mcp. Cline автоматично попълва конфигурацията и обработва автентикацията без ръчна редакция на JSON.

---

Обхвати

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

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

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

---

Отстраняване на проблеми

Браузър таб не се отваря

Вашият AI клиент може да не поддържа още интерактивния PKCE flow. Проверете дали използвате актуална версия:

• 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-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

За Claude Desktop и ChatGPT премахнете сървъра от настройките, рестартирайте приложението и го добавете отново.

403 Forbidden при извикване на конкретен инструмент

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

Сървърът се появява, но извикванията на инструменти връщат “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