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

Τα εργαλεία MCP της Wink δημοσιεύονται ως σύνολα εργαλείων — εστιασμένα endpoints, το καθένα καλύπτοντας μία εργασία. Συνδέετε τον πελάτη AI σας σε ένα ή δύο που ταιριάζουν στην εργασία σας, όχι σε όλα.

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

Ένας ενσωματωτής διαχειριστή καναλιών συνδέεται σε ένα endpoint

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

Ένας ξενοδόχος που διαχειρίζεται τις δικές του τιμές συνδέεται σε άλλο

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

---

Γιατί τα εργαλεία χωρίζονται σε endpoints

Η Wink εκθέτει περίπου 500 εργαλεία. Η παράδοση όλων μαζί σε έναν πράκτορα είναι τεχνικά εφικτή — αλλά κακή ιδέα.

Οι ορισμοί εργαλείων κοστίζουν πλαίσιο. Κάθε εργαλείο που διαφημίζει ένας διακομιστής MCP φορτώνεται στο παράθυρο πλαισίου του μοντέλου πριν κάνει οποιαδήποτε εργασία, μαζί με την περιγραφή και το πλήρες σχήμα παραμέτρων του. Πεντακόσια από αυτά καταναλώνουν μεγάλο μέρος του προϋπολογισμού που χρειάζεται η πραγματική σας εργασία, σε κάθε αίτημα.

Η ποιότητα επιλογής μειώνεται καθώς η λίστα μεγαλώνει. Ένας πράκτορας που επιλέγει από 500 εργαλεία με παρόμοια ονόματα κάνει χειρότερες επιλογές από έναν που επιλέγει από 40. Αν ενσωματώσετε έναν διαχειριστή καναλιών, περίπου είκοσι εργαλεία είναι σχετικά για εσάς· τα υπόλοιπα 480 είναι θόρυβος που δυσκολεύει την εύρεση του σωστού εργαλείου.

Η εργασία είναι πραγματικά διαχωρίσιμη. Κάποιος που συγχρονίζει διαθεσιμότητα από PMS και κάποιος που επιμελείται σελίδες συνεργατών μοιράζονται σχεδόν κανένα εργαλείο. Ο διαχωρισμός κατά εργασία σημαίνει ότι κάθε σύνδεση φέρει το λεξιλόγιο μιας εργασίας.

Τα σύνολα εργαλείων δεν είναι δικαιώματα

Η επιλογή ενός στενού συνόλου εργαλείων δεν περιορίζει το τι μπορεί να κάνει ο λογαριασμός σας, και η επιλογή ενός ευρέος δεν παρέχει κάτι επιπλέον. Κάθε εργαλείο εφαρμόζει τα ίδια δικαιώματα λογαριασμού με την πύλη ιστού, υπό την ταυτότητά σας που έχετε συνδεθεί. Αν ο λογαριασμός σας δεν μπορεί να ακυρώσει μια κράτηση στην Πύλη Wink, ούτε ο πράκτορας μπορεί — ανεξάρτητα από το σε ποιο endpoint είναι συνδεδεμένος.

Επιλέξτε σύνολα εργαλείων για εστίαση, όχι για ασφάλεια.

---

Κατάλογος endpoints

Δύο hosts εξυπηρετούν σύνολα εργαλείων. Οι μετρήσεις εργαλείων είναι κατά προσέγγιση και αυξάνονται με τον χρόνο.

https://api.wink.travel — η πλατφόρμα

