MCP Servery

Wink poskytuje dva overené MCP servery. Oba používajú interaktívne OAuth2 prihlásenie (PKCE autorizačný kódový tok) — váš AI agent otvorí kartu prehliadača, kde sa prihlásite pomocou svojho Wink účtu. Nie je potrebné spravovať žiadne klientské tajomstvá.

Server	URL	Čo robí
Inventory API	https://api.wink.travel/mcp	Inventár, rezervácie, ceny, predajné kanály, analytika a všetky operácie platformy
Integrations	https://integrations.wink.travel/mcp	Integrácie správcu kanálov — synchronizácia nehnuteľností, cien a dostupnosti s OTA

---

Ako funguje overenie

Wink MCP servery používajú OAuth2 Authorization Code + PKCE tok a podporujú Dynamic Client Registration (RFC 7591). Takto to prebieha pri prvom pripojení:

1. Váš AI klient zistí autorizačný server z metadát MCP endpointu /.well-known/oauth-protected-resource.
2. Klient sa sám zaregistruje cez Dynamic Client Registration — nie je potrebné manuálne nastavovanie aplikácie.
3. Klient otvorí kartu prehliadača na https://iam.wink.travel. Prihlásite sa pomocou Wink účtu a schválite požadované povolenia na obrazovke súhlasu.
4. Wink vydá prístupový token viazaný na váš účet a identitu.
5. AI klient pripojí token ku každej MCP požiadavke. Všetky výsledky nástrojov sú automaticky viazané na vašu spravovanú entitu.
6. Tokeny vypršia po 3 hodinách. Váš AI klient ich ticho obnovuje na pozadí bez ďalšieho vyzvania.

Každé volanie nástroja prebieha pod vašou identitou — rovnaké pravidlá ACL, ktoré chránia webové rozhranie, platia aj pre AI agenta.

---

Pripojte svoj AI klient

Claude Code

1. Uistite sa, že máte najnovšiu verziu Claude Code:

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

2. Pridajte Wink Inventory MCP server:

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

3. Claude Code kontaktuje server, zistí autorizačný server a otvorí váš predvolený prehliadač.

4. Prihláste sa do Wink a schváľte požiadavku na povolenia na obrazovke súhlasu.

5. Claude Code potvrdí pripojenie. Zadajte /mcp pre overenie, že server sa zobrazuje a jeho nástroje sú načítané.

Ak chcete pridať aj Integrations server:

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

Zdieľajte s tímom

Pridajte --scope project k príkazu claude mcp add a Claude Code zapíše URL servera do .mcp.json v koreňovom adresári repozitára. Commitnite tento súbor — každý člen tímu si pri prvom pripojení dokončí vlastné prihlásenie cez prehliadač.

Claude Desktop

1. Upravte konfiguračný súbor 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. Pridajte záznamy MCP serverov:

   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. Úplne ukončite a reštartujte Claude Desktop (použite Quit z menu — zatvorenie okna nestačí).

4. Claude Desktop otvorí kartu prehliadača pre každý nový server. Prihláste sa do Wink a schváľte povolenia.

5. Ikona zástrčky v spodnom paneli zobrazuje oba servery ako pripojené.

OpenAI Codex

1. Uistite sa, že máte nainštalovaný Codex CLI:

   npm install -g @openai/codex

2. Otvorte (alebo vytvorte) konfiguračný súbor Codex:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Pridajte záznamy MCP serverov 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. Spustite Codex. Pri prvom použití Codex otvorí kartu prehliadača na https://iam.wink.travel.

5. Prihláste sa do Wink a schváľte požadované povolenia.

6. Codex potvrdí pripojenie. Spustite codex a požiadajte o zoznam dostupných nástrojov, aby ste overili, že Wink servery sú aktívne.

Poznámka

Podpora MCP v Codex CLI vyžaduje verziu 1.0 alebo novšiu. Skontrolujte pomocou codex --version a aktualizujte príkazom npm install -g @openai/codex.

ChatGPT

Podpora MCP serverov je dostupná v ChatGPT desktop aplikácii pre predplatiteľov Plus, Pro, Team a Enterprise.

