MCP strežnik
Pregled
Section titled “Pregled”Gostujoči Wink MCP strežnik je na voljo na:
https://docs.mcp.wink.travel/mcpUsmerite združljive AI odjemalce (VS Code, Cursor, druge, ki uporabljajo MCP HTTP transport) na to končno točko, da jim omogočite:
- Brskanje po dokumentaciji izdelkov in platforme (
wink://docs/...) - Brskanje po živih OpenAPI specifikacijah in dokumentaciji operacij (
wink://api/...) - Izvajanje lahkih semantičnih / ključnih iskanj po dokumentaciji in živih API-jih
Transport
Section titled “Transport”Uporabite glavno pretočno HTTP končno točko:
https://docs.mcp.wink.travel/mcpČe vaš odjemalec podpira samo SSE, uporabite:
https://docs.mcp.wink.travel/sseClaude Code
Section titled “Claude Code”Uradna dokumentacija: Povežite Claude Code z orodji prek MCP
Anthropic priporoča oddaljeni HTTP transport za oblačno gostujoče MCP strežnike:
claude mcp add --transport http wink-docs https://docs.mcp.wink.travel/mcpclaude mcp listV Claude Code zaženite /mcp za pregled stanja strežnika. Če želite strežnik deliti z vsem repozitorijem, dodajte --scope project, da Claude Code zapiše konfiguracijo v .mcp.json.
Uradna dokumentacija: Docs MCP hitri začetek za Codex
OpenAI dokumentira nastavitev MCP prek Codex CLI in navaja, da je konfiguracija deljena z IDE razširitvijo:
codex mcp add wink-docs --url https://docs.mcp.wink.travel/mcpcodex mcp listCursor
Section titled “Cursor”Cursor MCP dokumentacija: https://cursor.com/docs/context/mcp Nastavitev: Dodajte oddaljeni strežnik prek MCP nastavitev.
{ "mcpServers": { "wink-docs": { "url": "https://docs.mcp.wink.travel/mcp", } }}VS Code
Section titled “VS Code”Uradna dokumentacija: https://code.visualstudio.com/docs/copilot/customization/mcp-servers
Minimalna oddaljena konfiguracija (uporabniška ali delovna mcp.json):
{ "servers": { "wink-docs": { "type": "http", "url": "https://docs.mcp.wink.travel/mcp" } }}Namigi:
- Uporabite Command Palette: “MCP: List Servers” za potrditev povezave in brskanje po orodjih.
- Izbirnik orodij omogoča vklop/izklop
api_searchindocs_search. - Dodajte kontekst: Pogled klepeta → Dodaj kontekst → MCP viri za pripenjanje strani dokumentacije.
Osnovni URI-ji virov
Section titled “Osnovni URI-ji virov”| URI | Opis |
|---|---|
wink://docs | Indeks dokumentacije (združen po kategorijah) |
wink://docs/{path} | Specifičen dokumentacijski članek (Markdown / MDX) |
wink://api | Živi OpenAPI katalog, odkrit iz Winkove swagger konfiguracije |
wink://api/{apiName} | Povzetek API-ja z avtentikacijo, oznakami, glavi in primeri operacij |
wink://api/{apiName}/operations | Celoten seznam operacij združen po oznakah |
wink://api/{apiName}/operation/{key} | Podrobnosti posamezne operacije (parametri, telo zahteve, odgovori) |
wink://api/{apiName}/schema/{schemaName} | Razrešena komponenta sheme z gnezdenimi polji, tipi in primeri |
wink://api/{apiName}/operation/{key}/request | Pogled osredotočen na zahtevo z obveznimi vnosi in minimalnim primerom |
wink://api/{apiName}/operation/{key}/response/{status} | Pogled osredotočen na odgovor za določen statusni kodo |
wink://api/{apiName}/operation/{key}/recipe | Naloga usmerjen potek za pravilno klicanje te operacije |
Orodja za iskanje (hitri pregled)
Section titled “Orodja za iskanje (hitri pregled)”| Orodje | Namen | Tipični primeri poizvedb |
|---|---|---|
api_search | Najdi živi API ali operacijo za integracijo | create affiliate, payment receipt, lookup inventory, invite manager |
docs_search | Najdi konceptualno dokumentacijo / vodiče | authentication, webhooks, wordPress |
Pustite query prazno za prejem predlogov. Vsak rezultat vključuje MCP URI, ki ga lahko odprete.
Za zadetke operacij api_search vrne tudi povezane URI-je zahtev, odgovorov, shem in receptov, da lahko agenti neposredno skočijo na najbolj uporabne podvire.
Tipičen vzorec uporabe
Section titled “Tipičen vzorec uporabe”- Zaženite
api_searchz vašo namero (npr. “create affiliate” ali “payment receipt”). - Odprite vrnjeni
wink://api/...URI ali sledite njegovim povezanih poljemrequest_uri,response_uris,request_schema_uris,response_schema_urisinrecipe_uri. - Uporabite
docs_searchza podporne koncepte (avtentikacija, webhooks, delovni tokovi).
AI veščine
Section titled “AI veščine”Vnaprej pripravljene veščine agentov uporabljajo ta MCP strežnik kot svoj vir resnice. Veščine dajejo vašemu kodirnemu agentu strukturiran potek dela za gradnjo na Wink API-jih — namesto ugibanja končnih točk agent bere žive pogodbe neposredno s MCP strežnika.
Oglejte si AI Skills za razpoložljive veščine in navodila za namestitev.
Opombe
Section titled “Opombe”- Vsak vrnjeni URI lahko agent odpre za celotno vsebino.
- Drevo
wink://apije živo in sledi trenutnemu zgornjemu OpenAPI katalogu namesto generiranemu indeksu repozitorija. - Predlogi se samodejno prikažejo, ko so poizvedbe prazne.