Διακομιστές MCP

Η Wink παρέχει δύο πιστοποιημένους διακομιστές MCP. Και οι δύο χρησιμοποιούν διαδραστική σύνδεση OAuth2 (ροή κωδικού εξουσιοδότησης PKCE) — ο πράκτορας AI ανοίγει μια καρτέλα προγράμματος περιήγησης ώστε να συνδεθείτε με τον λογαριασμό σας Wink. Δεν χρειάζεται να διαχειρίζεστε μυστικά πελάτη.

Διακομιστής	URL	Τι κάνει
Inventory API	https://api.wink.travel/mcp	Απόθεμα, κρατήσεις, τιμές, κανάλια πωλήσεων, αναλύσεις και όλες οι λειτουργίες της πλατφόρμας
Integrations	https://integrations.wink.travel/mcp	Ενσωματώσεις διαχειριστή καναλιών — συγχρονισμός ακινήτων, τιμών και διαθεσιμότητας με OTAs

---

Πώς λειτουργεί η πιστοποίηση

Οι διακομιστές MCP της Wink χρησιμοποιούν τη ροή OAuth2 Authorization Code + PKCE και υποστηρίζουν Dynamic Client Registration (RFC 7591). Αυτό συμβαίνει όταν συνδέεστε για πρώτη φορά:

1. Ο πελάτης AI ανακαλύπτει τον διακομιστή εξουσιοδότησης από τα μεταδεδομένα /.well-known/oauth-protected-resource του endpoint MCP.
2. Ο πελάτης αυτοεγγράφεται μέσω Dynamic Client Registration — δεν απαιτείται χειροκίνητη ρύθμιση εφαρμογής.
3. Ο πελάτης ανοίγει μια καρτέλα προγράμματος περιήγησης στο https://iam.wink.travel. Συνδέεστε με τον λογαριασμό Wink και εγκρίνετε τα αιτούμενα δικαιώματα στην οθόνη συγκατάθεσης.
4. Η Wink εκδίδει ένα access token που σχετίζεται με τον λογαριασμό και την ταυτότητά σας.
5. Ο πελάτης AI επισυνάπτει το token σε κάθε αίτημα MCP. Όλα τα αποτελέσματα εργαλείων περιορίζονται αυτόματα στη διαχειριζόμενη οντότητά σας.
6. Τα tokens λήγουν μετά από 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 επικοινωνεί με τον διακομιστή, ανακαλύπτει τον διακομιστή εξουσιοδότησης και ανοίγει το προεπιλεγμένο πρόγραμμα περιήγησής σας.

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 στη ρίζα του αποθετηρίου. Κάντε commit αυτό το αρχείο — κάθε μέλος της ομάδας ολοκληρώνει τη δική του σύνδεση μέσω προγράμματος περιήγησης την πρώτη φορά που συνδέεται.

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 είναι ενεργοί.

Σημείωση

Η υποστήριξη MCP στο Codex CLI απαιτεί έκδοση 1.0 ή νεότερη. Εκτελέστε codex --version για έλεγχο και npm install -g @openai/codex για αναβάθμιση.

ChatGPT

Η υποστήριξη διακομιστών MCP είναι διαθέσιμη στην εφαρμογή ChatGPT για υπολογιστές για συνδρομητές Plus, Pro, Team και Enterprise.

1. Κατεβάστε και εγκαταστήστε την εφαρμογή ChatGPT για υπολογιστές αν δεν το έχετε ήδη κάνει.

2. Ανοίξτε την εφαρμογή και κάντε κλικ στο εικονίδιο προφίλ σας πάνω δεξιά, μετά επιλέξτε Ρυθμίσεις.

3. Μεταβείτε στα Connectors (ή MCP Servers ανάλογα με την έκδοση της εφαρμογής) και κάντε κλικ στο Προσθήκη.

4. Εισάγετε το URL του διακομιστή Wink Inventory:

   https://api.wink.travel/mcp

   Στη συνέχεια κάντε κλικ στο Σύνδεση.

5. Το ChatGPT ανοίγει μια καρτέλα προγράμματος περιήγησης στο https://iam.wink.travel. Συνδεθείτε στη Wink και εγκρίνετε τα δικαιώματα.

6. Επαναλάβετε τα βήματα 4–5 για τον διακομιστή Integrations:

   https://integrations.wink.travel/mcp

7. Και οι δύο διακομιστές εμφανίζονται στη λίστα Connectors. Ξεκινήστε μια νέα συνομιλία — τα εργαλεία Wink είναι διαθέσιμα αυτόματα.

