MCP सर्वर

Wink के MCP टूल्स को टूलसेट्स के रूप में प्रकाशित किया गया है — फोकस्ड एंडपॉइंट्स, प्रत्येक एक काम को कवर करता है। आप अपने AI क्लाइंट को उन एक या दो से कनेक्ट करते हैं जो आपके काम से मेल खाते हैं, न कि सभी से।

हर एंडपॉइंट इंटरैक्टिव OAuth2 लॉगिन (PKCE ऑथराइजेशन कोड फ्लो) का उपयोग करता है: आपका AI एजेंट एक ब्राउज़र टैब खोलता है, आप अपने Wink अकाउंट से साइन इन करते हैं, और बस इतना ही। कोई क्लाइंट सीक्रेट्स प्रबंधित करने की जरूरत नहीं।

एक चैनल मैनेजर इंटीग्रेटर एक एंडपॉइंट से कनेक्ट होता है

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

---

टूल्स को एंडपॉइंट्स में विभाजित क्यों किया गया है

Wink लगभग 500 टूल्स को एक्सपोज़ करता है। सभी को एक साथ एक एजेंट को देना तकनीकी रूप से संभव है — और यह एक खराब विचार है।

टूल परिभाषाएँ संदर्भ की लागत होती हैं। हर टूल जिसे MCP सर्वर विज्ञापित करता है, मॉडल के संदर्भ विंडो में लोड होता है, उसके विवरण और पूर्ण पैरामीटर स्कीमा के साथ, इससे पहले कि वह कोई काम करे। पाँच सौ ऐसे टूल्स आपके वास्तविक कार्य के लिए आवश्यक बजट का एक बड़ा हिस्सा हर एक अनुरोध पर खर्च कर देते हैं।

सूची बढ़ने पर चयन की गुणवत्ता गिरती है। 500 समान नाम वाले टूल्स में से चुनने वाला एजेंट 40 में से चुनने वाले की तुलना में खराब विकल्प बनाता है। यदि आप एक चैनल मैनेजर इंटीग्रेट करते हैं, तो लगभग बीस टूल्स आपके लिए प्रासंगिक होते हैं; बाकी 480 शोर हैं जो सही टूल को ढूंढना कठिन बनाते हैं।

काम वास्तव में अलग किया जा सकता है। कोई जो PMS से उपलब्धता सिंक कर रहा है और कोई जो एफिलिएट लैंडिंग पेज क्यूरेट कर रहा है, उनके लगभग कोई साझा टूल्स नहीं हैं। काम के अनुसार विभाजन का मतलब है कि हर कनेक्शन एक काम की शब्दावली लेकर चलता है।

टूलसेट्स अनुमति नहीं हैं

एक संकीर्ण टूलसेट चुनना आपके अकाउंट की क्षमताओं को प्रतिबंधित नहीं करता, और एक व्यापक टूलसेट चुनना कोई अतिरिक्त अनुमति नहीं देता। हर टूल वेब पोर्टल के समान अकाउंट अनुमतियों को लागू करता है, आपके साइन-इन पहचान के तहत। यदि आपका अकाउंट Wink पोर्टल में बुकिंग रद्द नहीं कर सकता, तो एजेंट भी नहीं कर सकता — चाहे वह किसी भी एंडपॉइंट से कनेक्ट हो।

टूलसेट्स को फोकस के लिए चुनें, सुरक्षा के लिए नहीं।

---

एंडपॉइंट निर्देशिका

दो होस्ट टूलसेट्स सर्व करते हैं। टूल की संख्या अनुमानित है और समय के साथ बढ़ती है।

https://api.wink.travel — प्लेटफ़ॉर्म