Endpoint	Εργαλεία	Τι καλύπτει
/mcp/extranet/facilities	~64	Το διαθέσιμο και επιτόπιο απόθεμα: δωμάτια και τύποι δωματίων, spa, εστιατόρια, αίθουσες συσκέψεων, δραστηριότητες, αξιοθέατα, μέρη, άλλα προς πώληση είδη
/mcp/extranet/property	~62	Το αρχείο ιδιοκτησίας και οι εμπορικοί όροι: προφίλ και περιεχόμενο, πρόσθετα, πολιτικές ακύρωσης, προνόμια, ανακοινώσεις
/mcp/settings	~60	Διαχείριση λογαριασμού: προφίλ και branding διαχειριζόμενης οντότητας, διαχειριστές και δικαιώματα, προσαρμογές, webhooks, προτιμήσεις ειδοποιήσεων
/mcp/studio/embeds	~48	Δημοσίευση επιμελημένου αποθέματος: widgets, πλέγματα και ταξινομημένα πλέγματα, κάρτες, χάρτες, σύνδεσμοι σε σελίδες αποθέματος και προμηθευτών
/mcp/extranet/rates	~44	Τιμές και διαθεσιμότητα: περίοδοι τιμών και ποσοστώσεις αποθέματος, σχέδια τιμών, κύριες τιμές, ειδικές και προωθητικές τιμές
/mcp/extranet/operations	~39	Λειτουργία ζωντανής ιδιοκτησίας: κρατήσεις και ο κύκλος ζωής τους, κριτικές επισκεπτών και απαντήσεις, ροές ημερολογίου, προγραμματισμένες εργασίες
/mcp/extranet/distribution	~37	Πού πωλείται το απόθεμα: κανάλια πωλήσεων και τροποποιητές τιμών, αιτήματα συνεργασίας και προμηθευτών, εγγραφή, συλλογή leads
/mcp/studio/curation	~35	Δημιουργία συλλογών προς εμπορία: στατικές και δυναμικές λίστες, ταξινομημένες λίστες, αποθηκευμένες αναζητήσεις, συγκεντρωτικά στοιχεία ιδιοκτησίας
/mcp/link-manager	~28	Συλλογές συνδέσμων syndication, ο σχεδιασμός τους, κατηγορίες και ετικέτες, συντομευμένα URLs
/mcp/reference	~24	Δεδομένα μόνο για ανάγνωση: χώρες, νομίσματα και συναλλαγματικές ισοτιμίες, γλώσσες, ζώνες ώρας, γεωγραφικές αναζητήσεις, γεωτοποθεσία IP
/mcp/analytics	~18	Αναλύσεις κρατήσεων και εσόδων: επισκοπήσεις, γραφήματα, πίνακες κατάταξης, απόδοση συνεργατών, μετρήσεις μεριδίου
/mcp/payment	~18	Χρηματοοικονομικές λειτουργίες: καθολικό, αναλήψεις και εκτιμήσεις τελών, συγκεντρωτικά ποσά κρατήσεων
/mcp/booking-engine	~17	Η διαδρομή αγορών για τον ταξιδιώτη: αναζήτηση και εύρεση, καλάθι αγορών και ολοκλήρωση, λίστες επιθυμιών, προσαρμογή καμπάνιας
/mcp/social	~17	Συνδεδεμένοι κοινωνικοί λογαριασμοί, δημοσίευση και προγραμματισμός αναρτήσεων, ανάγνωση στατιστικών αναρτήσεων
/mcp/travel-agent	~8	Κρατήσεις μέσω πράκτορα για λογαριασμό ταξιδιωτών, και αναφορές πρακτόρων

https://integrations.wink.travel — ενσωματώσεις διαχειριστή καναλιών

Ένα endpoint, γιατί αυτός ο host υπάρχει για μία εργασία.

Endpoint	Εργαλεία	Τι καλύπτει
/mcp/channel-manager	~9	Σύνδεση και επαλήθευση ενσωμάτωσης διαχειριστή καναλιών, PMS ή CRS

Ενσωμάτωση διαχειριστή καναλιών έναντι διαχείρισης δικών σας τιμών

Αυτές είναι διαφορετικές εργασίες για διαφορετικούς ανθρώπους, και δεν μοιράζονται endpoint.

Ένας πωλητής διαχειριστή καναλιών, PMS ή CRS ενσωματώνεται μία φορά μέσω integrations.wink.travel/mcp/channel-manager, και από εκεί και πέρα ανταλλάσσει ιδιοκτησίες, τιμές, διαθεσιμότητα και κρατήσεις μέσω αυτής της ενσωμάτωσης. Αυτό το μοναδικό endpoint είναι όλη η επιφάνεια.

Ένας ξενοδόχος που αλλάζει τις δικές του τιμές χειροκίνητα χρησιμοποιεί τα σύνολα εργαλείων extranet στο api.wink.travel — /mcp/extranet/rates και συναφή. Αυτά δεν είναι μέρος ενσωμάτωσης διαχειριστή καναλιών και ένας ενσωματωτής δεν έχει λόγο να συνδεθεί σε αυτά.