Περιορισμός web εφαρμογής

Οι διακομιστές MCP μπορούν να ρυθμιστούν μόνο στην εφαρμογή για υπολογιστές. Η διαδικτυακή διεπαφή ChatGPT στο chatgpt.com δεν υποστηρίζει προσαρμοσμένους διακομιστές MCP.

Cursor

1. Ανοίξτε (ή δημιουργήστε) το αρχείο ρυθμίσεων MCP του Cursor:

   • 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. Μεταβείτε στις Ρυθμίσεις → Ρυθμίσεις Cursor → MCP και επιβεβαιώστε ότι και οι δύο διακομιστές εμφανίζονται με πράσινη ένδειξη κατάστασης. Αν εμφανίζονται κόκκινοι, κάντε κλικ στο Ανανέωση.

4. Το Cursor ανοίγει μια καρτέλα προγράμματος περιήγησης στο https://iam.wink.travel. Συνδεθείτε στη Wink και εγκρίνετε τα δικαιώματα.

5. Ανοίξτε μια συνομιλία (Ctrl+L / Cmd+L) και ζητήστε από το Cursor να εμφανίσει τα διαθέσιμα εργαλεία Wink για να επιβεβαιώσετε τη σύνδεση.

Ρύθμιση με εύρος έργου

Μπορείτε επίσης να τοποθετήσετε ένα αρχείο mcp.json στη ρίζα του έργου σας αντί για το ~/.cursor/. Η ρύθμιση σε επίπεδο έργου έχει προτεραιότητα και καθιστά τους διακομιστές διαθέσιμους σε κάθε μέλος της ομάδας που ανοίγει το έργο στο Cursor.

Windsurf

1. Ανοίξτε (ή δημιουργήστε) το αρχείο ρυθμίσεων MCP του Windsurf:

   • 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 (Αρχείο → Έξοδος, μετά ξανανοίξτε).

4. Μεταβείτε στις Ρυθμίσεις → MCP Servers και επιβεβαιώστε ότι και οι δύο διακομιστές εμφανίζονται ως συνδεδεμένοι. Το Windsurf ανοίγει μια καρτέλα προγράμματος περιήγησης στο https://iam.wink.travel κατά την πρώτη χρήση.

5. Συνδεθείτε στη Wink και εγκρίνετε τα δικαιώματα. Οι διακομιστές γίνονται πράσινοι στο πάνελ ρυθμίσεων μόλις πιστοποιηθείτε.

Σημείωση

Η υποστήριξη MCP στο Windsurf απαιτεί έκδοση 1.4 ή νεότερη. Ελέγξτε μέσω Βοήθεια → Σχετικά με το Windsurf και αναβαθμίστε από την ιστοσελίδα του Windsurf αν χρειάζεται.

Cline (VS Code)

Το Cline είναι μια επέκταση VS Code με ενσωματωμένο διαχειριστή διακομιστών MCP. Δεν απαιτείται χειροκίνητη επεξεργασία JSON.

1. Εγκαταστήστε το Cline από το Marketplace του VS Code:

   • Ανοίξτε το VS Code και πατήστε Ctrl+Shift+X / Cmd+Shift+X
   • Αναζητήστε Cline και κάντε κλικ στο Εγκατάσταση

2. Κάντε κλικ στο εικονίδιο Cline στη γραμμή δραστηριοτήτων (αριστερή πλαϊνή μπάρα) για να ανοίξετε το πάνελ Cline.

3. Κάντε κλικ στο εικονίδιο MCP Servers (εικονίδιο φις) στη γραμμή εργαλείων Cline, μετά επιλέξτε Επεξεργασία ρυθμίσεων MCP.

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, κάντε κλικ στο Προσθήκη διακομιστή και επικολλήστε απευθείας το https://api.wink.travel/mcp. Το Cline συμπληρώνει αυτόματα τη ρύθμιση και διαχειρίζεται την πιστοποίηση χωρίς χειροκίνητη επεξεργασία JSON.

---

Δικαιώματα (Scopes)

Όταν εγκρίνετε την οθόνη συγκατάθεσης, θα δείτε ανάλυση των αιτούμενων δικαιωμάτων από τον πράκτορα. Οι πελάτες MCP χρησιμοποιούν το ίδιο λεξιλόγιο δικαιωμάτων με την υπόλοιπη πλατφόρμα — δείτε την πλήρη αναφορά δικαιωμάτων στη σελίδα Πιστοποίησης.