एंडपॉइंट	टूल्स	क्या कवर करता है
/mcp/extranet/facilities	~64	बुक करने योग्य और ऑन-साइट इन्वेंटरी: गेस्ट रूम और रूम टाइप्स, स्पा, रेस्तरां, मीटिंग रूम, गतिविधियाँ, आकर्षण, स्थान, अन्य बिक्री योग्य आइटम
/mcp/extranet/property	~62	प्रॉपर्टी रिकॉर्ड और उसके वाणिज्यिक शर्तें: प्रोफ़ाइल और सामग्री, ऐड-ऑन, रद्द करने की नीतियाँ, लाभ, घोषणाएँ
/mcp/settings	~60	अकाउंट प्रशासन: प्रबंधकीय इकाई प्रोफ़ाइल और ब्रांडिंग, प्रबंधक और उनके ग्रांट्स, कस्टमाइज़ेशन, वेबहुक्स, नोटिफिकेशन प्राथमिकताएँ
/mcp/studio/embeds	~48	क्यूरेटेड इन्वेंटरी प्रकाशित करना: विजेट्स, ग्रिड्स और रैंक्ड ग्रिड्स, कार्ड्स, मैप्स, इन्वेंटरी और सप्लायर पेजों के डीप लिंक
/mcp/extranet/rates	~44	कीमतें और उपलब्धता: इन्वेंटरी रेट पीरियड्स और अलॉटमेंट्स, रेट प्लान्स, मास्टर रेट्स, विशेष और प्रचारात्मक दरें
/mcp/extranet/operations	~39	लाइव प्रॉपर्टी चलाना: आरक्षण और उनका जीवनचक्र, गेस्ट समीक्षा और प्रतिक्रियाएँ, कैलेंडर फीड्स, निर्धारित कार्य
/mcp/extranet/distribution	~37	जहां इन्वेंटरी बेची जाती है: बिक्री चैनल और रेट मॉडिफायर्स, एफिलिएट और सप्लायर संबंध अनुरोध, पंजीकरण, लीड कैप्चर
/mcp/studio/curation	~35	मर्चेंडाइजेबल कलेक्शंस बनाना: स्थैतिक और गतिशील सूचियाँ, रैंक्ड सूचियाँ, सहेजे गए खोज, प्रॉपर्टी एग्रीगेट्स
/mcp/link-manager	~28	सिंडिकेटेड लिंक कलेक्शंस, उनका डिज़ाइन, श्रेणियाँ और टैग्स, साथ ही शॉर्ट किए गए URL
/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 — चैनल मैनेजर इंटीग्रेशन

एक एंडपॉइंट, क्योंकि यह होस्ट एक काम के लिए मौजूद है।

एंडपॉइंट	टूल्स	क्या कवर करता है
/mcp/channel-manager	~9	चैनल मैनेजर, PMS या CRS इंटीग्रेशन को कनेक्ट और सत्यापित करना

चैनल मैनेजर इंटीग्रेशन बनाम अपनी खुद की दरें प्रबंधित करना

ये अलग-अलग काम हैं अलग-अलग लोगों के लिए, और वे एक ही एंडपॉइंट साझा नहीं करते।

एक चैनल मैनेजर, PMS या CRS विक्रेता एक बार integrations.wink.travel/mcp/channel-manager के माध्यम से इंटीग्रेट करता है, और तब से प्रॉपर्टीज़, दरें, उपलब्धता और आरक्षण उस इंटीग्रेशन के माध्यम से एक्सचेंज करता है। वह एकल एंडपॉइंट पूरी सतह है।

एक होटलियर जो अपनी खुद की दरें हाथ से बदलता है api.wink.travel पर एक्स्ट्रानेट टूलसेट्स का उपयोग करता है — /mcp/extranet/rates और अन्य। वे चैनल मैनेजर इंटीग्रेशन का हिस्सा नहीं हैं और एक इंटीग्रेटर के लिए उन्हें कनेक्ट करने का कोई कारण नहीं है।

अकाउंट प्रशासन भी api.wink.travel पर है, /mcp/settings पर। इंटीग्रेशन होस्ट पर /mcp/settings नहीं है।

हर एंडपॉइंट में एक ping टूल भी होता है, ताकि आप कनेक्शन लाइव है या नहीं, यह पुष्टि कर सकें।

एजेंटिक भुगतान

पूर्ण यात्री बुकिंग फ्लो के लिए, Wink Booking Engine को https://api.wink.travel/mcp/booking-engine पर और एक संगत भुगतान वॉलेट से कनेक्ट करें। Wink MCP जोड़ने से ब्राउज़र साइन-इन और अनुमति चयन खुलता है; आपका क्लाइंट फिर प्रमाणीकरण संभालता है।

बुकिंग इंजन में डेस्टिनेशन लुकअप, होटल और रूम खोज, 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
लिंक-इन-बायो पेज चला रहे हैं	/mcp/link-manager + /mcp/social
यात्रियों की ओर से बुकिंग कर रहे हैं	/mcp/travel-agent
पैसे का मिलान कर रहे हैं	/mcp/payment
AI एजेंट के साथ कमरा बुक कर रहे हैं	/mcp/booking-engine + एक संगत भुगतान वॉलेट — देखें Agentic Payments
बुकिंग अनुभव बना रहे हैं	/mcp/booking-engine; वैकल्पिक रूप से अतिरिक्त लुकअप के लिए /mcp/reference

