跳到內容

MCP 伺服器

託管的 Wink MCP 伺服器位於:

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

將相容的 AI 用戶端(VS Code、Cursor、其他實作 MCP HTTP 傳輸的工具)指向此端點,可讓它們:

  • 瀏覽產品與平台文件(wink://docs/...
  • 瀏覽即時 OpenAPI 規格與操作文件(wink://api/...
  • 對文件與即時 API 執行輕量語意/關鍵字搜尋

使用主要可串流的 HTTP 端點:

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

如果您的用戶端僅支援 SSE,請使用:

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

官方文件:透過 MCP 連接 Claude Code 到工具

Anthropic 建議對雲端託管的 MCP 伺服器使用遠端 HTTP 傳輸:

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

在 Claude Code 中,執行 /mcp 以檢查伺服器狀態。若想與整個專案共用伺服器,請加上 --scope project,讓 Claude Code 將設定寫入 .mcp.json

官方文件:Codex 的 Docs MCP 快速入門

OpenAI 透過 Codex CLI 文件說明 MCP 設定,並指出此設定會與 IDE 擴充功能共用:

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

Cursor MCP 文件:https://cursor.com/docs/context/mcp 設定:透過 MCP 設定新增遠端伺服器。

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

官方文件:https://code.visualstudio.com/docs/copilot/customization/mcp-servers 最簡遠端設定(使用者或工作區的 mcp.json):

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

提示:

  • 使用命令面板:「MCP: List Servers」確認連線並瀏覽工具。
  • 工具選擇器可啟用/停用 api_searchdocs_search
  • 新增上下文:聊天視圖 → 新增上下文 → MCP 資源,附加文件頁面。
URI說明
wink://docs文件索引(依類別分組)
wink://docs/{path}特定文件文章(Markdown / MDX)
wink://api從 Wink swagger 設定發現的即時 OpenAPI 目錄
wink://api/{apiName}含認證、標籤、標頭及範例操作的精簡 API 摘要
wink://api/{apiName}/operations依標籤分組的完整操作列表
wink://api/{apiName}/operation/{key}單一操作細節(參數、請求主體、回應)
wink://api/{apiName}/schema/{schemaName}已解析的元件結構,含巢狀欄位、類型與範例
wink://api/{apiName}/operation/{key}/request以請求為主的檢視,含必要輸入與最小範例負載
wink://api/{apiName}/operation/{key}/response/{status}針對特定狀態碼的回應檢視
wink://api/{apiName}/operation/{key}/recipe呼叫該操作的任務導向流程
工具目的典型查詢範例
api_search尋找可整合的即時 API 或操作create affiliatepayment receiptlookup inventoryinvite manager
docs_search尋找概念性文件/指南authenticationwebhookswordPress

留空 query 可獲得建議。每個結果都包含可開啟的 MCP URI。 對於操作命中,api_search 也會回傳連結的請求、回應、結構與流程 URI,讓代理能直接跳轉到最有用的子資源。

  1. 使用您的意圖執行 api_search(例如 「create affiliate」「payment receipt」)。
  2. 開啟回傳的 wink://api/... URI,或依其連結的 request_uriresponse_urisrequest_schema_urisresponse_schema_urisrecipe_uri 欄位操作。
  3. 使用 docs_search 查找支援概念(認證、webhooks、工作流程)。

預建的代理技能使用此 MCP 伺服器作為其真實資料來源。技能為您的程式代理提供結構化工作流程,以便針對 Wink API 建構 — 不必猜測端點,代理直接從 MCP 伺服器讀取即時合約。

請參閱 AI Skills 了解可用技能及安裝說明。

  • 每個回傳的 URI 代理都能開啟以取得完整內容。
  • wink://api 樹狀結構是即時的,遵循目前上游 OpenAPI 目錄,而非產生的 repo 索引。
  • 查詢為空時會自動顯示建議。
Wink 在 GitHub