Η διαχείριση λογαριασμού είναι επίσης στο api.wink.travel, στο /mcp/settings. Δεν υπάρχει /mcp/settings στον host ενσωματώσεων.

Κάθε endpoint φέρει επίσης ένα εργαλείο ping, ώστε να επιβεβαιώνετε ότι η σύνδεση είναι ενεργή πριν ζητήσετε πραγματική εργασία.

Πληρωμές μέσω πράκτορα

Για την πλήρη ροή κράτησης ταξιδιώτη, συνδέστε το Wink Booking Engine στο https://api.wink.travel/mcp/booking-engine και ένα συμβατό πορτοφόλι πληρωμών. Η προσθήκη του Wink MCP ανοίγει τη σύνδεση μέσω προγράμματος περιήγησης και επιλογή δικαιωμάτων· ο πελάτης σας χειρίζεται στη συνέχεια την αυθεντικοποίηση.

Το Booking Engine περιλαμβάνει εύρεση προορισμού, αναζήτηση ξενοδοχείων και δωματίων, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, ανάκτηση κρατήσεων και αποδείξεις, όταν οι πληρωμές και κρατήσεις μέσω πράκτορα είναι ενεργοποιημένες για το περιβάλλον. Δείτε Agentic Payments για ρύθμιση σύνδεσης, τα δικαιώματα που πρέπει να επιλέξετε και τα βήματα από την αναζήτηση μέχρι την επιβεβαίωση.

---

Ποια σύνολα εργαλείων χρειάζομαι;

Αν είστε…	Συνδεθείτε σε
Ενσωματώνετε διαχειριστή καναλιών, PMS ή CRS	integrations.wink.travel/mcp/channel-manager — μόνο αυτό
Διαχειρίζεστε το περιεχόμενο μιας ιδιοκτησίας	/mcp/extranet/property + /mcp/extranet/facilities
Διαχειρίζεστε δωμάτια και τύπους δωματίων	/mcp/extranet/facilities
Διαχειρίζεστε τιμές και διαθεσιμότητα	/mcp/extranet/rates
Διαχειρίζεστε καθημερινές κρατήσεις	/mcp/extranet/operations
Αναπτύσσετε τη διανομή	/mcp/extranet/distribution + /mcp/analytics
Δημιουργείτε σελίδες συνεργατών	/mcp/studio/curation + /mcp/studio/embeds
Διαχειρίζεστε σελίδες link-in-bio	/mcp/link-manager + /mcp/social
Κάνετε κρατήσεις για λογαριασμό ταξιδιωτών	/mcp/travel-agent
Εξοφλείτε χρήματα	/mcp/payment
Κάνετε κράτηση δωματίου με πράκτορα AI	/mcp/booking-engine + συμβατό πορτοφόλι πληρωμών — δείτε Agentic Payments
Δημιουργείτε εμπειρία κράτησης	/mcp/booking-engine; προαιρετικά /mcp/reference για επιπλέον αναζητήσεις

Το Booking Engine περιλαμβάνει τη βασική ροή κράτησης. Παρέχει ανακάλυψη λογαριασμού και προσαρμογής, εύρεση προορισμού, διαθεσιμότητα ξενοδοχείων και λεπτομέρειες τιμών δωματίων, καλάθια αγορών, ολοκλήρωση και διαχείριση κρατήσεων ταξιδιωτών. Εργαλεία κράτησης και πληρωμής μέσω πράκτορα περιλαμβάνονται επίσης όταν είναι ενεργοποιημένα για το περιβάλλον.

Για αναζήτηση ξενοδοχείου σε πόλη, χρησιμοποιήστε destination_lookup_search_suggestions για να επιλύσετε τον προορισμό, μετά inventory_search_city για να βρείτε διαθέσιμα ξενοδοχεία και τιμές. Και τα δύο εργαλεία είναι στο /mcp/booking-engine, οπότε αυτή η ροή δεν απαιτεί σύνδεση Reference.

Προσθέστε /mcp/reference όταν χρειάζεστε υποστηρικτικές αναζητήσεις όπως χώρες, νομίσματα και συναλλαγματικές ισοτιμίες, υποστηριζόμενες γλώσσες, ζώνες ώρας, ευρύτερες γεωγραφικές αναζητήσεις, ταξινομήσεις OTA ή δημόσια γνώση ιδιοκτησίας. Αυτά είναι προαιρετικές προσθήκες στη ροή κράτησης.