बुकिंग इंजन में मुख्य बुकिंग वर्कफ़्लो शामिल है। यह अकाउंट और कस्टमाइज़ेशन डिस्कवरी, डेस्टिनेशन लुकअप, होटल उपलब्धता और रूम-रेट विवरण, शॉपिंग कार्ट, चेकआउट, और यात्री बुकिंग प्रबंधन प्रदान करता है। एजेंटिक बुकिंग और भुगतान टूल भी उस वातावरण के लिए सक्षम होने पर शामिल होते हैं।

शहर-आधारित होटल खोज के लिए, डेस्टिनेशन को हल करने के लिए destination_lookup_search_suggestions का उपयोग करें, फिर उपलब्ध होटलों और दरों को खोजने के लिए inventory_search_city। दोनों टूल /mcp/booking-engine में हैं, इसलिए इस फ्लो को Reference कनेक्शन की आवश्यकता नहीं है।

जब आपको देशों, मुद्राओं और विनिमय दरों, समर्थित भाषाओं, टाइमज़ोन, व्यापक भौगोलिक खोज, OTA वर्गीकरण, या सार्वजनिक प्रॉपर्टी ज्ञान जैसे सहायक लुकअप की आवश्यकता हो, तो /mcp/reference जोड़ें। ये बुकिंग फ्लो के वैकल्पिक अतिरिक्त हैं।

एक से शुरू करें। जब आपको लगे कि वह कुछ नहीं कर सकता जो आप चाहते हैं, तो दूसरा जोड़ें — हर कनेक्शन स्वतंत्र है, और एक जोड़ने से दूसरों पर कोई प्रभाव नहीं पड़ता।

फिर भी सब कुछ चाहिए?

https://api.wink.travel/mcp और https://integrations.wink.travel/mcp उपलब्ध रहते हैं और अपने होस्ट पर हर टूल सर्व करते हैं। ये यह देखने के लिए उपयोगी हैं कि क्या मौजूद है, लेकिन हम इन्हें दैनिक काम के लिए अनुशंसित नहीं करते: टूल सूची इतनी बड़ी है कि यह आपके कार्य को दबा सकती है और एजेंट के टूल चयन को खराब कर सकती है। ऊपर दिए गए टूलसेट्स को प्राथमिकता दें।

---

प्रमाणीकरण कैसे काम करता है

Wink MCP सर्वर OAuth2 ऑथराइजेशन कोड + PKCE फ्लो का उपयोग करते हैं और डायनामिक क्लाइंट रजिस्ट्रेशन (RFC 7591) का समर्थन करते हैं। पहली बार कनेक्ट करते समय यह होता है:

1. आपका AI क्लाइंट MCP एंडपॉइंट के /.well-known/oauth-protected-resource मेटाडेटा से ऑथराइजेशन सर्वर खोजता है।
2. क्लाइंट डायनामिक क्लाइंट रजिस्ट्रेशन के माध्यम से स्वयं-पंजीकरण करता है — कोई मैनुअल एप्लिकेशन सेटअप आवश्यक नहीं।
3. क्लाइंट https://iam.wink.travel पर एक ब्राउज़र टैब खोलता है। आप अपने Wink अकाउंट से साइन इन करते हैं और सहमति स्क्रीन पर अनुरोधित अनुमतियों को मंजूरी देते हैं।
4. Wink आपके अकाउंट के लिए स्कोप्ड और आपकी पहचान से लिंक्ड एक एक्सेस टोकन जारी करता है।
5. AI क्लाइंट हर MCP अनुरोध के साथ टोकन संलग्न करता है। सभी टूल परिणाम स्वचालित रूप से आपके प्रबंधकीय इकाई के लिए स्कोप्ड होते हैं।
6. टोकन 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 एंडपॉइंट्स के लिए आपका Wink सत्र पुन: उपयोग करता है।

अपनी टीम के साथ साझा करें

