MCP servery

Wink nabízí dva autentizované MCP servery. Oba používají interaktivní přihlášení OAuth2 (PKCE authorization code flow) — váš AI agent otevře záložku v prohlížeči, kde se přihlásíte pomocí svého Wink účtu. Žádné spravování klientských tajemství.

Server	URL	Co dělá
Inventory API	https://api.wink.travel/mcp	Inventář, rezervace, ceny, prodejní kanály, analytika a všechny operace platformy
Integrations	https://integrations.wink.travel/mcp	Integrace channel managerů — synchronizace nemovitostí, cen a dostupnosti s OTA

---

Jak funguje autentizace

Wink MCP servery používají OAuth2 Authorization Code + PKCE flow a podporují Dynamic Client Registration (RFC 7591). Při prvním připojení probíhá toto:

1. Váš AI klient zjistí autorizační server z metadat /.well-known/oauth-protected-resource na MCP endpointu.
2. Klient se sám zaregistruje přes Dynamic Client Registration — není potřeba ruční nastavení aplikace.
3. Klient otevře záložku v prohlížeči na https://iam.wink.travel. Přihlásíte se pomocí Wink účtu a schválíte požadovaná oprávnění na obrazovce souhlasu.
4. Wink vydá access token vázaný na váš účet a identitu.
5. AI klient připojuje token ke každému MCP požadavku. Všechny výsledky nástrojů jsou automaticky omezeny na vaši spravovanou entitu.
6. Tokeny expirují po 3 hodinách. Váš AI klient je tichounce obnovuje na pozadí bez dalšího vyžádání.

Každý volání nástroje běží pod vaší identitou — platí stejná pravidla ACL jako pro webové rozhraní.

---

Připojte svého AI klienta

Claude Code

1. Ujistěte se, že máte aktuální Claude Code:

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

2. Přidejte Wink Inventory MCP server:

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

3. Claude Code kontaktuje server, zjistí autorizační server a otevře váš výchozí prohlížeč.

4. Přihlaste se do Wink a schvalte požadovaná oprávnění na obrazovce souhlasu.

5. Claude Code potvrdí připojení. Zadejte /mcp pro ověření, že server je viditelný a jeho nástroje jsou načteny.

Pro přidání také Integrations serveru:

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

Sdílejte s týmem

Přidejte --scope project k příkazu claude mcp add a Claude Code zapíše URL serveru do .mcp.json v kořenovém adresáři repozitáře. Tento soubor commitněte — každý člen týmu pak při prvním připojení dokončí vlastní přihlášení v prohlížeči.

Claude Desktop

1. Upravte konfigurační soubor 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. Přidejte záznamy MCP serverů:

   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. Úplně ukončete a restartujte Claude Desktop (použijte Quit v menu — zavření okna nestačí).

4. Claude Desktop otevře pro každý nový server záložku v prohlížeči. Přihlaste se do Wink a schvalte oprávnění.

5. Ikona zástrčky v dolním panelu ukáže oba servery jako připojené.

OpenAI Codex

1. Ujistěte se, že máte nainstalovaný Codex CLI:

   npm install -g @openai/codex

2. Otevřete (nebo vytvořte) konfigurační soubor Codex:

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

3. Přidejte záznamy Wink MCP serverů:

   ~/.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. Spusťte Codex. Při prvním použití Codex otevře záložku v prohlížeči na https://iam.wink.travel.

5. Přihlaste se do Wink a schvalte požadovaná oprávnění.

6. Codex potvrdí připojení. Spusťte codex a požádejte o seznam dostupných nástrojů pro ověření, že Wink servery jsou aktivní.

Poznámka

Podpora MCP v Codex CLI vyžaduje verzi 1.0 nebo novější. Zkontrolujte příkazem codex --version a aktualizujte příkazem npm install -g @openai/codex.

ChatGPT

Podpora MCP serverů je dostupná v ChatGPT desktopové aplikaci pro předplatitele Plus, Pro, Team a Enterprise.

