MCP Server

Ülevaade

Majutatud Wink MCP server on saadaval aadressil:

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

Suuna ühilduvad AI kliendid (VS Code, Cursor, teised, mis kasutavad MCP HTTP transporti) sellele lõpp-punktile, et nad saaksid:

Sirvida toote- ja platvormidokumente (wink://docs/...)
Sirvida reaalajas OpenAPI spetsifikatsioone ja operatsioonidokumente (wink://api/...)
Teostada kerget semantilist / märksõnapõhist otsingut dokumentide ja reaalajas API-de üle

Transport

Kasuta peamist voogedastatavat HTTP lõpp-punkti:

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

Kui su klient toetab ainult SSE-d, kasuta:

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

Claude Code

Ametlik dokumentatsioon: Ühenda Claude Code tööriistadega MCP kaudu

Anthropic soovitab pilves majutatud MCP serverite puhul kasutada kaug-HTTP transporti:

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

Claude Code sees käivita /mcp, et kontrollida serveri olekut. Kui soovid jagada serverit kogu repositooriumiga, lisa --scope project, nii kirjutab Claude Code konfiguratsiooni faili .mcp.json.

Codex

Ametlik dokumentatsioon: Docs MCP kiire algus Codex jaoks

OpenAI dokumenteerib MCP seadistust Codex CLI kaudu ning märgib, et konfiguratsioon jagatakse IDE laiendusega:

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

Cursor

Cursor MCP dokumentatsioon: https://cursor.com/docs/context/mcp Seadistamine: Lisa kaugserver MCP seadete kaudu.

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

VS Code

Ametlik dokumentatsioon: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Minimaalne kaugkonfiguratsioon (kasutaja või tööruumi mcp.json):

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

Nõuanded:

Kasuta Command Palette’i: “MCP: List Servers”, et kinnitada ühendus ja sirvida tööriistu.
Tööriistade valija võimaldab lubada/keelata api_search ja docs_search.
Lisa kontekst: Vestluse vaade → Lisa kontekst → MCP ressursid, et lisada dokumendilehti.

Põhivara URI-d

URI	Kirjeldus
`wink://docs`	Dokumentatsiooni indeks (kategooriate kaupa grupeeritud)
`wink://docs/{path}`	Konkreetne dokumentatsiooni artikkel (Markdown / MDX)
`wink://api`	Reaalajas OpenAPI kataloog, mis on avastatud Wink swagger konfiguratsioonist
`wink://api/{apiName}`	Kompaktne API kokkuvõte koos autentimise, siltide, päiste ja näidistega
`wink://api/{apiName}/operations`	Täielik operatsioonide nimekiri siltide kaupa grupeerituna
`wink://api/{apiName}/operation/{key}`	Üksiku operatsiooni detailid (parameetrid, päringu keha, vastused)
`wink://api/{apiName}/schema/{schemaName}`	Lahendatud komponendi skeem koos pesastatud väljade, tüüpide ja näidetega
`wink://api/{apiName}/operation/{key}/request`	Päringule keskenduv vaade koos nõutavate sisendite ja minimaalse näidispayloadiga
`wink://api/{apiName}/operation/{key}/response/{status}`	Vastusele keskenduv vaade konkreetse staatuse koodi jaoks
`wink://api/{apiName}/operation/{key}/recipe`	Ülesandepõhine voog selle operatsiooni korrektseks kutsumiseks

Otsingutööriistad (Kiirviide)

Tööriist	Eesmärk	Tüüpilised päringu näited
`api_search`	Leia reaalajas API või operatsioon, millega integreeruda	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Leia kontseptuaalsed dokumendid / juhendid	`authentication`, `webhooks`, `wordPress`

Jäta query tühi, et saada soovitusi. Iga tulemus sisaldab MCP URI-d, mida saad avada. Operatsioonide tabamuste puhul tagastab api_search ka seotud päringu, vastuse, skeemi ja retsepti URI-d, et agendid saaksid otse kõige kasulikuma alamressursi juurde hüpata.

Tüüpiline kasutusmuster

Käivita api_search oma kavatsusega (nt “create affiliate” või “payment receipt”).
Ava tagastatud wink://api/... URI või järgi selle seotud request_uri, response_uris, request_schema_uris, response_schema_uris ja recipe_uri välju.
Kasuta docs_search toetavate kontseptsioonide (autentimine, webhookid, töövood) leidmiseks.

AI oskused

Eelnevalt ehitatud agendi oskused kasutavad seda MCP serverit oma tõeallikana. Oskused annavad sinu kodeerimisagendile struktureeritud töövoo Wink API-de vastu arendamiseks — selle asemel, et arvata lõpp-punkte, loeb agent otse MCP serverist reaalajas lepinguid.

Vaata AI Skills saadavalolevate oskuste ja paigaldusjuhiste kohta.

Märkused

Iga tagastatud URI saab agent avada kogu sisu nägemiseks.
wink://api puu on reaalajas ja järgib praegust ülemist OpenAPI kataloogi, mitte genereeritud repositooriumi indeksit.
Soovitused ilmuvad automaatselt, kui päringud on tühjad.

Wink GitHubis