Δύο πράγματα είναι ειδικά για MCP:

• Τα δικαιώματα mcp.read, mcp.write, mcp.remove απαιτούνται επιπλέον για να ανοίξει η μεταφορά MCP. Ένας πελάτης με δικαίωμα mcp.* επιτρέπεται στο /mcp, αλλά κάθε εργαλείο που καλεί εφαρμόζει το δικαίωμα του τμήματος του endpoint που καλύπτει (π.χ. booking.read).
• Ο πελάτης AI ζητά μόνο τα δικαιώματα που χρειάζεται. Μπορείτε να αρνηθείτε μεμονωμένα δικαιώματα στην οθόνη συγκατάθεσης — τα εργαλεία που απαιτούν αρνηθέν δικαίωμα θα επιστρέψουν σφάλμα κατά την κλήση.

---

Επίλυση προβλημάτων

Δεν ανοίγει καρτέλα προγράμματος περιήγησης

Ο πελάτης AI σας μπορεί να μην υποστηρίζει ακόμα τη διαδραστική ροή PKCE. Ελέγξτε ότι τρέχετε πρόσφατη έκδοση:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: αναβαθμίστε μέσω του ενσωματωμένου updater της εφαρμογής

401 Unauthorized μετά τη σύνδεση

Το αποθηκευμένο token μπορεί να είναι παλιό. Αφαιρέστε και προσθέστε ξανά τον διακομιστή για να ξεκινήσει νέα σύνδεση:

# 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.

Το token λήγει κατά τη διάρκεια της συνεδρίας

Τα tokens ισχύουν για 3 ώρες. Το Claude Code και το Claude Desktop ανανεώνουν τα tokens αθόρυβα χωρίς να διακόπτουν τη συνεδρία σας. Αν δείτε σφάλματα πιστοποίησης μετά από μεγάλη αδράνεια, πληκτρολογήστε νέο μήνυμα — ο πελάτης θα επαληθευτεί αυτόματα ξανά.

Το Codex CLI εμφανίζει “MCP server unreachable”

Ελέγξτε ότι το ~/.codex/config.json είναι έγκυρο JSON (χωρίς κόμματα στο τέλος) και ότι το "type": "http" έχει οριστεί. Το Codex απαιτεί HTTP μεταφορά για απομακρυσμένους διακομιστές· η μεταφορά stdio είναι μόνο για τοπικά binaries.

Το μενού “Connectors” του ChatGPT λείπει

Η υποστήριξη MCP απαιτεί έκδοση εφαρμογής ChatGPT για υπολογιστές 1.2024.352 ή νεότερη και ενεργή συνδρομή Plus, Pro, Team ή Enterprise. Αναβαθμίστε την εφαρμογή και ελέγξτε το πλάνο σας στις Ρυθμίσεις → Λογαριασμός.

Ο διακομιστής Cursor εμφανίζει κόκκινο / “Failed to connect”

Επιβεβαιώστε ότι το ~/.cursor/mcp.json είναι έγκυρο JSON και περιέχει "type": "http". Μεταβείτε στις Ρυθμίσεις → Ρυθμίσεις Cursor → MCP και κάντε κλικ στο Ανανέωση. Αν το σφάλμα παραμένει, επανεκκινήστε πλήρως το Cursor — οι αλλαγές ρυθμίσεων δεν εφαρμόζονται πάντα χωρίς επανεκκίνηση.

Οι διακομιστές MCP του Windsurf δεν εμφανίζονται στις ρυθμίσεις

Το Windsurf απαιτεί πλήρη επανεκκίνηση (όχι μόνο ανανέωση παραθύρου) για να φορτώσει αλλαγές στο mcp_config.json. Χρησιμοποιήστε Αρχείο → Έξοδος και ξανανοίξτε. Αν οι διακομιστές δεν εμφανίζονται, βεβαιωθείτε ότι έχετε το Windsurf 1.4+ μέσω Βοήθεια → Σχετικά με το Windsurf.

Η επιλογή “Add Server” στο Cline δεν είναι ορατή

Ο διαχειριστής διακομιστών MCP απαιτεί Cline 2.0 ή νεότερο. Ανοίξτε το πάνελ Επεκτάσεων του VS Code, βρείτε το Cline και κάντε κλικ στο Ενημέρωση αν υπάρχει διαθέσιμη. Μετά την ενημέρωση, φορτώστε ξανά το VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Άνοιγμα Wink Portal Wink στο GitHub