1. Stáhněte a nainstalujte ChatGPT desktopovou aplikaci, pokud ji ještě nemáte.

2. Otevřete aplikaci a klikněte na ikonu svého profilu v pravém horním rohu, poté vyberte Nastavení.

3. Přejděte na Konektory (nebo MCP servery podle verze aplikace) a klikněte na Přidat.

4. Zadejte URL Wink Inventory serveru:

   https://api.wink.travel/mcp

   Poté klikněte na Připojit.

5. ChatGPT otevře záložku v prohlížeči na https://iam.wink.travel. Přihlaste se do Wink a schvalte oprávnění.

6. Opakujte kroky 4–5 pro Integrations server:

   https://integrations.wink.travel/mcp

7. Oba servery se zobrazí ve vašem seznamu konektorů. Začněte nový chat — Wink nástroje jsou automaticky dostupné.

Omezení webové aplikace

MCP servery lze konfigurovat pouze v desktopové aplikaci. Webové rozhraní ChatGPT na chatgpt.com nepodporuje vlastní MCP servery.

Cursor

1. Otevřete (nebo vytvořte) konfigurační soubor Cursor MCP:

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

2. Přidejte záznamy Wink MCP serverů:

   ~/.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. Otevřete Cursor. Přejděte na Nastavení → Nastavení Cursor → MCP a ověřte, že oba servery mají zelený stav. Pokud jsou červené, klikněte na Obnovit.

4. Cursor otevře záložku v prohlížeči na https://iam.wink.travel. Přihlaste se do Wink a schvalte oprávnění.

5. Otevřete chat (Ctrl+L / Cmd+L) a požádejte Cursor o seznam dostupných Wink nástrojů pro potvrzení připojení.

Konfigurace na úrovni projektu

Můžete také umístit soubor mcp.json do kořenového adresáře projektu místo do ~/.cursor/. Konfigurace na úrovni projektu má přednost a zpřístupní servery všem členům týmu, kteří projekt v Cursor otevřou.

Windsurf

1. Otevřete (nebo vytvořte) konfigurační soubor Windsurf MCP:

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

2. Přidejte záznamy Wink MCP serverů:

   ~/.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. Úplně restartujte Windsurf (Soubor → Ukončit, pak znovu otevřete).

4. Přejděte na Nastavení → MCP servery a ověřte, že oba servery jsou připojené. Windsurf při prvním použití otevře záložku v prohlížeči na https://iam.wink.travel.

5. Přihlaste se do Wink a schvalte oprávnění. Servery se v nastavení označí zeleně po autentizaci.

Poznámka

Podpora MCP ve Windsurf vyžaduje verzi 1.4 nebo novější. Zkontrolujte přes Nápověda → O Windsurf a případně aktualizujte z webu Windsurf.

Cline (VS Code)

Cline je rozšíření pro VS Code s vestavěným správcem MCP serverů. Ruční úprava JSON není potřeba.

1. Nainstalujte Cline z VS Code Marketplace:

   • Otevřete VS Code a stiskněte Ctrl+Shift+X / Cmd+Shift+X
   • Vyhledejte Cline a klikněte na Instalovat

2. Klikněte na ikonu Cline v Activity Bar (levý panel) pro otevření panelu Cline.

3. Klikněte na ikonu MCP serverů (ikona zástrčky) v nástrojové liště Cline, pak vyberte Upravit nastavení MCP.

4. VS Code otevře cline_mcp_settings.json. Přidejte 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 soubor. Cline se automaticky znovu načte a otevře záložku v prohlížeči na https://iam.wink.travel.

6. Přihlaste se do Wink a schvalte oprávnění. Oba servery se zobrazí jako aktivní v panelu MCP serverů.

Alternativa: přidání přes URL