1. Stiahnite a nainštalujte ChatGPT desktop aplikáciu, ak ju ešte nemáte.

2. Otvorte aplikáciu a kliknite na ikonu svojho profilu v pravom hornom rohu, potom vyberte Nastavenia.

3. Prejdite na Konektory (alebo MCP Servery podľa verzie aplikácie) a kliknite na Pridať.

4. Zadajte URL Wink Inventory servera:

   https://api.wink.travel/mcp

   Potom kliknite na Pripojiť.

5. ChatGPT otvorí kartu prehliadača na https://iam.wink.travel. Prihláste sa do Wink a schváľte povolenia.

6. Opakujte kroky 4–5 pre Integrations server:

   https://integrations.wink.travel/mcp

7. Oba servery sa zobrazia v zozname Konektorov. Začnite nový chat — Wink nástroje sú automaticky dostupné.

Obmedzenie webovej aplikácie

MCP servery je možné konfigurovať iba v desktop aplikácii. Webové rozhranie ChatGPT na chatgpt.com nepodporuje vlastné MCP servery.

Cursor

1. Otvorte (alebo vytvorte) konfiguračný súbor Cursor MCP:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Pridajte záznamy MCP serverov 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. Otvorte Cursor. Prejdite na Nastavenia → Nastavenia Cursor → MCP a overte, že oba servery majú zelený stav. Ak sú červené, kliknite na Obnoviť.

4. Cursor otvorí kartu prehliadača na https://iam.wink.travel. Prihláste sa do Wink a schváľte povolenia.

5. Otvorte chat (Ctrl+L / Cmd+L) a požiadajte Cursor o zoznam dostupných Wink nástrojov na potvrdenie pripojenia.

Konfigurácia viazaná na projekt

Môžete tiež umiestniť súbor mcp.json do koreňa svojho projektu namiesto ~/.cursor/. Konfigurácia na úrovni projektu má prednosť a sprístupní servery každému členovi tímu, ktorý projekt otvorí v Cursor.

Windsurf

1. Otvorte (alebo vytvorte) konfiguračný súbor Windsurf MCP:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Pridajte záznamy MCP serverov 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. Úplne reštartujte Windsurf (Súbor → Ukončiť, potom znova otvorte).

4. Prejdite na Nastavenia → MCP Servery a overte, že oba servery sú pripojené. Windsurf pri prvom použití otvorí kartu prehliadača na https://iam.wink.travel.

5. Prihláste sa do Wink a schváľte povolenia. Servery sa v nastaveniach zafarbia na zeleno po autentifikácii.

Poznámka

Podpora MCP vo Windsurf vyžaduje verziu 1.4 alebo novšiu. Skontrolujte cez Pomocník → O Windsurf a v prípade potreby aktualizujte zo stránky Windsurf.

Cline (VS Code)

Cline je rozšírenie pre VS Code s integrovaným správcom MCP serverov. Nie je potrebné manuálne upravovať JSON.

1. Nainštalujte Cline z VS Code Marketplace:

   • Otvorte VS Code a stlačte Ctrl+Shift+X / Cmd+Shift+X
   • Vyhľadajte Cline a kliknite na Inštalovať

2. Kliknite na ikonu Cline v paneli aktivít (ľavý bočný panel) pre otvorenie Cline panela.

3. Kliknite na ikonu MCP Servery (ikona zástrčky) v Cline paneli, potom vyberte Upraviť nastavenia MCP.

4. VS Code otvorí cline_mcp_settings.json. Pridajte Wink záznamy:

   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. Uložte súbor. Cline sa automaticky znovu načíta a otvorí kartu prehliadača na https://iam.wink.travel.

6. Prihláste sa do Wink a schváľte povolenia. Oba servery sa zobrazia ako aktívne v paneli MCP Serverov.

Alternatíva: pridanie cez URL

V paneli MCP Serverov kliknite na Pridať server a priamo vložte https://api.wink.travel/mcp. Cline automaticky vyplní konfiguráciu a spraví autentifikáciu bez manuálnej úpravy JSON.

