เซิร์ฟเวอร์ MCP

Wink เปิดเผยเซิร์ฟเวอร์ MCP ที่ผ่านการรับรองตัวตนสองตัว ทั้งสองใช้ การเข้าสู่ระบบ OAuth2 แบบโต้ตอบ (PKCE authorization code flow) — เอเจนต์ AI ของคุณจะเปิดแท็บเบราว์เซอร์เพื่อให้คุณลงชื่อเข้าใช้ด้วยบัญชี Wink ของคุณ ไม่มีความลับของไคลเอนต์ให้จัดการ

เซิร์ฟเวอร์	URL	ทำอะไรได้บ้าง
Inventory API	https://api.wink.travel/mcp	สินค้าคงคลัง การจอง อัตรา ช่องทางการขาย การวิเคราะห์ และการดำเนินการทั้งหมดบนแพลตฟอร์ม
Integrations	https://integrations.wink.travel/mcp	การผสานรวมผู้จัดการช่องทาง — ซิงค์ที่พัก อัตรา และความพร้อมใช้งานกับ OTA

---

วิธีการทำงานของการรับรองตัวตน

เซิร์ฟเวอร์ MCP ของ Wink ใช้โฟลว์ OAuth2 Authorization Code + PKCE และรองรับ Dynamic Client Registration (RFC 7591) นี่คือสิ่งที่จะเกิดขึ้นเมื่อคุณเชื่อมต่อครั้งแรก:

1. ไคลเอนต์ AI ของคุณค้นหาเซิร์ฟเวอร์การอนุญาตจากเมตาดาต้า /.well-known/oauth-protected-resource ของจุดสิ้นสุด MCP
2. ไคลเอนต์ลงทะเบียนตัวเองผ่าน Dynamic Client Registration — ไม่ต้องตั้งค่าแอปพลิเคชันด้วยตนเอง
3. ไคลเอนต์เปิด แท็บเบราว์เซอร์ ไปที่ https://iam.wink.travel คุณลงชื่อเข้าใช้ด้วยบัญชี Wink ของคุณและอนุมัติสิทธิ์ที่ร้องขอบนหน้าจอการยินยอม
4. Wink ออก access token ที่มีขอบเขตสำหรับบัญชีของคุณและเชื่อมโยงกับตัวตนของคุณ
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 เพื่อตรวจสอบว่าเซิร์ฟเวอร์ปรากฏและเครื่องมือโหลดเรียบร้อยแล้ว

หากต้องการเพิ่มเซิร์ฟเวอร์ Integrations ด้วย:

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

แชร์กับทีมของคุณ

เพิ่ม --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-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 ทำงานอยู่

หมายเหตุ

การรองรับ MCP ของ Codex CLI ต้องใช้เวอร์ชัน 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 เซิร์ฟเวอร์ Wink Inventory:

   https://api.wink.travel/mcp

   แล้วคลิก Connect

5. ChatGPT จะเปิดแท็บเบราว์เซอร์ไปที่ https://iam.wink.travel ลงชื่อเข้าใช้ Wink และอนุมัติสิทธิ์

6. ทำซ้ำขั้นตอนที่ 4–5 สำหรับเซิร์ฟเวอร์ Integrations:

   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) และขอให้ Cursor แสดงรายการเครื่องมือ Wink ที่มีเพื่อยืนยันการเชื่อมต่อ

คอนฟิกแบบกำหนดขอบเขตโปรเจกต์

คุณสามารถวางไฟล์ mcp.json ที่โฟลเดอร์รากของโปรเจกต์แทนที่จะวางใน ~/.cursor/ คอนฟิกระดับโปรเจกต์จะมีลำดับความสำคัญและทำให้เซิร์ฟเวอร์พร้อมใช้งานสำหรับสมาชิกทีมทุกคนที่เปิดโปรเจกต์ใน 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 และอนุมัติสิทธิ์ เซิร์ฟเวอร์จะเปลี่ยนเป็นสีเขียวในแผงตั้งค่าหลังจากรับรองตัวตนแล้ว

หมายเหตุ

การรองรับ MCP ของ Windsurf ต้องใช้เวอร์ชัน 1.4 ขึ้นไป ตรวจสอบได้ที่ Help → About Windsurf และอัปเดตจากเว็บไซต์ Windsurf หากจำเป็น

Cline (VS Code)

Cline เป็นส่วนขยาย VS Code ที่มีตัวจัดการเซิร์ฟเวอร์ MCP ในตัว ไม่ต้องแก้ไข JSON ด้วยตนเอง

1. ติดตั้ง Cline จาก VS Code Marketplace:

   • เปิด VS Code และกด Ctrl+Shift+X / Cmd+Shift+X
   • ค้นหา Cline แล้วคลิก Install

2. คลิก ไอคอน Cline ที่แถบกิจกรรม (แถบด้านข้างซ้าย) เพื่อเปิดแผง Cline

3. คลิกไอคอน MCP Servers (ไอคอนปลั๊ก) ในแถบเครื่องมือ Cline แล้วเลือก 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 ใช้คำศัพท์สิทธิ์เดียวกับแพลตฟอร์มทั้งหมด — ดูรายการเต็มได้ที่ อ้างอิงขอบเขตในหน้าการรับรองตัวตน

สองสิ่งที่เฉพาะเจาะจงสำหรับ 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 desktop: อัปเดตจากตัวอัปเดตในแอป

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 ใช้สำหรับไบนารีในเครื่องเท่านั้น

เมนู “Connectors” ของ ChatGPT หายไป

การรองรับ 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

ตัวเลือก “Add Server” ของ Cline ไม่ปรากฏ

ตัวจัดการเซิร์ฟเวอร์ MCP ต้องใช้ Cline 2.0 ขึ้นไป เปิดแผงส่วนขยาย VS Code ค้นหา Cline และคลิก Update หากมีอัปเดต หลังอัปเดตให้โหลด VS Code ใหม่ (Ctrl+Shift+P → “Developer: Reload Window”)

---

เปิด Wink Portal Wink บน GitHub