Servere MCP

Wink oferă două servere MCP autentificate. Ambele folosesc autentificare interactivă OAuth2 (fluxul codului de autorizare PKCE) — agentul tău AI deschide o filă de browser pentru a te autentifica cu contul Wink. Nu sunt necesare secrete client de gestionat.

Server	URL	Ce face
Inventory API	https://api.wink.travel/mcp	Inventar, rezervări, tarife, canale de vânzare, analize și toate operațiunile platformei
Integrations	https://integrations.wink.travel/mcp	Integrări cu manageri de canale — sincronizează proprietăți, tarife și disponibilitate cu OTA-uri

---

Cum funcționează autentificarea

Serverele MCP Wink folosesc fluxul OAuth2 Authorization Code + PKCE și suportă Dynamic Client Registration (RFC 7591). Iată ce se întâmplă când te conectezi prima dată:

1. Clientul tău AI descoperă serverul de autorizare din metadatele endpoint-ului MCP /.well-known/oauth-protected-resource.
2. Clientul se înregistrează singur prin Dynamic Client Registration — nu este necesară configurare manuală a aplicației.
3. Clientul deschide o filă de browser către https://iam.wink.travel. Te autentifici cu contul Wink și aprobi permisiunile solicitate pe ecranul de consimțământ.
4. Wink emite un token de acces legat de contul și identitatea ta.
5. Clientul AI atașează tokenul la fiecare cerere MCP. Toate rezultatele uneltelor sunt automat limitate la entitatea ta de administrare.
6. Tokenurile expiră după 3 ore. Clientul AI le reîmprospătează silențios în fundal fără a cere din nou autentificare.

Fiecare apel de unealtă rulează sub identitatea ta — aceleași reguli ACL care protejează portalul web se aplică și agentului AI.

---

Conectează clientul tău AI

Claude Code

1. Asigură-te că Claude Code este actualizat:

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

2. Adaugă serverul Wink Inventory MCP:

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

3. Claude Code contactează serverul, descoperă serverul de autorizare și deschide browserul implicit.

4. Autentifică-te în Wink și aprobă cererea de permisiuni pe ecranul de consimțământ.

5. Claude Code confirmă conexiunea. Tastează /mcp pentru a verifica dacă serverul apare și uneltele s-au încărcat.

Pentru a adăuga și serverul Integrations:

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

Distribuie cu echipa ta

Adaugă --scope project la claude mcp add și Claude Code va scrie URL-ul serverului în .mcp.json la rădăcina repo-ului. Comite acel fișier — fiecare membru al echipei își va finaliza autentificarea în browser prima dată când se conectează.

Claude Desktop

1. Editează fișierul de configurare 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. Adaugă intrările serverelor 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. Închide complet și repornește Claude Desktop (folosește Quit din bara de meniu — închiderea ferestrei nu este suficientă).

4. Claude Desktop deschide o filă de browser pentru fiecare server nou. Autentifică-te în Wink și aprobă permisiunile.

5. Pictograma de priză din bara de jos arată ambele servere ca fiind conectate.

OpenAI Codex

1. Asigură-te că Codex CLI este instalat:

   npm install -g @openai/codex

2. Deschide (sau creează) fișierul de configurare Codex:

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

3. Adaugă intrările serverelor Wink MCP:

   ~/.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. Pornește Codex. La prima utilizare, Codex deschide o filă de browser către https://iam.wink.travel.

5. Autentifică-te în Wink și aprobă permisiunile solicitate.

6. Codex confirmă conexiunea. Rulează codex și cere să listeze uneltele disponibile pentru a verifica dacă serverele Wink sunt active.

Mențiune

Suportul MCP în Codex CLI necesită versiunea 1.0 sau mai recentă. Rulează codex --version pentru a verifica și npm install -g @openai/codex pentru a face upgrade.

ChatGPT

