Máy chủ MCP
Các công cụ MCP của Wink được xuất bản dưới dạng bộ công cụ — các điểm cuối tập trung, mỗi điểm bao phủ một công việc. Bạn kết nối khách hàng AI của mình với một hoặc hai bộ phù hợp với công việc, không phải tất cả.
Mỗi điểm cuối sử dụng đăng nhập OAuth2 tương tác (luồng mã ủy quyền PKCE): đại lý AI của bạn mở một tab trình duyệt, bạn đăng nhập bằng tài khoản Wink, và xong. Không cần quản lý bí mật khách hàng.
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 httpTại sao các công cụ được chia ra thành các điểm cuối
Phần tiêu đề “Tại sao các công cụ được chia ra thành các điểm cuối”Wink cung cấp khoảng 500 công cụ. Giao tất cả cho một đại lý cùng lúc về mặt kỹ thuật là có thể — nhưng là một ý tưởng tồi.
Định nghĩa công cụ tiêu tốn ngữ cảnh. Mỗi công cụ mà máy chủ MCP quảng bá được tải vào cửa sổ ngữ cảnh của mô hình trước khi nó thực hiện bất kỳ công việc nào, cùng với mô tả và toàn bộ sơ đồ tham số. Năm trăm công cụ như vậy chiếm một phần lớn ngân sách mà nhiệm vụ thực tế của bạn cần, ở mỗi yêu cầu.
Chất lượng lựa chọn giảm khi danh sách tăng. Một đại lý chọn từ 500 công cụ có tên tương tự sẽ đưa ra lựa chọn kém hơn so với một đại lý chọn từ 40 công cụ. Nếu bạn tích hợp một quản lý kênh, khoảng hai mươi công cụ liên quan đến bạn; 480 công cụ còn lại là nhiễu làm cho công cụ đúng khó tìm hơn.
Công việc thực sự có thể tách biệt. Người đồng bộ hóa tình trạng phòng từ PMS và người quản lý trang đích liên kết gần như không chia sẻ công cụ nào. Chia theo công việc có nghĩa mỗi kết nối mang từ vựng của một công việc.
Thư mục điểm cuối
Phần tiêu đề “Thư mục điểm cuối”Hai máy chủ phục vụ các bộ công cụ. Số lượng công cụ là ước lượng và tăng theo thời gian.
https://api.wink.travel — nền tảng
Phần tiêu đề “https://api.wink.travel — nền tảng”| Điểm cuối | Công cụ | Phạm vi |
|---|---|---|
/mcp/extranet/facilities | ~64 | Kho hàng có thể đặt và tại chỗ: phòng khách và loại phòng, spa, nhà hàng, phòng họp, hoạt động, điểm tham quan, địa điểm, các mặt hàng bán khác |
/mcp/extranet/property | ~62 | Hồ sơ tài sản và điều khoản thương mại: hồ sơ và nội dung, phụ kiện, chính sách hủy, ưu đãi, thông báo |
/mcp/settings | ~60 | Quản trị tài khoản: hồ sơ và thương hiệu thực thể quản lý, quản lý và quyền hạn, tùy chỉnh, webhook, tùy chọn thông báo |
/mcp/studio/embeds | ~48 | Xuất bản kho hàng được tuyển chọn: widget, lưới và lưới xếp hạng, thẻ, bản đồ, liên kết sâu đến kho hàng và trang nhà cung cấp |
/mcp/extranet/rates | ~44 | Giá và tình trạng: các khoảng thời gian và hạn mức giá kho hàng, kế hoạch giá, giá chính, giá đặc biệt và khuyến mãi |
/mcp/extranet/operations | ~39 | Vận hành tài sản trực tiếp: đặt phòng và vòng đời, đánh giá khách và phản hồi, nguồn cấp lịch, tác vụ theo lịch |
/mcp/extranet/distribution | ~37 | Nơi kho hàng được bán: kênh bán hàng và bộ điều chỉnh giá, yêu cầu quan hệ liên kết và nhà cung cấp, đăng ký, thu thập khách hàng tiềm năng |
/mcp/studio/curation | ~35 | Xây dựng bộ sưu tập có thể bán: danh sách tĩnh và động, danh sách xếp hạng, tìm kiếm đã lưu, tổng hợp tài sản |
/mcp/link-manager | ~28 | Bộ sưu tập liên kết được phân phối, thiết kế, danh mục và thẻ, cùng URL rút gọn |
/mcp/reference | ~24 | Dữ liệu tra cứu chỉ đọc: quốc gia, tiền tệ và tỷ giá, ngôn ngữ, múi giờ, tra cứu địa lý, định vị IP |
/mcp/analytics | ~18 | Phân tích đặt phòng và doanh thu: tổng quan, biểu đồ đường, bảng xếp hạng, hiệu suất liên kết, chỉ số chia sẻ |
/mcp/payment | ~18 | Hoạt động tài chính: sổ cái, rút tiền và ước tính phí, tổng hợp quỹ đặt phòng |
/mcp/booking-engine | ~17 | Lộ trình mua sắm dành cho khách du lịch: tìm kiếm và tra cứu, giỏ hàng và thanh toán, danh sách mong muốn, tùy chỉnh chiến dịch |
/mcp/social | ~17 | Tài khoản mạng xã hội kết nối, xuất bản và lên lịch bài đăng, đọc thông tin bài đăng |
/mcp/travel-agent | ~8 | Đặt phòng do đại lý thực hiện thay khách du lịch, và báo cáo đại lý |
https://integrations.wink.travel — tích hợp quản lý kênh
Phần tiêu đề “https://integrations.wink.travel — tích hợp quản lý kênh”Một điểm cuối, vì máy chủ này tồn tại cho một công việc duy nhất.
| Điểm cuối | Công cụ | Phạm vi |
|---|---|---|
/mcp/channel-manager | ~9 | Kết nối và xác minh tích hợp quản lý kênh, PMS hoặc CRS |
Mỗi điểm cuối cũng có một công cụ ping, để bạn xác nhận kết nối còn hoạt động trước khi yêu cầu thực hiện công việc thực.
Tôi cần bộ công cụ nào?
Phần tiêu đề “Tôi cần bộ công cụ nào?”| Nếu bạn là… | Kết nối tới |
|---|---|
| Tích hợp quản lý kênh, PMS hoặc CRS | integrations.wink.travel/mcp/channel-manager — chỉ điểm này |
| Quản lý nội dung tài sản | /mcp/extranet/property + /mcp/extranet/facilities |
| Quản lý phòng và loại phòng | /mcp/extranet/facilities |
| Quản lý giá và tình trạng | /mcp/extranet/rates |
| Vận hành đặt phòng hàng ngày | /mcp/extranet/operations |
| Phát triển phân phối | /mcp/extranet/distribution + /mcp/analytics |
| Xây dựng trang liên kết | /mcp/studio/curation + /mcp/studio/embeds |
| Vận hành trang link-in-bio | /mcp/link-manager + /mcp/social |
| Đặt phòng thay khách du lịch | /mcp/travel-agent |
| Đối soát tiền | /mcp/payment |
| Xây dựng trải nghiệm đặt phòng | /mcp/booking-engine + /mcp/reference |
Bắt đầu với một bộ. Thêm bộ khác khi bạn thấy mình cần thứ mà bộ đó không làm được — mỗi kết nối độc lập, và thêm một bộ không ảnh hưởng đến các bộ khác.
Cách xác thực hoạt động
Phần tiêu đề “Cách xác thực hoạt động”Máy chủ MCP của Wink sử dụng luồng OAuth2 Authorization Code + PKCE và hỗ trợ Đăng ký Khách hàng Động (RFC 7591). Đây là những gì xảy ra khi bạn kết nối lần đầu:
- Khách hàng AI của bạn phát hiện máy chủ ủy quyền từ siêu dữ liệu
/.well-known/oauth-protected-resourcecủa điểm cuối MCP. - Khách hàng tự đăng ký qua Đăng ký Khách hàng Động — không cần thiết lập ứng dụng thủ công.
- Khách hàng mở một tab trình duyệt tới
https://iam.wink.travel. Bạn đăng nhập bằng tài khoản Wink và phê duyệt quyền được yêu cầu trên màn hình đồng ý. - Wink cấp một token truy cập được giới hạn cho tài khoản của bạn và liên kết với danh tính của bạn.
- Khách hàng AI đính kèm token vào mọi yêu cầu MCP. Tất cả kết quả công cụ tự động giới hạn theo thực thể quản lý của bạn.
- Token hết hạn sau 3 giờ. Khách hàng AI của bạn làm mới token một cách im lặng trong nền mà không yêu cầu lại.
Mỗi cuộc gọi công cụ chạy dưới danh tính của bạn — các quy tắc ACL bảo vệ cổng web cũng áp dụng cho đại lý AI.
Kết nối khách hàng AI của bạn
Phần tiêu đề “Kết nối khách hàng AI của bạn”-
Đảm bảo Claude Code được cập nhật:
Terminal window npm install -g @anthropic-ai/claude-code -
Chọn một bộ công cụ từ thư mục ở trên và thêm nó. Ví dụ, giá và tình trạng:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code liên hệ máy chủ, phát hiện máy chủ ủy quyền, và mở trình duyệt mặc định của bạn.
-
Đăng nhập vào Wink và phê duyệt yêu cầu quyền trên màn hình đồng ý.
-
Claude Code xác nhận kết nối. Gõ
/mcpđể kiểm tra máy chủ xuất hiện và công cụ đã tải.
Thêm bao nhiêu bộ công cụ tùy công việc — mỗi bộ là một mục máy chủ riêng với tên riêng:
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 httpBạn chỉ đăng nhập một lần. Sau lần phê duyệt trình duyệt đầu tiên, Claude Code tái sử dụng phiên Wink của bạn cho các điểm cuối Wink khác.
-
Chỉnh sửa file cấu hình 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:
-
Thêm các mục máy chủ 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"}}} -
Thoát hoàn toàn và khởi động lại Claude Desktop (dùng Quit từ thanh menu — đóng cửa sổ không đủ).
-
Claude Desktop mở tab trình duyệt cho mỗi máy chủ mới. Đăng nhập vào Wink và phê duyệt quyền.
-
Biểu tượng phích cắm trên thanh công cụ dưới cùng hiển thị cả hai máy chủ đã kết nối.
-
Đảm bảo đã cài Codex CLI:
Terminal window npm install -g @openai/codex -
Mở (hoặc tạo) file cấu hình Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Thêm các mục máy chủ MCP của 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"}}} -
Khởi động Codex. Lần đầu sử dụng, Codex mở tab trình duyệt tới
https://iam.wink.travel. -
Đăng nhập vào Wink và phê duyệt quyền được yêu cầu.
-
Codex xác nhận kết nối. Chạy
codexvà yêu cầu liệt kê công cụ có sẵn để xác nhận máy chủ Wink hoạt động.
Hỗ trợ máy chủ MCP có trong ứng dụng ChatGPT desktop cho người đăng ký Plus, Pro, Team và Enterprise.
-
Tải và cài đặt ứng dụng ChatGPT desktop nếu bạn chưa có.
-
Mở ứng dụng và nhấp vào biểu tượng hồ sơ của bạn ở góc trên bên phải, sau đó chọn Cài đặt.
-
Vào Kết nối (hoặc Máy chủ MCP tùy phiên bản ứng dụng) và nhấp Thêm.
-
Nhập URL của một bộ công cụ từ thư mục ở trên, ví dụ:
https://api.wink.travel/mcp/extranet/ratesRồi nhấp Kết nối.
-
ChatGPT mở tab trình duyệt tới
https://iam.wink.travel. Đăng nhập vào Wink và phê duyệt quyền. -
Lặp lại bước 4–5 cho các bộ công cụ khác bạn cần, ví dụ:
https://api.wink.travel/mcp/extranet/operations -
Mỗi bộ công cụ xuất hiện trong danh sách Kết nối của bạn. Bắt đầu cuộc trò chuyện mới — công cụ Wink tự động có sẵn.
-
Mở (hoặc tạo) file cấu hình MCP của Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Thêm các mục máy chủ MCP của 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"}}} -
Mở Cursor. Vào Cài đặt → Cài đặt Cursor → MCP và xác nhận cả hai máy chủ hiển thị với chỉ báo trạng thái màu xanh. Nếu đỏ, nhấp Làm mới.
-
Cursor mở tab trình duyệt tới
https://iam.wink.travel. Đăng nhập vào Wink và phê duyệt quyền. -
Mở cuộc trò chuyện (
Ctrl+L/Cmd+L) và yêu cầu Cursor liệt kê công cụ Wink có sẵn để xác nhận kết nối.
-
Mở (hoặc tạo) file cấu hình MCP của Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Thêm các mục máy chủ MCP của 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"}}} -
Khởi động lại hoàn toàn Windsurf (File → Quit, rồi mở lại).
-
Vào Cài đặt → Máy chủ MCP và xác nhận cả hai máy chủ hiển thị là đã kết nối. Windsurf mở tab trình duyệt tới
https://iam.wink.travellần đầu sử dụng. -
Đăng nhập vào Wink và phê duyệt quyền. Máy chủ chuyển sang màu xanh trong bảng cài đặt khi xác thực thành công.
Cline là tiện ích mở rộng VS Code với trình quản lý máy chủ MCP tích hợp. Không cần chỉnh sửa JSON thủ công.
-
Cài đặt Cline từ Marketplace VS Code:
- Mở VS Code và nhấn
Ctrl+Shift+X/Cmd+Shift+X - Tìm Cline và nhấp Cài đặt
- Mở VS Code và nhấn
-
Nhấp biểu tượng Cline trên Thanh hoạt động (thanh bên trái) để mở bảng Cline.
-
Nhấp biểu tượng Máy chủ MCP (biểu tượng phích cắm) trên thanh công cụ Cline, rồi chọn Chỉnh sửa Cài đặt MCP.
-
VS Code mở
cline_mcp_settings.json. Thêm các mục của 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"}}} -
Lưu file. Cline tự động tải lại và mở tab trình duyệt tới
https://iam.wink.travel. -
Đăng nhập vào Wink và phê duyệt quyền. Cả hai máy chủ hiển thị hoạt động trong bảng Máy chủ MCP.
Phạm vi
Phần tiêu đề “Phạm vi”Khi bạn phê duyệt màn hình đồng ý, bạn sẽ thấy phân tích những gì đại lý yêu cầu. Khách hàng MCP sử dụng cùng từ vựng quyền như phần còn lại của nền tảng — xem đầy đủ tham chiếu phạm vi trên trang Xác thực.
Hai điểm đặc thù của MCP:
- Phạm vi
mcp.readmcp.writemcp.removecũng được yêu cầu để mở giao thức MCP. Khách hàng có phạm vimcp.*được phép truy cập bất kỳ điểm cuối MCP Wink nào, nhưng mỗi công cụ nó gọi vẫn thực thi phạm vi phần của điểm cuối mà nó bao bọc (ví dụbooking.read). - Khách hàng AI chỉ yêu cầu phạm vi cần thiết. Bạn có thể từ chối từng quyền trên màn hình đồng ý — công cụ yêu cầu phạm vi bị từ chối sẽ trả lỗi khi gọi.
Bộ công cụ không thay đổi điều này. Điểm cuối bạn kết nối quyết định công cụ nào được liệt kê, không phải công cụ được cho phép làm gì. Kết nối tới /mcp/payment không cấp thêm quyền tài chính bạn chưa có, và kết nối tới /mcp/reference không ngăn công cụ ở đó thực thi phạm vi riêng. Ủy quyền được quyết định theo từng cuộc gọi công cụ, dựa trên token và quyền tài khoản của bạn.
Khắc phục sự cố
Phần tiêu đề “Khắc phục sự cố”Tab trình duyệt không mở
Khách hàng AI của bạn có thể chưa hỗ trợ luồng PKCE tương tác. Xác nhận bạn đang chạy phiên bản mới:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT desktop: cập nhật qua trình cập nhật tích hợp trong ứng dụng
401 Unauthorized sau khi đăng nhập
Token lưu cache có thể đã hết hạn. Xóa và thêm lại máy chủ để kích hoạt đăng nhập mới:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpVới Claude Desktop và ChatGPT, xóa mục máy chủ trong cài đặt, khởi động lại ứng dụng, rồi thêm lại.
403 Forbidden khi gọi công cụ cụ thể
Công cụ yêu cầu phạm vi bạn không phê duyệt trên màn hình đồng ý, hoặc quyền tài khoản bạn không có. Kết nối lại máy chủ — màn hình đồng ý sẽ hiện lại và bạn có thể phê duyệt quyền thiếu. Nếu vẫn lỗi, công cụ cần quyền tài khoản bạn không có; kết nối bộ công cụ khác không giúp được vì bộ công cụ không cấp quyền.
Công cụ tôi cần không có trong danh sách
Bạn có thể đang kết nối bộ công cụ không bao phủ công việc đó. Kiểm tra thư mục điểm cuối và thêm bộ công cụ phù hợp — các kết nối độc lập, thêm bộ không ảnh hưởng bộ khác. Nếu không chắc bộ nào có, tạm kết nối https://api.wink.travel/mcp, tìm công cụ, rồi tra cứu bộ công cụ liệt kê nó.
404 Not Found trên điểm cuối bộ công cụ
Kiểm tra kỹ đường dẫn — các bộ công cụ lồng có hai đoạn (/mcp/extranet/rates, không phải /mcp/extranet-rates), các bộ phẳng có một đoạn (/mcp/link-manager). Lưu ý yêu cầu chưa xác thực tới bất kỳ đường dẫn nào dưới /mcp trả 401, không phải 404, nên chỉ 401 không cho biết điểm cuối có tồn tại hay không.
Tôi kết nối api.wink.travel/mcp/channel-manager mà không có gì
Điểm cuối đó không tồn tại. Tích hợp quản lý kênh chỉ phục vụ từ https://integrations.wink.travel/mcp/channel-manager. Nếu bạn cần đọc hoặc ghi giá riêng của tài sản bằng tay, đó là công việc riêng trên điểm cuối riêng — xem /mcp/extranet/rates.
Máy chủ xuất hiện nhưng cuộc gọi công cụ trả “account not found”
Bạn đăng nhập tài khoản Wink không có thực thể quản lý. Vào Wink Portal và đảm bảo tài khoản được thiết lập trước khi dùng máy chủ MCP.
Token hết hạn giữa phiên
Token có hiệu lực 3 giờ. Claude Code và Claude Desktop làm mới token im lặng mà không gián đoạn phiên. Nếu thấy lỗi xác thực sau thời gian không hoạt động dài, gõ tin nhắn mới — khách hàng sẽ tự động xác thực lại.
Codex CLI báo “MCP server unreachable”
Kiểm tra file ~/.codex/config.json là JSON hợp lệ (không dấu phẩy thừa) và "type": "http" được đặt. Codex yêu cầu giao thức HTTP cho máy chủ từ xa; giao thức stdio chỉ cho nhị phân cục bộ.
Menu “Connectors” của ChatGPT không có
Hỗ trợ MCP yêu cầu ứng dụng ChatGPT desktop phiên bản 1.2024.352 trở lên và đăng ký Plus, Pro, Team hoặc Enterprise còn hiệu lực. Cập nhật ứng dụng và kiểm tra gói trong Cài đặt → Tài khoản.
Máy chủ Cursor hiển thị đỏ / “Failed to connect”
Xác nhận file ~/.cursor/mcp.json là JSON hợp lệ và có "type": "http". Vào Cài đặt → Cài đặt Cursor → MCP và nhấp Làm mới. Nếu lỗi vẫn còn, khởi động lại hoàn toàn Cursor — thay đổi cấu hình không phải lúc nào cũng được nhận mà không khởi động lại.
Máy chủ MCP Windsurf không hiển thị trong cài đặt
Windsurf yêu cầu khởi động lại hoàn toàn (không chỉ tải lại cửa sổ) để nhận thay đổi mcp_config.json. Dùng File → Quit rồi mở lại. Nếu máy chủ vẫn không xuất hiện, xác nhận bạn đang dùng Windsurf 1.4+ qua Trợ giúp → Giới thiệu về Windsurf.
Tùy chọn “Add Server” của Cline không thấy
Trình quản lý máy chủ MCP yêu cầu Cline 2.0 trở lên. Mở bảng Tiện ích mở rộng VS Code, tìm Cline, và nhấp Cập nhật nếu có. Sau khi cập nhật, tải lại VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Mở Wink Portal Wink trên GitHub