--scope project को claude mcp add में जोड़ें और Claude Code सर्वर URL को .mcp.json में रिपॉजिटरी रूट पर लिखता है। उस फ़ाइल को कमिट करें — हर टीम सदस्य को वही टूलसेट्स मिलते हैं, और हर कोई पहली बार कनेक्ट करते समय अपना ब्राउज़र साइन-इन पूरा करता है।

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. Wink MCP सर्वर एंट्रीज़ जोड़ें:

   ~/.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 सर्वर सक्रिय हैं।

टिप्पणी

Codex CLI MCP समर्थन संस्करण 1.0 या बाद का आवश्यक है। जांचने के लिए codex --version चलाएं, और अपडेट के लिए npm install -g @openai/codex करें।

ChatGPT

MCP सर्वर समर्थन ChatGPT डेस्कटॉप ऐप में Plus, Pro, Team, और Enterprise सब्सक्राइबर्स के लिए उपलब्ध है।

1. यदि आपने अभी तक नहीं किया है, तो ChatGPT डेस्कटॉप ऐप डाउनलोड और इंस्टॉल करें।

2. ऐप खोलें और ऊपर-दाएँ कोने में अपनी प्रोफ़ाइल आइकन पर क्लिक करें, फिर Settings चुनें।

3. Connectors (या आपके ऐप संस्करण के अनुसार MCP Servers) पर जाएं और Add पर क्लिक करें।

4. ऊपर दिए गए निर्देशिका से एक टूलसेट URL दर्ज करें, उदाहरण के लिए:

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

   फिर Connect पर क्लिक करें।

5. ChatGPT https://iam.wink.travel पर ब्राउज़र टैब खोलता है। Wink में साइन इन करें और अनुमतियाँ मंजूर करें।

6. अपने काम के लिए अन्य टूलसेट्स के लिए चरण 4–5 दोहराएं, उदाहरण के लिए:

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

7. हर टूलसेट आपके Connectors सूची में दिखाई देता है। नया चैट शुरू करें — Wink टूल्स स्वचालित रूप से उपलब्ध हैं।

वेब ऐप सीमा

MCP सर्वर केवल डेस्कटॉप ऐप में कॉन्फ़िगर किए जा सकते हैं। ChatGPT वेब इंटरफ़ेस chatgpt.com पर कस्टम MCP सर्वर समर्थित नहीं हैं।

Cursor

1. Cursor MCP कॉन्फ़िग फ़ाइल खोलें (या बनाएं):

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

2. Wink MCP सर्वर एंट्रीज़ जोड़ें:

   ~/.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) और कनेक्शन की पुष्टि के लिए उपलब्ध Wink टूल्स की सूची पूछें।

प्रोजेक्ट-स्कोप्ड कॉन्फ़िग

आप ~/.cursor/ के बजाय अपने प्रोजेक्ट के रूट पर भी mcp.json फ़ाइल रख सकते हैं। प्रोजेक्ट-स्तरीय कॉन्फ़िग प्राथमिकता रखता है और सर्वर हर टीम सदस्य के लिए उपलब्ध कराता है जो Cursor में प्रोजेक्ट खोलता है।

Windsurf

1. Windsurf MCP कॉन्फ़िग फ़ाइल खोलें (या बनाएं):

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

2. Wink MCP सर्वर एंट्रीज़ जोड़ें:

   ~/.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 पुनः प्रारंभ करें (File → Quit, फिर पुनः खोलें)।

4. Settings → MCP Servers पर जाएं और पुष्टि करें कि दोनों सर्वर कनेक्टेड दिख रहे हैं। Windsurf पहली बार उपयोग पर https://iam.wink.travel पर ब्राउज़र टैब खोलता है।

5. Wink में साइन इन करें और अनुमतियाँ मंजूर करें। प्रमाणीकरण के बाद सर्वर सेटिंग्स पैनल में हरे हो जाते हैं।

टिप्पणी

Windsurf MCP समर्थन संस्करण 1.4 या बाद का आवश्यक है। Help → About Windsurf से जांचें और आवश्यक होने पर Windsurf वेबसाइट से अपडेट करें।

Cline (VS Code)

Cline एक VS Code एक्सटेंशन है जिसमें बिल्ट-इन MCP सर्वर मैनेजर है। मैनुअल JSON संपादन की आवश्यकता नहीं है।

1. VS Code मार्केटप्लेस से Cline इंस्टॉल करें:

   • VS Code खोलें और Ctrl+Shift+X / Cmd+Shift+X दबाएं
   • Cline खोजें और Install पर क्लिक करें