Suportul pentru servere MCP este disponibil în aplicația desktop ChatGPT pentru abonații Plus, Pro, Team și Enterprise.

1. Descarcă și instalează aplicația desktop ChatGPT dacă nu ai făcut-o deja.

2. Deschide aplicația și fă clic pe pictograma profilului tău din colțul dreapta sus, apoi alege Setări.

3. Mergi la Conectori (sau Servere MCP în funcție de versiunea aplicației) și fă clic pe Adaugă.

4. Introdu URL-ul serverului Wink Inventory:

   https://api.wink.travel/mcp

   Apoi fă clic pe Conectează.

5. ChatGPT deschide o filă de browser către https://iam.wink.travel. Autentifică-te în Wink și aprobă permisiunile.

6. Repetă pașii 4–5 pentru serverul Integrations:

   https://integrations.wink.travel/mcp

7. Ambele servere apar în lista ta de Conectori. Începe o conversație nouă — uneltele Wink sunt disponibile automat.

Limitare aplicație web

Serverele MCP pot fi configurate doar în aplicația desktop. Interfața web ChatGPT la chatgpt.com nu suportă servere MCP personalizate.

Cursor

1. Deschide (sau creează) fișierul de configurare Cursor MCP:

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

2. Adaugă intrările serverelor Wink MCP:

   ~/.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. Deschide Cursor. Mergi la Setări → Setări Cursor → MCP și confirmă că ambele servere apar cu indicator verde de stare. Dacă apar roșu, fă clic pe Reîmprospătează.

4. Cursor deschide o filă de browser către https://iam.wink.travel. Autentifică-te în Wink și aprobă permisiunile.

5. Deschide o conversație (Ctrl+L / Cmd+L) și cere lui Cursor să listeze uneltele Wink disponibile pentru a confirma conexiunea.

Config specific proiectului

Poți plasa și un fișier mcp.json la rădăcina proiectului în loc de ~/.cursor/. Configurația la nivel de proiect are prioritate și face serverele disponibile pentru fiecare membru al echipei care deschide proiectul în Cursor.

Windsurf

1. Deschide (sau creează) fișierul de configurare Windsurf MCP:

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

2. Adaugă intrările serverelor Wink MCP:

   ~/.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. Repornește complet Windsurf (Fișier → Ieșire, apoi redeschide).

4. Mergi la Setări → Servere MCP și verifică dacă ambele servere apar ca fiind conectate. Windsurf deschide o filă de browser către https://iam.wink.travel la prima utilizare.

5. Autentifică-te în Wink și aprobă permisiunile. Serverele devin verzi în panoul de setări după autentificare.

Mențiune

Suportul MCP în Windsurf necesită versiunea 1.4 sau mai recentă. Verifică prin Ajutor → Despre Windsurf și actualizează de pe site-ul Windsurf dacă este nevoie.

Cline (VS Code)

Cline este o extensie VS Code cu manager integrat de servere MCP. Nu este necesară editarea manuală a JSON-ului.

1. Instalează Cline din Marketplace-ul VS Code:

   • Deschide VS Code și apasă Ctrl+Shift+X / Cmd+Shift+X
   • Caută Cline și fă clic pe Instalează

2. Fă clic pe pictograma Cline din bara de activități (bara laterală stângă) pentru a deschide panoul Cline.

3. Fă clic pe pictograma Servere MCP (pictograma priză) din bara de instrumente Cline, apoi alege Editează setările MCP.

4. VS Code deschide cline_mcp_settings.json. Adaugă intrările 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. Salvează fișierul. Cline se reîncarcă automat și deschide o filă de browser către https://iam.wink.travel.

6. Autentifică-te în Wink și aprobă permisiunile. Ambele servere apar ca active în panoul Servere MCP.

Alternativ: adaugă prin URL

În panoul Servere MCP, fă clic pe Adaugă server și lipește direct https://api.wink.travel/mcp. Cline completează automat configurația și gestionează autentificarea fără a edita JSON manual.

