Máy chủ MCP

Tổng quan

Máy chủ MCP Wink được lưu trữ có sẵn tại:

https://docs.mcp.wink.travel/mcp

Trỏ các khách hàng AI tương thích (VS Code, Cursor, các công cụ khác triển khai giao thức MCP HTTP) tới điểm cuối này để cho phép họ:

Duyệt tài liệu sản phẩm & nền tảng (wink://docs/...)
Duyệt các đặc tả OpenAPI trực tiếp và tài liệu thao tác (wink://api/...)
Thực hiện tìm kiếm ngữ nghĩa / từ khóa nhẹ trên tài liệu và API trực tiếp

Giao thức truyền tải

Sử dụng điểm cuối HTTP chính có thể truyền luồng:

https://docs.mcp.wink.travel/mcp

Nếu khách hàng của bạn chỉ hỗ trợ SSE, hãy sử dụng:

https://docs.mcp.wink.travel/sse

Claude Code

Tài liệu chính thức: Kết nối Claude Code với công cụ qua MCP

Anthropic khuyến nghị sử dụng giao thức HTTP từ xa cho các máy chủ MCP được lưu trữ trên đám mây:

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

Trong Claude Code, chạy /mcp để kiểm tra trạng thái máy chủ. Nếu bạn muốn chia sẻ máy chủ với toàn bộ kho, thêm --scope project để Claude Code ghi cấu hình vào .mcp.json.

Codex

Tài liệu chính thức: Hướng dẫn nhanh Docs MCP cho Codex

OpenAI mô tả thiết lập MCP qua CLI Codex, và lưu ý rằng cấu hình được chia sẻ với tiện ích mở rộng IDE:

codex mcp add wink-docs --url https://docs.mcp.wink.travel/mcp
codex mcp list

Cursor

Tài liệu MCP của Cursor: https://cursor.com/docs/context/mcp Thiết lập: Thêm máy chủ từ xa qua cài đặt MCP.

{
  "mcpServers": {
    "wink-docs": {
      "url": "https://docs.mcp.wink.travel/mcp",
    }
  }
}

VS Code

Tài liệu chính thức: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Cấu hình từ xa tối giản (người dùng hoặc workspace mcp.json):

{
  "servers": {
    "wink-docs": {
      "type": "http",
      "url": "https://docs.mcp.wink.travel/mcp"
    }
  }
}

Mẹo:

Sử dụng Command Palette: “MCP: List Servers” để xác nhận kết nối & duyệt công cụ.
Bộ chọn công cụ cho phép bạn bật/tắt api_search và docs_search.
Thêm ngữ cảnh: Chế độ Chat → Thêm Ngữ cảnh → Tài nguyên MCP để đính kèm trang tài liệu.

Các URI tài nguyên cốt lõi

URI	Mô tả
`wink://docs`	Chỉ mục tài liệu (nhóm theo danh mục)
`wink://docs/{path}`	Bài viết tài liệu cụ thể (Markdown / MDX)
`wink://api`	Danh mục OpenAPI trực tiếp được phát hiện từ cấu hình swagger của Wink
`wink://api/{apiName}`	Tóm tắt API gọn với xác thực, thẻ, header và các thao tác mẫu
`wink://api/{apiName}/operations`	Danh sách thao tác đầy đủ nhóm theo thẻ
`wink://api/{apiName}/operation/{key}`	Chi tiết thao tác cá nhân (tham số, thân yêu cầu, phản hồi)
`wink://api/{apiName}/schema/{schemaName}`	Lược đồ thành phần đã giải quyết với các trường lồng nhau, kiểu dữ liệu và ví dụ
`wink://api/{apiName}/operation/{key}/request`	Chế độ xem tập trung vào yêu cầu với đầu vào bắt buộc và payload ví dụ tối giản
`wink://api/{apiName}/operation/{key}/response/{status}`	Chế độ xem tập trung vào phản hồi cho mã trạng thái cụ thể
`wink://api/{apiName}/operation/{key}/recipe`	Luồng công việc theo nhiệm vụ để gọi thao tác đó đúng cách

Công cụ tìm kiếm (Tham khảo nhanh)

Công cụ	Mục đích	Ví dụ truy vấn điển hình
`api_search`	Tìm API trực tiếp hoặc thao tác để tích hợp	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Tìm tài liệu khái niệm / hướng dẫn	`authentication`, `webhooks`, `wordPress`

Để trống query để nhận đề xuất. Mỗi kết quả bao gồm URI MCP bạn có thể mở. Đối với kết quả thao tác, api_search cũng trả về các URI liên kết yêu cầu, phản hồi, lược đồ và công thức để tác nhân có thể nhảy trực tiếp vào tài nguyên phụ hữu ích nhất.

Mẫu sử dụng điển hình

Chạy api_search với ý định của bạn (ví dụ “create affiliate” hoặc “payment receipt”).
Mở URI wink://api/... trả về, hoặc theo các trường liên kết request_uri, response_uris, request_schema_uris, response_schema_uris, và recipe_uri.
Sử dụng docs_search cho các khái niệm hỗ trợ (xác thực, webhooks, quy trình làm việc).

Kỹ năng AI

Các kỹ năng tác nhân được xây dựng sẵn sử dụng máy chủ MCP này làm nguồn sự thật. Kỹ năng cung cấp cho tác nhân lập trình của bạn một quy trình có cấu trúc để xây dựng dựa trên các API Wink — thay vì đoán các điểm cuối, tác nhân đọc trực tiếp các hợp đồng trực tiếp từ máy chủ MCP.

Xem AI Skills để biết các kỹ năng có sẵn và hướng dẫn cài đặt.

Ghi chú

Mỗi URI trả về có thể được tác nhân mở để xem nội dung đầy đủ.
Cây wink://api là trực tiếp và theo danh mục OpenAPI thượng nguồn hiện tại thay vì chỉ mục kho được tạo.
Đề xuất xuất hiện tự động khi truy vấn để trống.

Wink trên GitHub