เซิร์ฟเวอร์ MCP
เครื่องมือ MCP ของ Wink ถูกเผยแพร่เป็น ชุดเครื่องมือ — จุดเชื่อมต่อที่เน้นงานเฉพาะแต่ละงาน คุณเชื่อมต่อไคลเอนต์ AI ของคุณกับหนึ่งหรือสองชุดที่ตรงกับงานของคุณ ไม่ใช่ทั้งหมด
ทุกจุดเชื่อมต่อใช้ การเข้าสู่ระบบ OAuth2 แบบโต้ตอบ (PKCE authorization code flow): เอเจนต์ 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ทำไมเครื่องมือจึงถูกแยกเป็นหลายจุดเชื่อมต่อ
หัวข้อที่มีชื่อว่า “ทำไมเครื่องมือจึงถูกแยกเป็นหลายจุดเชื่อมต่อ”Wink เปิดเผยเครื่องมือประมาณ 500 รายการ การส่งมอบทั้งหมดให้เอเจนต์ในครั้งเดียวเป็นไปได้ทางเทคนิค — แต่เป็นความคิดที่ไม่ดี
คำจำกัดความของเครื่องมือใช้บริบท เครื่องมือแต่ละรายการที่เซิร์ฟเวอร์ MCP โฆษณาจะถูกโหลดเข้าไปในหน้าต่างบริบทของโมเดลก่อนที่จะทำงานใด ๆ พร้อมคำอธิบายและโครงสร้างพารามิเตอร์เต็มรูปแบบ เครื่องมือห้าร้อยรายการเหล่านี้ใช้ส่วนแบ่งงบประมาณจำนวนมากที่งานจริงของคุณต้องการ ในทุกคำขอ
คุณภาพการเลือกลดลงเมื่อรายการยาวขึ้น เอเจนต์ที่เลือกจากเครื่องมือ 500 รายการที่มีชื่อคล้ายกันจะเลือกได้แย่กว่าเอเจนต์ที่เลือกจาก 40 รายการ หากคุณรวมระบบจัดการช่องทาง ประมาณยี่สิบเครื่องมือจะเกี่ยวข้องกับคุณ ส่วนอีก 480 รายการเป็นเสียงรบกวนที่ทำให้เครื่องมือที่ถูกต้องหายากขึ้น
งานแยกจากกันได้จริง คนที่ซิงค์ความพร้อมใช้งานจาก PMS กับคนที่ดูแลหน้าแอฟฟิลิเอตแทบจะไม่แชร์เครื่องมือกันเลย การแยกตามงานหมายความว่าการเชื่อมต่อแต่ละครั้งมีคำศัพท์ของงานหนึ่งงาน
ไดเรกทอรีจุดเชื่อมต่อ
หัวข้อที่มีชื่อว่า “ไดเรกทอรีจุดเชื่อมต่อ”มีโฮสต์สองแห่งให้บริการชุดเครื่องมือ จำนวนเครื่องมือเป็นค่าประมาณและเพิ่มขึ้นตามเวลา
https://api.wink.travel — แพลตฟอร์ม
หัวข้อที่มีชื่อว่า “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 — การรวมระบบจัดการช่องทาง
หัวข้อที่มีชื่อว่า “https://integrations.wink.travel — การรวมระบบจัดการช่องทาง”มีจุดเชื่อมต่อเดียว เพราะโฮสต์นี้มีไว้สำหรับงานเดียว
| จุดเชื่อมต่อ | จำนวนเครื่องมือ | ครอบคลุมอะไร |
|---|---|---|
/mcp/channel-manager | ~9 | การเชื่อมต่อและตรวจสอบระบบจัดการช่องทาง, PMS หรือการรวม CRS |
ทุกจุดเชื่อมต่อยังมีเครื่องมือ ping เพื่อให้คุณยืนยันได้ว่าการเชื่อมต่อยังใช้งานได้ก่อนที่จะให้ทำงานจริง
การชำระเงินแบบ Agentic
หัวข้อที่มีชื่อว่า “การชำระเงินแบบ Agentic”สำหรับกระบวนการจองนักเดินทางครบวงจร ให้เชื่อมต่อ Wink Booking Engine ที่ https://api.wink.travel/mcp/booking-engine และ กระเป๋าเงินที่รองรับ การเพิ่ม MCP ของ Wink จะเปิดการเข้าสู่ระบบผ่านเบราว์เซอร์และการเลือกสิทธิ์ จากนั้นไคลเอนต์ของคุณจะจัดการการตรวจสอบสิทธิ์
Booking Engine รวมการค้นหาปลายทาง, การค้นหาโรงแรมและห้องพัก, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, การดึงข้อมูลการจองและใบเสร็จ เมื่อเปิดใช้งานการจองและชำระเงินแบบ agentic สำหรับสภาพแวดล้อมนั้น ดู 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 สำหรับการค้นหาเสริม |
Booking Engine รวมเวิร์กโฟลว์การจองหลัก มันให้การค้นหาบัญชีและการปรับแต่ง, การค้นหาปลายทาง, ความพร้อมใช้งานโรงแรมและรายละเอียดอัตราห้อง, รถเข็นสินค้า, การชำระเงิน และการจัดการการจองของนักเดินทาง เครื่องมือการจองและชำระเงินแบบ agentic ก็ถูกรวมไว้เมื่อเปิดใช้งานสำหรับสภาพแวดล้อมนั้น
สำหรับการค้นหาโรงแรมในเมือง ให้ใช้ destination_lookup_search_suggestions เพื่อแก้ไขปลายทาง จากนั้นใช้ inventory_search_city เพื่อค้นหาโรงแรมและอัตราที่มี ทั้งสองเครื่องมือนี้อยู่ใน /mcp/booking-engine ดังนั้นกระบวนการนี้ไม่ต้องเชื่อมต่อกับ Reference
เพิ่ม /mcp/reference เมื่อคุณต้องการการค้นหาสนับสนุน เช่น ประเทศ, สกุลเงินและอัตราแลกเปลี่ยน, ภาษา, เขตเวลา, การค้นหาทางภูมิศาสตร์ที่กว้างขึ้น, การจัดประเภท OTA หรือความรู้สาธารณะเกี่ยวกับทรัพย์สิน เหล่านี้เป็นส่วนเสริมที่ไม่บังคับสำหรับเวิร์กโฟลว์การจอง
เริ่มต้นด้วยชุดเดียว เพิ่มอีกชุดเมื่อคุณพบว่าต้องการสิ่งที่ชุดนั้นทำไม่ได้ — การเชื่อมต่อแต่ละชุดเป็นอิสระ และการเพิ่มชุดหนึ่งไม่ส่งผลต่อชุดอื่น
วิธีการทำงานของการตรวจสอบสิทธิ์
หัวข้อที่มีชื่อว่า “วิธีการทำงานของการตรวจสอบสิทธิ์”เซิร์ฟเวอร์ MCP ของ Wink ใช้โฟลว์ OAuth2 Authorization Code + PKCE และรองรับ Dynamic Client Registration (RFC 7591) นี่คือสิ่งที่จะเกิดขึ้นเมื่อคุณเชื่อมต่อครั้งแรก:
- ไคลเอนต์ AI ของคุณค้นหาเซิร์ฟเวอร์การอนุญาตจากเมตาดาต้า
/.well-known/oauth-protected-resourceของจุดเชื่อมต่อ MCP - ไคลเอนต์ลงทะเบียนตัวเองผ่าน Dynamic Client Registration — ไม่ต้องตั้งค่าแอปพลิเคชันด้วยตนเอง
- ไคลเอนต์เปิด แท็บเบราว์เซอร์ ไปที่
https://iam.wink.travelคุณลงชื่อเข้าใช้ด้วยบัญชี Wink และอนุมัติสิทธิ์ที่ร้องขอบนหน้าจอการยินยอม - Wink ออก โทเค็นเข้าถึง ที่มีขอบเขตสำหรับบัญชีของคุณและเชื่อมโยงกับตัวตนของคุณ
- ไคลเอนต์ AI แนบโทเค็นกับคำขอ MCP ทุกคำขอ ผลลัพธ์ของเครื่องมือทั้งหมดจะถูกจำกัดตามหน่วยงานจัดการของคุณโดยอัตโนมัติ
- โทเค็นหมดอายุหลัง 3 ชั่วโมง ไคลเอนต์ AI ของคุณจะรีเฟรชโทเค็นเงียบ ๆ ในเบื้องหลังโดยไม่ต้องแจ้งเตือนอีกครั้ง
การเรียกใช้เครื่องมือทุกครั้งจะทำงาน ภายใต้ตัวตนของคุณ — กฎ ACL เดียวกับที่ปกป้องพอร์ทัลเว็บจะใช้กับเอเจนต์ AI
เชื่อมต่อไคลเอนต์ AI ของคุณ
หัวข้อที่มีชื่อว่า “เชื่อมต่อไคลเอนต์ AI ของคุณ”เพิ่มชุดเครื่องมือแต่ละชุดใน Claude เป็นตัวเชื่อมต่อแบบกำหนดเอง ไม่มีไฟล์ config ให้แก้ไขและไม่ต้องสร้างแอปพลิเคชันหรือความลับใด ๆ
-
ใน 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 เป็นเวอร์ชันล่าสุด:
Terminal window npm install -g @anthropic-ai/claude-code -
เลือกชุดเครื่องมือจาก ไดเรกทอรีด้านบน แล้วเพิ่ม เช่น ราคากับความพร้อมใช้งาน:
Terminal window 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 เพิ่มเติม
-
แก้ไขไฟล์ config ของ 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"}}} -
ออกจากโปรแกรมและเปิดใหม่อย่างสมบูรณ์ (ใช้ Quit จากเมนูบาร์ — ปิดหน้าต่างอย่างเดียวไม่พอ)
-
Claude Desktop จะเปิดแท็บเบราว์เซอร์สำหรับแต่ละเซิร์ฟเวอร์ใหม่ ลงชื่อเข้าใช้ Wink และอนุมัติสิทธิ์
-
ไอคอนปลั๊กในแถบเครื่องมือด้านล่างจะแสดงสถานะเชื่อมต่อของทั้งสองเซิร์ฟเวอร์
-
ตรวจสอบให้แน่ใจว่า Codex CLI ติดตั้งแล้ว:
Terminal window npm install -g @openai/codex -
เปิด (หรือสร้าง) ไฟล์ config ของ Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
เพิ่มรายการเซิร์ฟเวอร์ MCP ของ Wink:
~/.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 จะพร้อมใช้งานโดยอัตโนมัติ
-
เปิด (หรือสร้าง) ไฟล์ config MCP ของ Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
เพิ่มรายการเซิร์ฟเวอร์ MCP ของ Wink:
~/.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) และขอให้ Cursor แสดงรายการเครื่องมือ Wink ที่มีเพื่อยืนยันการเชื่อมต่อ
-
เปิด (หรือสร้าง) ไฟล์ config MCP ของ Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
เพิ่มรายการเซิร์ฟเวอร์ MCP ของ Wink:
~/.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 ด้วยตนเอง
-
ติดตั้ง Cline จาก VS Code Marketplace:
- เปิด VS Code แล้วกด
Ctrl+Shift+X/Cmd+Shift+X - ค้นหา Cline แล้วคลิก Install
- เปิด VS Code แล้วกด
-
คลิก ไอคอน Cline ในแถบกิจกรรม (แถบด้านข้างซ้าย) เพื่อเปิดแผง Cline
-
คลิกไอคอน MCP Servers (ไอคอนปลั๊ก) ในแถบเครื่องมือ Cline แล้วเลือก 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
ขอบเขตสิทธิ์
หัวข้อที่มีชื่อว่า “ขอบเขตสิทธิ์”เมื่อคุณอนุมัติหน้าจอการยินยอม คุณจะเห็นรายละเอียดว่าตัวแทนขออะไรบ้าง MCP ไคลเอนต์ใช้คำศัพท์สิทธิ์เดียวกับแพลตฟอร์มทั้งหมด — ดูรายการ ขอบเขตสิทธิ์เต็มรูปแบบในหน้าการตรวจสอบสิทธิ์
สามสิ่งที่เฉพาะเจาะจงสำหรับ MCP:
- ขอบเขต
mcp.readmcp.writemcp.removeจำเป็นเพิ่มเติม เพื่อเปิดการขนส่ง MCP ไคลเอนต์ที่ถือขอบเขตmcp.*จะได้รับอนุญาตให้เข้าถึงจุดเชื่อมต่อ MCP ของ Wink ใดก็ได้ แต่เครื่องมือที่เรียกใช้ยังคงบังคับใช้ขอบเขตของส่วนที่จุดเชื่อมต่อนั้นครอบคลุม (เช่นbooking.read) - MCP ทำงานเสมอในฐานะผู้ใช้ที่ลงชื่อเข้าใช้ ไคลเอนต์ AI ได้รับขอบเขต
mcp.*ผ่านการลงชื่อเข้าใช้ของคุณ ไม่ใช่จาก Application ที่คุณสร้าง โทเค็นแบบเครื่องต่อเครื่อง (client-credentials) ไม่สามารถเปิดการขนส่ง MCP ได้ ให้ใช้ REST API สำหรับงานเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ - ไคลเอนต์ 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 desktop: อัปเดตจากตัวอัปเดตในแอป
401 Unauthorized หลังจากลงชื่อเข้าใช้
โทเค็นที่แคชไว้อาจหมดอายุ ลบและเพิ่มเซิร์ฟเวอร์ใหม่เพื่อกระตุ้นการลงชื่อเข้าใช้ใหม่:
# Claude Codeclaude mcp remove wink-ratesclaude 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 สำหรับไบนารีในเครื่องเท่านั้น
เมนู “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 อย่างสมบูรณ์ — การเปลี่ยนแปลง config บางครั้งไม่ถูกนำมาใช้จนกว่าจะรีสตาร์ท
เซิร์ฟเวอร์ MCP ของ Windsurf ไม่แสดงในการตั้งค่า
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