Ξεκινήστε με ένα. Προσθέστε άλλο όταν βρείτε ότι ζητάτε κάτι που δεν μπορεί να κάνει — κάθε σύνδεση είναι ανεξάρτητη, και η προσθήκη ενός δεν επηρεάζει τα άλλα.

Θέλετε ακόμα τα πάντα;

https://api.wink.travel/mcp και https://integrations.wink.travel/mcp παραμένουν διαθέσιμα και εξυπηρετούν όλα τα εργαλεία στον host τους. Είναι χρήσιμα για εξερεύνηση, αλλά δεν τα προτείνουμε για καθημερινή εργασία: η λίστα εργαλείων είναι αρκετά μεγάλη ώστε να επισκιάζει την εργασία σας και να υποβαθμίζει την επιλογή εργαλείων του πράκτορα. Προτιμήστε τα παραπάνω σύνολα εργαλείων.

---

Πώς λειτουργεί η αυθεντικοποίηση

Οι διακομιστές 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 εκδίδει ένα 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. Επιλέξτε ένα σύνολο εργαλείων από τον κατάλογο παραπάνω και προσθέστε το. Για παράδειγμα, τιμές και διαθεσιμότητα:

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

3. Το Claude Code επικοινωνεί με τον διακομιστή, ανακαλύπτει τον διακομιστή εξουσιοδότησης και ανοίγει το προεπιλεγμένο πρόγραμμα περιήγησής σας.

4. Συνδεθείτε στο Wink και εγκρίνετε το αίτημα δικαιωμάτων στην οθόνη συγκατάθεσης.

5. Το Claude Code επιβεβαιώνει τη σύνδεση. Πληκτρολογήστε /mcp για να επαληθεύσετε ότι ο διακομιστής εμφανίζεται και τα εργαλεία του έχουν φορτωθεί.

Προσθέστε όσα σύνολα εργαλείων χρειάζεται η εργασία σας — το καθένα είναι ξεχωριστή καταχώρηση διακομιστή με το δικό του όνομα:

claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics  https://api.wink.travel/mcp/analytics           --transport http

Συνδέεστε μόνο μία φορά. Μετά την πρώτη έγκριση στο πρόγραμμα περιήγησης, το Claude Code επαναχρησιμοποιεί τη συνεδρία Wink σας για επιπλέον endpoints Wink.

Μοιραστείτε με την ομάδα σας

Προσθέστε --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-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

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

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 ενός συνόλου εργαλείων από τον κατάλογο παραπάνω, για παράδειγμα:

   https://api.wink.travel/mcp/extranet/rates

   Μετά κάντε κλικ στο Σύνδεση.

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

6. Επαναλάβετε τα βήματα 4–5 για όποιο άλλο σύνολο εργαλείων χρειάζεται η εργασία σας, για παράδειγμα:

   https://api.wink.travel/mcp/extranet/operations

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

Περιορισμός web app

Οι διακομιστές MCP ρυθμίζονται μόνο στην εφαρμογή για υπολογιστές. Η web διεπαφή 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-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

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. Ανοίξτε (ή δημιουργήστε) το αρχείο ρυθμίσεων 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-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

3. Επανεκκινήστε πλήρως το Windsurf (Αρχείο → Έξοδος, μετά ξανανοίξτε).

4. Μεταβείτε σε Settings → 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, μετά επιλέξτε Edit MCP Settings.

4. Το VS Code ανοίγει το cline_mcp_settings.json. Προσθέστε τις καταχωρήσεις Wink:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

5. Αποθηκεύστε το αρχείο. Το Cline φορτώνει ξανά αυτόματα και ανοίγει μια καρτέλα προγράμματος περιήγησης στο https://iam.wink.travel.

6. Συνδεθείτε στο Wink και εγκρίνετε τα δικαιώματα. Και οι δύο διακομιστές εμφανίζονται ως ενεργοί στο πάνελ MCP Servers.

Εναλλακτικά: προσθήκη μέσω URL