2. Activity Bar (बाएँ साइडबार) में Cline आइकन पर क्लिक करें ताकि Cline पैनल खुले।

3. Cline टूलबार में MCP Servers आइकन (प्लग आइकन) पर क्लिक करें, फिर 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 पर क्लिक करें और सीधे https://api.wink.travel/mcp/extranet/rates जैसे टूलसेट URL पेस्ट करें। Cline कॉन्फ़िग को ऑटो-पॉपुलेट करता है और प्रमाणीकरण को मैनुअल JSON संपादन के बिना संभालता है।

---

स्कोप्स

जब आप सहमति स्क्रीन को मंजूरी देते हैं तो आप देखेंगे कि एजेंट क्या अनुरोध कर रहा है। MCP क्लाइंट्स उसी अनुमति शब्दावली का उपयोग करते हैं जो बाकी प्लेटफ़ॉर्म करता है — पूर्ण स्कोप संदर्भ Authentication पेज पर देखें।

दो चीजें MCP के लिए विशिष्ट हैं:

• mcp.read mcp.write mcp.remove स्कोप्स अतिरिक्त रूप से आवश्यक हैं MCP ट्रांसपोर्ट खोलने के लिए। एक क्लाइंट जिसके पास mcp.* स्कोप है, किसी भी Wink MCP एंडपॉइंट में प्रवेश कर सकता है, लेकिन वह हर टूल कॉल पर उस एंडपॉइंट के सेक्शन स्कोप को लागू करता है (जैसे booking.read)।
• AI क्लाइंट केवल आवश्यक स्कोप्स का अनुरोध करता है। आप सहमति स्क्रीन पर व्यक्तिगत अनुमतियाँ अस्वीकार कर सकते हैं — जिन टूल्स को अस्वीकृत स्कोप की आवश्यकता होती है, वे कॉल पर त्रुटि लौटाएंगे।

टूलसेट्स इनमें से कोई भी नहीं बदलते। आप जिस एंडपॉइंट से कनेक्ट करते हैं, वह तय करता है कि कौन से टूल सूचीबद्ध हैं, न कि वे क्या कर सकते हैं। /mcp/payment से कनेक्ट करना कोई अतिरिक्त वित्तीय अनुमति नहीं देता, और /mcp/reference से कनेक्ट करना वहां के टूल को अपने स्कोप को लागू करने से नहीं रोकता। प्राधिकरण टोकन और आपके अकाउंट के ग्रांट्स के आधार पर हर टूल कॉल पर तय होता है।

---

समस्या निवारण

ब्राउज़र टैब नहीं खुलता

आपका AI क्लाइंट अभी इंटरैक्टिव PKCE फ्लो का समर्थन नहीं कर सकता। सुनिश्चित करें कि आप नवीनतम संस्करण चला रहे हैं:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT डेस्कटॉप: ऐप के बिल्ट-इन अपडेटर से अपडेट करें

साइन इन के बाद 401 Unauthorized

आपका कैश्ड टोकन पुराना हो सकता है। ताजा साइन-इन के लिए सर्वर को हटाएं और फिर से जोड़ें:

# 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

टूल को उस स्कोप की आवश्यकता है जिसे आपने सहमति स्क्रीन पर मंजूर नहीं किया, या आपके अकाउंट के पास वह अनुमति नहीं है। सर्वर को पुनः कनेक्ट करें — सहमति स्क्रीन फिर से आएगी और आप आवश्यक अनुमति मंजूर कर सकते हैं। यदि फिर भी विफल रहता है, तो टूल को आपके अकाउंट की अनुमति चाहिए जो आपके पास नहीं है; अलग टूलसेट से कनेक्ट करने से मदद नहीं मिलेगी क्योंकि टूलसेट अनुमति नहीं देते।

मुझे जो टूल चाहिए वह सूची में नहीं है

आप संभवतः ऐसे टूलसेट से जुड़े हैं जो उस काम को कवर नहीं करता। एंडपॉइंट निर्देशिका देखें और वह टूलसेट जोड़ें जो कवर करता है — कनेक्शन स्वतंत्र हैं, इसलिए एक जोड़ने से दूसरों पर कोई प्रभाव नहीं पड़ता। यदि आप सुनिश्चित नहीं हैं कि कौन सा है, तो अस्थायी रूप से https://api.wink.travel/mcp से कनेक्ट करें, टूल खोजें, फिर देखें कि कौन सा टूलसेट उसे सूचीबद्ध करता है।

