Bỏ qua để đến nội dung

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.

Một tích hợp quản lý kênh kết nối tới một điểm cuối
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Một chủ khách sạn quản lý giá của họ kết nối tới điểm cuối khác
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Tạ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.


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.

Điểm cuốiCông cụPhạm vi
/mcp/extranet/facilities~64Kho 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~62Hồ 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~60Quả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~48Xuấ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~44Giá 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~39Vậ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~37Nơ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~35Xâ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~28Bộ 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~24Dữ 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~18Phâ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~18Hoạ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~17Lộ 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~17Tà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ốiCông cụPhạm vi
/mcp/channel-manager~9Kế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.


Nếu bạn là…Kết nối tới
Tích hợp quản lý kênh, PMS hoặc CRSintegrations.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.


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:

  1. 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-resource của điểm cuối MCP.
  2. 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.
  3. 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 ý.
  4. 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.
  5. 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.
  6. 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.


  1. Đảm bảo Claude Code được cập nhật:

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. 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
  3. 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.

  4. Đăng nhập vào Wink và phê duyệt yêu cầu quyền trên màn hình đồng ý.

  5. 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:

Terminal window
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport http

Bạ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.


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.read mcp.write mcp.remove cũng được yêu cầu để mở giao thức MCP. Khách hàng có phạm vi mcp.* đượ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.


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:

Terminal window
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Vớ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