V panelu MCP serverů klikněte na Přidat server a vložte přímo https://api.wink.travel/mcp. Cline automaticky vyplní konfiguraci a vyřídí autentizaci bez ruční úpravy JSON.

---

Scope

Při schvalování na obrazovce souhlasu uvidíte rozpis požadovaných oprávnění. MCP klienti používají stejnou slovní zásobu oprávnění jako zbytek platformy — viz kompletní referenční seznam scope na stránce Autentizace.

Dvě věci jsou specifické pro MCP:

• Scope mcp.read, mcp.write, mcp.remove jsou navíc vyžadovány pro otevření MCP transportu. Klient s mcp.* scope má přístup k /mcp, ale každý nástroj, který volá, stále vyžaduje scope sekce endpointu, který obaluje (např. booking.read).
• AI klient žádá pouze o scope, které potřebuje. Na obrazovce souhlasu můžete jednotlivá oprávnění zamítnout — nástroje vyžadující zamítnutý scope vrátí chybu při volání.

---

Řešení problémů

Neotevře se záložka v prohlížeči

Váš AI klient možná ještě nepodporuje interaktivní PKCE flow. Ověřte, že používáte aktuální verzi:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: aktualizujte přes vestavěný updater aplikace

401 Unauthorized po přihlášení

Vaše uložené tokeny mohou být zastaralé. Odstraňte a znovu přidejte server pro vyvolání nového přihlášení:

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

U Claude Desktop a ChatGPT odstraňte server v nastavení, restartujte aplikaci a přidejte ho znovu.

403 Forbidden při volání konkrétního nástroje

Nástroj vyžaduje scope, které jste na obrazovce souhlasu neschválili. Znovu připojte server — obrazovka souhlasu se znovu zobrazí a můžete chybějící oprávnění schválit.

Server je vidět, ale volání nástrojů vrací “account not found”

Jste přihlášeni do Wink účtu, který nemá spravovanou entitu. Přejděte na Wink Portal a ujistěte se, že je váš účet správně nastaven před použitím MCP serveru.

Token vyprší během relace

Tokeny platí 3 hodiny. Claude Code a Claude Desktop obnovují tokeny tiše na pozadí bez přerušení relace. Pokud po delší nečinnosti vidíte chyby autentizace, napište novou zprávu — klient se automaticky znovu autentizuje.

Codex CLI hlásí “MCP server unreachable”

Zkontrolujte, že váš ~/.codex/config.json je validní JSON (bez koncových čárek) a že "type": "http" je nastaveno. Codex vyžaduje HTTP transport pro vzdálené servery; stdio transport je pouze pro lokální binárky.

V menu ChatGPT chybí “Connectors”

Podpora MCP vyžaduje desktopovou aplikaci ChatGPT verze 1.2024.352 nebo novější a aktivní předplatné Plus, Pro, Team nebo Enterprise. Aktualizujte aplikaci a ověřte svůj plán v Nastavení → Účet.

Cursor server ukazuje červeně / “Failed to connect”

Ověřte, že váš ~/.cursor/mcp.json je validní JSON a obsahuje "type": "http". Pak přejděte na Nastavení → Nastavení Cursor → MCP a klikněte na Obnovit. Pokud chyba přetrvává, Cursor úplně restartujte — změny konfigurace se bez restartu nemusí načíst.

Windsurf MCP servery nejsou v nastavení

Windsurf vyžaduje úplný restart (nejen reload okna) pro načtení změn v mcp_config.json. Použijte Soubor → Ukončit a znovu spusťte. Pokud servery stále nejsou vidět, ověřte, že máte Windsurf verzi 1.4+ přes Nápověda → O Windsurf.

V Cline není viditelná volba “Add Server”

Správce MCP serverů vyžaduje Cline verzi 2.0 nebo novější. Otevřete panel rozšíření VS Code, najděte Cline a klikněte na Aktualizovat, pokud je dostupná aktualizace. Po aktualizaci restartujte VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Otevřít Wink Portal Wink na GitHubu