---

Rozsahy (Scopes)

Keď schválite obrazovku súhlasu, uvidíte rozpis požadovaných oprávnení. MCP klienti používajú rovnakú slovnú zásobu povolení ako zvyšok platformy — pozrite si kompletný referenčný zoznam rozsahov na stránke Autentifikácia.

Dve špecifiká MCP:

• Rozsahy mcp.read, mcp.write, mcp.remove sú navyše potrebné na otvorenie MCP transportu. Klient s rozsahom mcp.* má prístup k /mcp, ale každý nástroj, ktorý volá, stále vyžaduje príslušný rozsah sekcie endpointu (napr. booking.read).
• AI klient žiada iba o rozsahy, ktoré potrebuje. Na obrazovke súhlasu môžete zamietnuť jednotlivé povolenia — nástroje vyžadujúce zamietnutý rozsah vrátia chybu pri volaní.

---

Riešenie problémov

Karta prehliadača sa neotvorí

Váš AI klient možno ešte nepodporuje interaktívny PKCE tok. Overte, že používate aktuálnu verziu:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: aktualizujte cez vstavaný updater aplikácie

401 Unauthorized po prihlásení

Váš uložený token môže byť neplatný. Odstráňte a znova pridajte server, aby ste spustili nové prihlásenie:

# Claude Code
claude mcp remove wink-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

Pre Claude Desktop a ChatGPT odstráňte server zo nastavení, reštartujte aplikáciu a pridajte ho znova.

403 Forbidden pri volaní konkrétneho nástroja

Nástroj vyžaduje rozsah, ktorý ste na obrazovke súhlasu neschválili. Znovu pripojte server — obrazovka súhlasu sa zobrazí znova a môžete schváliť chýbajúce povolenie.

Server sa zobrazuje, ale volania nástrojov vracajú “account not found”

Ste prihlásený do Wink účtu, ktorý nemá spravovanú entitu. Prejdite na Wink Portal a uistite sa, že váš účet je správne nastavený pred použitím MCP servera.

Token vyprší počas relácie

Tokeny sú platné 3 hodiny. Claude Code a Claude Desktop ticho obnovujú tokeny bez prerušenia relácie. Ak po dlhšom nečinnom období vidíte chyby autentifikácie, zadajte novú správu — klient sa automaticky znovu autentifikuje.

Codex CLI hlási “MCP server unreachable”

Skontrolujte, či je váš ~/.codex/config.json platný JSON (bez záverečných čiark) a či je nastavené "type": "http". Codex vyžaduje HTTP transport pre vzdialené servery; stdio transport je len pre lokálne binárky.

Menu “Connectors” v ChatGPT chýba

Podpora MCP vyžaduje verziu ChatGPT desktop aplikácie 1.2024.352 alebo novšiu a aktívne predplatné Plus, Pro, Team alebo Enterprise. Aktualizujte aplikáciu a overte svoj plán v Nastaveniach → Účet.

Cursor server zobrazuje červenú / “Failed to connect”

Overte, že váš ~/.cursor/mcp.json je platný JSON a obsahuje "type": "http". Potom prejdite na Nastavenia → Nastavenia Cursor → MCP a kliknite na Obnoviť. Ak chyba pretrváva, úplne reštartujte Cursor — zmeny konfigurácie sa nie vždy prejavia bez reštartu.

Windsurf MCP servery sa nezobrazujú v nastaveniach

Windsurf vyžaduje úplný reštart (nie len obnovenie okna) na načítanie zmien v mcp_config.json. Použite Súbor → Ukončiť a znova spustite. Ak servery stále nie sú viditeľné, overte, že máte Windsurf 1.4+ cez Pomocník → O Windsurf.

V Cline nie je viditeľná možnosť “Add Server”

Správca MCP serverov vyžaduje Cline 2.0 alebo novšiu verziu. Otvorte panel rozšírení VS Code, nájdite Cline a kliknite na Aktualizovať, ak je dostupná aktualizácia. Po aktualizácii reštartujte VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Otvoriť Wink Portal Wink na GitHub