MCP सर्वर
Wink के MCP टूल्स को टूलसेट्स के रूप में प्रकाशित किया गया है — फोकस्ड एंडपॉइंट्स, प्रत्येक एक काम को कवर करता है। आप अपने AI क्लाइंट को उन एक या दो से कनेक्ट करते हैं जो आपके काम से मेल खाते हैं, न कि सभी से।
हर एंडपॉइंट इंटरैक्टिव OAuth2 लॉगिन (PKCE ऑथराइजेशन कोड फ्लो) का उपयोग करता है: आपका AI एजेंट एक ब्राउज़र टैब खोलता है, आप अपने Wink अकाउंट से साइन इन करते हैं, और बस इतना ही। कोई क्लाइंट सीक्रेट्स प्रबंधित करने की जरूरत नहीं।
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpटूल्स को एंडपॉइंट्स में विभाजित क्यों किया गया है
Section titled “टूल्स को एंडपॉइंट्स में विभाजित क्यों किया गया है”Wink लगभग 500 टूल्स को एक्सपोज़ करता है। सभी को एक साथ एजेंट को देना तकनीकी रूप से संभव है — और यह एक खराब विचार है।
टूल परिभाषाएँ संदर्भ की लागत होती हैं। हर टूल जिसे MCP सर्वर विज्ञापित करता है, मॉडल के संदर्भ विंडो में लोड होता है, उसके विवरण और पूर्ण पैरामीटर स्कीमा के साथ, इससे पहले कि वह कोई काम करे। पाँच सौ ऐसे टूल्स आपके वास्तविक कार्य के लिए आवश्यक बजट का बड़ा हिस्सा हर एक अनुरोध पर खर्च कर देते हैं।
सूची बढ़ने पर चयन की गुणवत्ता गिरती है। 500 समान नाम वाले टूल्स में से चुनने वाला एजेंट 40 में से चुनने वाले से खराब विकल्प बनाता है। यदि आप एक चैनल मैनेजर इंटीग्रेट करते हैं, तो लगभग बीस टूल्स आपके लिए प्रासंगिक होते हैं; बाकी 480 शोर हैं जो सही टूल को ढूंढना कठिन बनाते हैं।
काम वास्तव में अलग किया जा सकता है। कोई जो PMS से उपलब्धता सिंक करता है और कोई जो एफिलिएट लैंडिंग पेज क्यूरेट करता है, उनके लगभग कोई साझा टूल्स नहीं होते। जॉब के अनुसार विभाजन का मतलब है कि हर कनेक्शन एक काम की शब्दावली लेकर चलता है।
एंडपॉइंट निर्देशिका
Section titled “एंडपॉइंट निर्देशिका”दो होस्ट टूलसेट्स सर्व करते हैं। टूल की संख्या अनुमानित है और समय के साथ बढ़ती है।
https://api.wink.travel — प्लेटफ़ॉर्म
Section titled “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 — चैनल मैनेजर इंटीग्रेशन
Section titled “https://integrations.wink.travel — चैनल मैनेजर इंटीग्रेशन”एक एंडपॉइंट, क्योंकि यह होस्ट एक काम के लिए मौजूद है।
| एंडपॉइंट | टूल्स | क्या कवर करता है |
|---|---|---|
/mcp/channel-manager | ~9 | चैनल मैनेजर, PMS या CRS इंटीग्रेशन को कनेक्ट और सत्यापित करना |
हर एंडपॉइंट में एक ping टूल भी होता है, ताकि आप कनेक्शन लाइव है या नहीं, यह पुष्टि कर सकें।
एजेंटिक भुगतान
Section titled “एजेंटिक भुगतान”पूर्ण यात्री बुकिंग फ्लो के लिए, Wink Booking Engine को https://api.wink.travel/mcp/booking-engine पर और एक संगत पेमेंट वॉलेट से कनेक्ट करें। Wink MCP जोड़ने पर ब्राउज़र साइन-इन और अनुमति चयन खुलता है; आपका क्लाइंट फिर प्रमाणीकरण संभालता है।
बुकिंग इंजन में डेस्टिनेशन लुकअप, होटल और रूम खोज, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, बुकिंग पुनः प्राप्ति और रसीदें शामिल हैं, जब एजेंटिक बुकिंग और भुगतान उस वातावरण के लिए सक्षम हों। कनेक्शन सेटअप, चयन करने योग्य अनुमतियाँ और खोज से पुष्टि तक के चरणों के लिए देखें Agentic Payments।
मुझे कौन से टूलसेट्स चाहिए?
Section titled “मुझे कौन से टूलसेट्स चाहिए?”| यदि आप हैं… | कनेक्ट करें |
|---|---|
| चैनल मैनेजर, 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 जोड़ें। ये बुकिंग फ्लो के वैकल्पिक अतिरिक्त हैं।
एक से शुरू करें। जब आपको लगे कि वह कुछ नहीं कर सकता जो आप चाहते हैं, तो दूसरा जोड़ें — हर कनेक्शन स्वतंत्र है, और एक जोड़ने से दूसरों पर कोई असर नहीं पड़ता।
प्रमाणीकरण कैसे काम करता है
Section titled “प्रमाणीकरण कैसे काम करता है”Wink MCP सर्वर OAuth2 ऑथराइजेशन कोड + PKCE फ्लो का उपयोग करते हैं और डायनामिक क्लाइंट रजिस्ट्रेशन (RFC 7591) का समर्थन करते हैं। पहली बार कनेक्ट करते समय यह होता है:
- आपका AI क्लाइंट MCP एंडपॉइंट के
/.well-known/oauth-protected-resourceमेटाडेटा से ऑथराइजेशन सर्वर खोजता है। - क्लाइंट डायनामिक क्लाइंट रजिस्ट्रेशन के माध्यम से स्वयं-पंजीकरण करता है — कोई मैनुअल एप्लिकेशन सेटअप आवश्यक नहीं।
- क्लाइंट
https://iam.wink.travelपर एक ब्राउज़र टैब खोलता है। आप अपने Wink अकाउंट से साइन इन करते हैं और सहमति स्क्रीन पर अनुरोधित अनुमतियों को मंजूरी देते हैं। - Wink आपके खाते के लिए स्कोप्ड और आपकी पहचान से लिंक्ड एक एक्सेस टोकन जारी करता है।
- AI क्लाइंट हर MCP अनुरोध के साथ टोकन संलग्न करता है। सभी टूल परिणाम स्वचालित रूप से आपके प्रबंधकीय इकाई के लिए स्कोप्ड होते हैं।
- टोकन 3 घंटे बाद समाप्त हो जाते हैं। आपका AI क्लाइंट बिना फिर से पूछे पृष्ठभूमि में चुपचाप रिफ्रेश करता है।
हर टूल कॉल आपकी पहचान के तहत चलता है — वे ACL नियम जो वेब पोर्टल की सुरक्षा करते हैं, AI एजेंट पर भी लागू होते हैं।
अपना AI क्लाइंट कनेक्ट करें
Section titled “अपना AI क्लाइंट कनेक्ट करें”Claude में प्रत्येक टूलसेट को एक कस्टम कनेक्टर के रूप में जोड़ें। कोई कॉन्फ़िग फ़ाइल संपादित करने या कोई एप्लिकेशन या सीक्रेट बनाने की जरूरत नहीं।
-
Claude में, Customize › Connectors खोलें, Add पर क्लिक करें, फिर Add custom connector चुनें।
-
एक Name दर्ज करें (उदाहरण के लिए Wink Link manager) और, MCP server URL के रूप में ऊपर निर्देशिका से एक टूलसेट, उदाहरण:
https://api.wink.travel/mcp/link-managerफिर Continue पर क्लिक करें।
-
Claude Wink के साइन-इन का पता लगाता है। Authentication: Sign in now और OAuth client: Register automatically रखें, फिर Add पर क्लिक करें।
-
Connect पर क्लिक करें। एक Wink साइन-इन पेज
https://iam.wink.travelपर खुलता है। Wink में साइन इन करें और सहमति स्क्रीन पर अनुमतियाँ मंजूर करें। -
अब कनेक्टर के टूल्स आपकी चैट्स में उपलब्ध हैं। अपने काम के लिए आवश्यक प्रत्येक टूलसेट के लिए दोहराएं; प्रत्येक अपना कनेक्टर होता है।
-
सुनिश्चित करें कि Claude Code अपडेटेड है:
टर्मिनल विंडो npm install -g @anthropic-ai/claude-code -
ऊपर निर्देशिका से एक टूलसेट चुनें और जोड़ें। उदाहरण के लिए, कीमतें और उपलब्धता:
टर्मिनल विंडो claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code सर्वर से संपर्क करता है, ऑथराइजेशन सर्वर खोजता है, और आपका डिफ़ॉल्ट ब्राउज़र खोलता है।
-
Wink में साइन इन करें और सहमति स्क्रीन पर अनुमति अनुरोध को मंजूरी दें।
-
Claude Code कनेक्शन की पुष्टि करता है। सर्वर दिखने और टूल्स लोड होने की जांच के लिए
/mcpटाइप करें।
अपने काम के लिए जितने टूलसेट्स चाहिए उतने जोड़ें — प्रत्येक एक अलग सर्वर एंट्री है जिसका अपना नाम होता है:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpआप केवल एक बार साइन इन करते हैं। पहली बार ब्राउज़र अनुमोदन के बाद, Claude Code अतिरिक्त Wink एंडपॉइंट्स के लिए आपका Wink सेशन पुनः उपयोग करता है।
-
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
- macOS:
-
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"}}} -
Claude Desktop को पूरी तरह से बंद करें और पुनः शुरू करें (मेनू बार से Quit करें — केवल विंडो बंद करना पर्याप्त नहीं है)।
-
Claude Desktop हर नए सर्वर के लिए ब्राउज़र टैब खोलता है। Wink में साइन इन करें और अनुमतियाँ मंजूर करें।
-
नीचे टूलबार में प्लग आइकन दोनों सर्वरों को कनेक्टेड दिखाता है।
-
सुनिश्चित करें कि Codex CLI इंस्टॉल है:
टर्मिनल विंडो npm install -g @openai/codex -
Codex कॉन्फ़िग फ़ाइल खोलें (या बनाएं):
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
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"}}} -
Codex शुरू करें। पहली बार उपयोग पर, Codex
https://iam.wink.travelपर ब्राउज़र टैब खोलता है। -
Wink में साइन इन करें और अनुरोधित अनुमतियाँ मंजूर करें।
-
Codex कनेक्शन की पुष्टि करता है।
codexचलाएं और उपलब्ध टूल्स की सूची पूछें ताकि Wink सर्वर सक्रिय हों यह जांच सकें।
MCP सर्वर समर्थन ChatGPT डेस्कटॉप ऐप में Plus, Pro, Team, और Enterprise सब्सक्राइबर्स के लिए उपलब्ध है।
-
यदि आपने अभी तक डाउनलोड नहीं किया है, तो ChatGPT डेस्कटॉप ऐप डाउनलोड और इंस्टॉल करें।
-
ऐप खोलें और ऊपर-दाएँ कोने में अपनी प्रोफ़ाइल आइकन पर क्लिक करें, फिर Settings चुनें।
-
Connectors (या आपके ऐप संस्करण के अनुसार MCP Servers) पर जाएं और Add पर क्लिक करें।
-
ऊपर निर्देशिका से एक टूलसेट URL दर्ज करें, उदाहरण:
https://api.wink.travel/mcp/extranet/ratesफिर Connect पर क्लिक करें।
-
ChatGPT
https://iam.wink.travelपर ब्राउज़र टैब खोलता है। Wink में साइन इन करें और अनुमतियाँ मंजूर करें। -
अपने काम के लिए आवश्यक किसी भी अन्य टूलसेट के लिए चरण 4–5 दोहराएं, उदाहरण:
https://api.wink.travel/mcp/extranet/operations -
प्रत्येक टूलसेट आपके Connectors सूची में दिखाई देगा। नई चैट शुरू करें — Wink टूल्स स्वचालित रूप से उपलब्ध होंगे।
-
Cursor MCP कॉन्फ़िग फ़ाइल खोलें (या बनाएं):
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
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"}}} -
Cursor खोलें। Settings → Cursor Settings → MCP पर जाएं और दोनों सर्वर हरे स्थिति संकेतक के साथ दिखें यह पुष्टि करें। यदि वे लाल दिखें, तो Refresh पर क्लिक करें।
-
Cursor
https://iam.wink.travelपर ब्राउज़र टैब खोलता है। Wink में साइन इन करें और अनुमतियाँ मंजूर करें। -
एक चैट खोलें (
Ctrl+L/Cmd+L) और कनेक्शन पुष्टि के लिए उपलब्ध Wink टूल्स की सूची पूछें।
-
Windsurf MCP कॉन्फ़िग फ़ाइल खोलें (या बनाएं):
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
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"}}} -
Windsurf को पूरी तरह से पुनः शुरू करें (File → Quit, फिर पुनः खोलें)।
-
Settings → MCP Servers पर जाएं और दोनों सर्वर कनेक्टेड दिखें यह जांचें। Windsurf पहली बार उपयोग पर
https://iam.wink.travelपर ब्राउज़र टैब खोलता है। -
Wink में साइन इन करें और अनुमतियाँ मंजूर करें। प्रमाणीकरण के बाद सर्वर सेटिंग्स पैनल में हरे हो जाएंगे।
Cline एक VS Code एक्सटेंशन है जिसमें बिल्ट-इन MCP सर्वर मैनेजर है। मैनुअल JSON संपादन की जरूरत नहीं।
-
VS Code मार्केटप्लेस से Cline इंस्टॉल करें:
- VS Code खोलें और
Ctrl+Shift+X/Cmd+Shift+Xदबाएं - Cline खोजें और Install पर क्लिक करें
- VS Code खोलें और
-
एक्टिविटी बार (बाएँ साइडबार) में Cline आइकन पर क्लिक करें ताकि Cline पैनल खुले।
-
Cline टूलबार में MCP Servers आइकन (प्लग आइकन) पर क्लिक करें, फिर Edit MCP Settings चुनें।
-
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"}}} -
फ़ाइल सहेजें। Cline स्वतः रीलोड होता है और
https://iam.wink.travelपर ब्राउज़र टैब खोलता है। -
Wink में साइन इन करें और अनुमतियाँ मंजूर करें। दोनों सर्वर MCP Servers पैनल में सक्रिय दिखेंगे।
स्कोप्स
Section titled “स्कोप्स”जब आप सहमति स्क्रीन को मंजूर करते हैं तो आप देखेंगे कि एजेंट क्या अनुरोध कर रहा है। MCP क्लाइंट प्लेटफ़ॉर्म के बाकी हिस्सों के समान अनुमति शब्दावली का उपयोग करते हैं — पूर्ण स्कोप संदर्भ Authentication पेज पर देखें।
तीन बातें MCP के लिए विशिष्ट हैं:
mcp.readmcp.writemcp.removeस्कोप्स अतिरिक्त रूप से आवश्यक हैं MCP ट्रांसपोर्ट खोलने के लिए। जिन क्लाइंट्स के पासmcp.*स्कोप होता है, उन्हें किसी भी Wink MCP एंडपॉइंट में प्रवेश मिलता है, लेकिन हर टूल जो वे कॉल करते हैं, वह उस एंडपॉइंट के सेक्शन स्कोप को लागू करता है (जैसेbooking.read)।- MCP हमेशा एक साइन-इन उपयोगकर्ता के रूप में कार्य करता है। AI क्लाइंट
mcp.*स्कोप्स आपके साइन-इन के माध्यम से प्राप्त करता है, न कि आप द्वारा बनाए गए किसी एप्लिकेशन से। मशीन-टू-मशीन (क्लाइंट-क्रेडेंशियल) टोकन MCP ट्रांसपोर्ट नहीं खोल सकते; सर्वर-टू-सर्वर कार्य के लिए REST API का उपयोग करें। - AI क्लाइंट केवल आवश्यक स्कोप्स का अनुरोध करता है। आप सहमति स्क्रीन पर व्यक्तिगत अनुमतियाँ अस्वीकार कर सकते हैं — जिन टूल्स को अस्वीकृत स्कोप की जरूरत होती है, वे कॉल पर त्रुटि लौटाएंगे।
टूलसेट्स इनमें से कोई भी नहीं बदलते। आप जिस एंडपॉइंट से कनेक्ट करते हैं, वह तय करता है कि कौन से टूल सूचीबद्ध हैं, न कि वे क्या कर सकते हैं। /mcp/payment से कनेक्ट करने पर कोई वित्तीय अनुमति नहीं मिलती जो आपके पास पहले से न हो, और /mcp/reference से कनेक्ट करने पर भी वहां के टूल अपने स्कोप को लागू करते हैं। प्राधिकरण टोकन और आपके खाते के ग्रांट्स के आधार पर हर टूल कॉल पर तय होता है।
समस्या निवारण
Section titled “समस्या निवारण”ब्राउज़र टैब नहीं खुलता
आपका AI क्लाइंट इंटरैक्टिव PKCE फ्लो का समर्थन नहीं कर सकता। सुनिश्चित करें कि आप नवीनतम संस्करण चला रहे हैं:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT डेस्कटॉप: ऐप के बिल्ट-इन अपडेटर से अपडेट करें
साइन इन के बाद 401 Unauthorized
आपका कैश्ड टोकन पुराना हो सकता है। ताजा साइन-इन के लिए सर्वर को हटाएं और फिर जोड़ें:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpClaude 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
