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 टूल भी होता है, ताकि आप कनेक्शन लाइव है या नहीं, यह पुष्टि कर सकें इससे पहले कि आप असली काम के लिए कहें।

---

मुझे कौन से टूलसेट्स चाहिए?

यदि आप हैं…	कनेक्ट करें
चैनल मैनेजर, 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
बुकिंग अनुभव बना रहे हैं	/mcp/booking-engine + /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 डेस्कटॉप ऐप में उपलब्ध है प्लस, प्रो, टीम, और एंटरप्राइज़ सब्सक्राइबर्स के लिए।

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 पर क्लिक करें और सीधे टूलसेट URL जैसे https://api.wink.travel/mcp/extranet/rates पेस्ट करें। 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 या बाद का और सक्रिय प्लस, प्रो, टीम, या एंटरप्राइज़ सब्सक्रिप्शन आवश्यक है। ऐप अपडेट करें और 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