---

Scopuri

Când aprobi ecranul de consimțământ vei vedea o defalcare a ceea ce solicită agentul. Clienții MCP folosesc aceeași vocabular de permisiuni ca restul platformei — vezi referința completă aici pe pagina de Autentificare.

Două lucruri sunt specifice MCP:

• Scopurile mcp.read, mcp.write și mcp.remove sunt suplimentar necesare pentru a deschide transportul MCP. Un client care deține un scop mcp.* este admis la /mcp, dar fiecare unealtă pe care o invocă aplică în continuare scopul secțiunii endpoint-ului pe care îl înfășoară (ex. booking.read).
• Clientul AI solicită doar scopurile de care are nevoie. Poți refuza permisiuni individuale pe ecranul de consimțământ — uneltele care necesită un scop refuzat vor returna o eroare când sunt invocate.

---

Depanare

Fila de browser nu se deschide

Clientul tău AI poate să nu suporte încă fluxul interactiv PKCE. Verifică dacă folosești o versiune recentă:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: actualizează din updaterul integrat al aplicației

401 Unauthorized după autentificare

Tokenul tău cache poate fi expirat. Elimină și adaugă din nou serverul pentru a declanșa o autentificare nouă:

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

Pentru Claude Desktop și ChatGPT, elimină intrarea serverului din setări, repornește aplicația și adaugă-l din nou.

403 Forbidden când apelezi o unealtă specifică

Unealta necesită un scop pe care nu l-ai aprobat pe ecranul de consimțământ. Reconectează serverul — ecranul de consimțământ va apărea din nou și poți aproba permisiunea lipsă.

Serverul apare, dar apelurile uneltei returnează “contul nu a fost găsit”

Ești autentificat cu un cont Wink care nu are o entitate de administrare. Mergi la Wink Portal și asigură-te că contul tău este configurat înainte de a folosi serverul MCP.

Tokenul expiră în timpul sesiunii

Tokenurile sunt valabile 3 ore. Claude Code și Claude Desktop reîmprospătează tokenurile silențios fără a întrerupe sesiunea. Dacă vezi erori de autentificare după o perioadă lungă de inactivitate, tastează un mesaj nou — clientul se va reautentifica automat.

Codex CLI afișează “MCP server unreachable”

Verifică dacă ~/.codex/config.json este JSON valid (fără virgule finale) și că "type": "http" este setat. Codex necesită transport HTTP pentru servere remote; transportul stdio este doar pentru binare locale.

Meniul “Connectors” din ChatGPT lipsește

Suportul MCP necesită versiunea aplicației desktop ChatGPT 1.2024.352 sau mai recentă și un abonament activ Plus, Pro, Team sau Enterprise. Actualizează aplicația și verifică planul în Setări → Cont.

Serverul Cursor apare roșu / “Failed to connect”

Verifică dacă ~/.cursor/mcp.json este JSON valid și conține "type": "http". Apoi mergi la Setări → Setări Cursor → MCP și fă clic pe Reîmprospătează. Dacă eroarea persistă, repornește complet Cursor — modificările de configurare nu sunt întotdeauna preluate fără restart.

Serverele MCP Windsurf nu apar în setări

Windsurf necesită o repornire completă (nu doar reîncărcarea ferestrei) pentru a prelua modificările din mcp_config.json. Folosește Fișier → Ieșire și redeschide aplicația. Dacă serverele încă nu apar, confirmă că folosești Windsurf 1.4+ prin Ajutor → Despre Windsurf.

Opțiunea “Add Server” din Cline nu este vizibilă

Managerul de servere MCP necesită Cline 2.0 sau mai recent. Deschide panoul Extensii VS Code, găsește Cline și fă clic pe Actualizează dacă este disponibilă o actualizare. După actualizare, reîncarcă VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Deschide Wink Portal Wink pe GitHub