MCP सर्वर

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

सर्वर	URL	यह क्या करता है
Inventory API	https://api.wink.travel/mcp	इन्वेंटरी, बुकिंग, रेट्स, सेल्स चैनल, एनालिटिक्स, और सभी प्लेटफ़ॉर्म ऑपरेशंस
Integrations	https://integrations.wink.travel/mcp	चैनल मैनेजर इंटीग्रेशन — OTAs के साथ प्रॉपर्टीज़, रेट्स, और उपलब्धता सिंक करें

---

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

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

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

3. Claude Code सर्वर से संपर्क करता है, ऑथराइजेशन सर्वर खोजता है, और आपका डिफ़ॉल्ट ब्राउज़र खोलता है।

4. Wink में साइन इन करें और सहमति स्क्रीन पर अनुमति अनुरोध को मंजूरी दें।

5. Claude Code कनेक्शन की पुष्टि करता है। /mcp टाइप करें यह सत्यापित करने के लिए कि सर्वर दिखाई दे रहा है और इसके टूल लोड हो गए हैं।

इंटीग्रेशन सर्वर भी जोड़ने के लिए:

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

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

claude mcp add में --scope project जोड़ें और 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-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. Wink MCP सर्वर प्रविष्टियाँ जोड़ें:

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

टिप्पणी

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. Wink Inventory सर्वर URL दर्ज करें:

   https://api.wink.travel/mcp

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

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

6. इंटीग्रेशन सर्वर के लिए चरण 4–5 दोहराएं:

   https://integrations.wink.travel/mcp

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

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

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-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 पैनल में, Add Server पर क्लिक करें और सीधे https://api.wink.travel/mcp पेस्ट करें। Cline कॉन्फ़िग को स्वचालित रूप से भरता है और JSON संपादन के बिना प्रमाणीकरण संभालता है।

---

स्कोप्स

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

MCP के लिए दो विशेष बातें हैं:

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

---

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

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

आपका 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-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 सर्वर का उपयोग करें।

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

टोकन 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