Στο πάνελ MCP Servers, κάντε κλικ στο Add Server και επικολλήστε απευθείας ένα URL συνόλου εργαλείων όπως https://api.wink.travel/mcp/extranet/rates. Το Cline συμπληρώνει αυτόματα τη ρύθμιση και χειρίζεται την αυθεντικοποίηση χωρίς χειροκίνητη επεξεργασία JSON.

---

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

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

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

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

Τα σύνολα εργαλείων δεν αλλάζουν τίποτα από αυτά. Το endpoint που συνδέεστε αποφασίζει ποια εργαλεία εμφανίζονται, όχι τι επιτρέπεται να κάνουν. Η σύνδεση σε /mcp/payment δεν παρέχει κανένα χρηματοοικονομικό δικαίωμα που δεν είχατε ήδη, και η σύνδεση σε /mcp/reference δεν εμποδίζει ένα εργαλείο εκεί να εφαρμόζει το δικό του scope. Η εξουσιοδότηση αποφασίζεται ανά κλήση εργαλείου, από το token σας και τα δικαιώματα του λογαριασμού σας.

---

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

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

Ο πελάτης 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-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Για Claude Desktop και ChatGPT, αφαιρέστε την καταχώρηση διακομιστή από τις ρυθμίσεις, επανεκκινήστε την εφαρμογή και προσθέστε την ξανά.

403 Forbidden κατά την κλήση συγκεκριμένου εργαλείου

Το εργαλείο απαιτεί scope που δεν εγκρίνατε στην οθόνη συγκατάθεσης, ή δικαίωμα που δεν έχει ο λογαριασμός σας. Επανασυνδέστε τον διακομιστή — η οθόνη συγκατάθεσης θα εμφανιστεί ξανά και μπορείτε να εγκρίνετε το ελλείπον δικαίωμα. Αν αποτύχει ξανά, το εργαλείο χρειάζεται δικαίωμα λογαριασμού που δεν έχετε· η σύνδεση σε διαφορετικό σύνολο εργαλείων δεν βοηθά, γιατί τα σύνολα εργαλείων δεν παρέχουν δικαιώματα.

Το εργαλείο που χρειάζομαι δεν είναι στη λίστα

Πιθανώς είστε συνδεδεμένοι σε σύνολο εργαλείων που δεν καλύπτει αυτή την εργασία. Ελέγξτε τον κατάλογο endpoints και προσθέστε το σύνολο εργαλείων που την καλύπτει — οι συνδέσεις είναι ανεξάρτητες, οπότε η προσθήκη ενός δεν αλλάζει τίποτα στα άλλα. Αν δεν είστε σίγουροι ποιο το έχει, συνδεθείτε προσωρινά στο https://api.wink.travel/mcp, βρείτε το εργαλείο, και μετά δείτε ποιο σύνολο εργαλείων το περιλαμβάνει.

404 Not Found σε endpoint συνόλου εργαλείων

Ελέγξτε προσεκτικά τη διαδρομή — τα nested σύνολα εργαλείων έχουν δύο τμήματα (/mcp/extranet/rates, όχι /mcp/extranet-rates), και τα flat έχουν ένα (/mcp/link-manager). Σημειώστε ότι ένα μη αυθεντικοποιημένο αίτημα σε οποιαδήποτε διαδρομή κάτω από /mcp επιστρέφει 401, όχι 404, οπότε μόνο το 401 δεν δείχνει αν το endpoint υπάρχει.

Συνδέθηκα στο api.wink.travel/mcp/channel-manager και δεν πήρα τίποτα

Αυτό το endpoint δεν υπάρχει. Η ενσωμάτωση διαχειριστή καναλιών εξυπηρετείται μόνο από το https://integrations.wink.travel/mcp/channel-manager. Αν χρειάζεστε επίσης να διαβάζετε ή να γράφετε τις δικές σας τιμές ιδιοκτησίας χειροκίνητα, αυτή είναι ξεχωριστή εργασία σε ξεχωριστό endpoint — δείτε /mcp/extranet/rates.

Ο διακομιστής εμφανίζεται αλλά οι κλήσεις εργαλείων επιστρέφουν “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". Μεταβείτε σε Settings → Cursor Settings → MCP και κάντε κλικ στο Refresh. Αν το σφάλμα παραμένει, επανεκκινήστε πλήρως το Cursor — οι αλλαγές ρυθμίσεων δεν αναγνωρίζονται πάντα χωρίς επανεκκίνηση.

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

Το 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