टूलसेट एंडपॉइंट पर 404 Not Found

पथ को ध्यान से जांचें — नेस्टेड टूलसेट्स में दो सेगमेंट होते हैं (/mcp/extranet/rates, न कि /mcp/extranet-rates), और फ्लैट वाले में एक (/mcp/link-manager)। ध्यान दें कि /mcp के अंतर्गत बिना प्रमाणीकरण के अनुरोध पर 401 लौटता है, न कि 404, इसलिए केवल 401 से यह पता नहीं चलता कि एंडपॉइंट मौजूद है या नहीं।

मैंने api.wink.travel/mcp/channel-manager से कनेक्ट किया और कुछ नहीं मिला

वह एंडपॉइंट मौजूद नहीं है। चैनल मैनेजर इंटीग्रेशन केवल https://integrations.wink.travel/mcp/channel-manager से सर्व किया जाता है। यदि आपको प्रॉपर्टी की अपनी दरें हाथ से पढ़ने या लिखने की जरूरत है, तो वह अलग काम है और अलग एंडपॉइंट पर है — देखें /mcp/extranet/rates।

सर्वर दिखाई देता है लेकिन टूल कॉल “account not found” लौटाते हैं

आप ऐसे Wink अकाउंट से साइन इन हैं जिसका कोई प्रबंधकीय इकाई नहीं है। Wink Portal पर जाएं और सुनिश्चित करें कि आपका अकाउंट सेटअप है, फिर MCP सर्वर का उपयोग करें।

टोकन सत्र के बीच समाप्त हो जाता है

टोकन 3 घंटे के लिए मान्य होते हैं। Claude Code और Claude Desktop बिना बाधा डाले पृष्ठभूमि में टोकन रिफ्रेश करते हैं। यदि लंबे निष्क्रिय अवधि के बाद प्रमाणीकरण त्रुटियाँ दिखें, तो नया संदेश टाइप करें — क्लाइंट स्वचालित रूप से पुनः प्रमाणीकरण करेगा।

Codex CLI “MCP server unreachable” दिखाता है

सुनिश्चित करें कि आपका ~/.codex/config.json वैध JSON है (कोई ट्रेलिंग कॉमा नहीं) और "type": "http" सेट है। Codex रिमोट सर्वरों के लिए HTTP ट्रांसपोर्ट की आवश्यकता करता है; stdio ट्रांसपोर्ट केवल स्थानीय बाइनरी के लिए है।

ChatGPT “Connectors” मेनू गायब है

MCP समर्थन के लिए ChatGPT डेस्कटॉप ऐप संस्करण 1.2024.352 या बाद का और Plus, Pro, Team, या Enterprise सब्सक्रिप्शन आवश्यक है। ऐप अपडेट करें और Settings → Account में अपनी योजना सत्यापित करें।

Cursor सर्वर लाल दिखाता है / “Failed to connect”

सुनिश्चित करें कि आपका ~/.cursor/mcp.json वैध JSON है और "type": "http" शामिल है। फिर Settings → Cursor Settings → MCP पर जाएं और Refresh पर क्लिक करें। यदि त्रुटि बनी रहती है, तो Cursor को पूरी तरह से पुनः प्रारंभ करें — कॉन्फ़िग परिवर्तन हमेशा बिना पुनः प्रारंभ के नहीं पकड़े जाते।

Windsurf MCP सर्वर सेटिंग्स में सूचीबद्ध नहीं हैं

Windsurf को mcp_config.json में बदलाव लेने के लिए पूरी तरह से पुनः प्रारंभ करने की आवश्यकता होती है (सिर्फ विंडो रीलोड नहीं)। File → Quit करें और फिर पुनः लॉन्च करें। यदि सर्वर अभी भी नहीं दिखते, तो सुनिश्चित करें कि आप Windsurf 1.4+ पर हैं, Help → About Windsurf से जांचें।

Cline में “Add Server” विकल्प दिखाई नहीं देता

MCP सर्वर मैनेजर के लिए Cline संस्करण 2.0 या बाद का आवश्यक है। VS Code एक्सटेंशंस पैनल खोलें, Cline खोजें, और यदि अपडेट उपलब्ध है तो Update पर क्लिक करें। अपडेट के बाद, VS Code को रीलोड करें (Ctrl+Shift+P → “Developer: Reload Window”)।

---

Wink पोर्टल खोलें GitHub पर Wink