Server MCP

Prezentare generală

Serverul MCP găzduit Wink este disponibil la:

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

Indică clienților AI compatibili (VS Code, Cursor, alții care implementează transportul MCP HTTP) acestui punct final pentru a le permite să:

Răsfoiască documentația produsului și a platformei (wink://docs/...)
Răsfoiască specificațiile OpenAPI live și documentația operațiunilor (wink://api/...)
Efectueze căutări semantice / pe cuvinte cheie ușoare în documentație și API-uri live

Transport

Folosește punctul final HTTP principal, streamabil:

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

Dacă clientul tău suportă doar SSE, folosește:

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

Claude Code

Documentație oficială: Conectează Claude Code la unelte prin MCP

Anthropic recomandă transportul HTTP la distanță pentru serverele MCP găzduite în cloud:

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

În Claude Code, rulează /mcp pentru a inspecta starea serverului. Dacă vrei să partajezi serverul cu întregul depozit, adaugă --scope project astfel încât Claude Code să scrie configurația în .mcp.json.

Codex

Documentație oficială: Docs MCP quickstart pentru Codex

OpenAI documentează configurarea MCP prin CLI-ul Codex și menționează că configurația este partajată cu extensia IDE:

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

Cursor

Documentație Cursor MCP: https://cursor.com/docs/context/mcp Configurare: Adaugă serverul la distanță prin setările MCP.

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

VS Code

Documentație oficială: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Configurație minimă la distanță (fișier mcp.json utilizator sau workspace):

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

Sfaturi:

Folosește Command Palette: „MCP: List Servers” pentru a confirma conexiunea și a răsfoi uneltele.
Selectorul de unelte îți permite să activezi/dezactivezi api_search și docs_search.
Adaugă context: Vizualizare Chat → Add Context → MCP Resources pentru a atașa pagini de documentație.

URI-uri principale ale resurselor

URI	Descriere
`wink://docs`	Indexul documentației (grupat pe categorii)
`wink://docs/{path}`	Articol specific de documentație (Markdown / MDX)
`wink://api`	Catalog OpenAPI live descoperit din configurația swagger a Wink
`wink://api/{apiName}`	Rezumat compact API cu autentificare, etichete, headere și operațiuni exemplu
`wink://api/{apiName}/operations`	Listare completă a operațiunilor grupate pe etichete
`wink://api/{apiName}/operation/{key}`	Detaliu operațiune individuală (parametri, corp cerere, răspunsuri)
`wink://api/{apiName}/schema/{schemaName}`	Schema componentă rezolvată cu câmpuri, tipuri și exemple imbricate
`wink://api/{apiName}/operation/{key}/request`	Vizualizare axată pe cerere cu intrări obligatorii și exemplu minim de payload
`wink://api/{apiName}/operation/{key}/response/{status}`	Vizualizare axată pe răspuns pentru un cod de stare specific
`wink://api/{apiName}/operation/{key}/recipe`	Flux orientat pe sarcină pentru apelarea corectă a acelei operațiuni

Unelte de căutare (Referință rapidă)

Unealtă	Scop	Exemple tipice de interogări
`api_search`	Găsește API-ul live sau operațiunea pentru integrare	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Găsește documentație conceptuală / ghiduri	`authentication`, `webhooks`, `wordPress`

Lasă query gol pentru a primi sugestii. Fiecare rezultat include URI-ul MCP pe care îl poți deschide. Pentru rezultate operațiuni, api_search returnează și URI-uri legate de cerere, răspuns, schemă și rețetă astfel încât agenții să poată accesa direct subresursele cele mai utile.

Model tipic de utilizare

Rulează api_search cu intenția ta (ex. “create affiliate” sau “payment receipt”).
Deschide URI-ul wink://api/... returnat sau urmează câmpurile legate request_uri, response_uris, request_schema_uris, response_schema_uris și recipe_uri.
Folosește docs_search pentru concepte suport (autentificare, webhooks, fluxuri de lucru).

Abilități AI

Abilitățile predefinite ale agenților folosesc acest server MCP ca sursă de adevăr. Abilitățile oferă agentului tău de codare un flux de lucru structurat pentru a construi pe baza API-urilor Wink — în loc să ghicească endpoint-urile, agentul citește contractele live direct de pe serverul MCP.

Vezi AI Skills pentru abilitățile disponibile și instrucțiuni de instalare.

Note

Fiecare URI returnat poate fi deschis de agent pentru conținut complet.
Arborele wink://api este live și urmează catalogul OpenAPI upstream curent, nu un index generat al depozitului.
Sugestiile apar automat când interogările sunt goale.

Wink pe GitHub