Servidor MCP

Visão Geral

O servidor MCP alojado da Wink está disponível em:

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

Aponte clientes de IA compatíveis (VS Code, Cursor, outros que implementem transporte HTTP MCP) para este endpoint para que possam:

Navegar na documentação de produto e plataforma (wink://docs/...)
Navegar nas especificações OpenAPI em direto e documentação de operações (wink://api/...)
Realizar pesquisas semânticas / por palavras-chave leves sobre documentação e APIs em direto

Transporte

Use o endpoint HTTP principal e transmissível:

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

Se o seu cliente suportar apenas SSE, use:

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

Claude Code

Documentação oficial: Ligar Claude Code a ferramentas via MCP

A Anthropic recomenda o transporte HTTP remoto para servidores MCP alojados na cloud:

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

Dentro do Claude Code, execute /mcp para inspecionar o estado do servidor. Se quiser partilhar o servidor com todo o repositório, adicione --scope project para que o Claude Code escreva a configuração em .mcp.json.

Codex

Documentação oficial: Início rápido MCP para Codex

A OpenAI documenta a configuração MCP através da CLI Codex, e nota que a configuração é partilhada com a extensão IDE:

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

Cursor

Documentação MCP Cursor: https://cursor.com/docs/context/mcp Configuração: Adicione o servidor remoto via definições MCP.

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

VS Code

Documentação oficial: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Configuração remota mínima (utilizador ou espaço de trabalho mcp.json):

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

Dicas:

Use a Paleta de Comandos: “MCP: List Servers” para confirmar a ligação e navegar pelas ferramentas.
O seletor de ferramentas permite ativar/desativar api_search e docs_search.
Adicione contexto: Vista de Chat → Adicionar Contexto → Recursos MCP para anexar páginas de documentação.

URIs Principais de Recursos

URI	Descrição
`wink://docs`	Índice de documentação (agrupado por categoria)
`wink://docs/{path}`	Artigo de documentação específico (Markdown / MDX)
`wink://api`	Catálogo OpenAPI em direto descoberto a partir da configuração swagger da Wink
`wink://api/{apiName}`	Resumo compacto da API com autenticação, etiquetas, cabeçalhos e operações de exemplo
`wink://api/{apiName}/operations`	Listagem completa de operações agrupadas por etiqueta
`wink://api/{apiName}/operation/{key}`	Detalhe individual da operação (parâmetros, corpo do pedido, respostas)
`wink://api/{apiName}/schema/{schemaName}`	Esquema de componente resolvido com campos aninhados, tipos e exemplos
`wink://api/{apiName}/operation/{key}/request`	Vista focada no pedido com entradas obrigatórias e payload de exemplo mínimo
`wink://api/{apiName}/operation/{key}/response/{status}`	Vista focada na resposta para um código de estado específico
`wink://api/{apiName}/operation/{key}/recipe`	Fluxo orientado a tarefas para chamar essa operação corretamente

Ferramentas de Pesquisa (Referência Rápida)

Ferramenta	Propósito	Exemplos Típicos de Consulta
`api_search`	Encontrar a API ou operação em direto para integrar	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Encontrar documentação conceptual / guias	`authentication`, `webhooks`, `wordPress`

Deixe query vazio para receber sugestões. Cada resultado inclui o URI MCP que pode abrir. Para resultados de operações, api_search também retorna URIs ligados de pedido, resposta, esquema e receita para que os agentes possam saltar diretamente para o subrecurso mais útil.

Padrão Típico de Utilização

Execute api_search com a sua intenção (ex.: “create affiliate” ou “payment receipt”).
Abra o URI wink://api/... retornado, ou siga os seus campos ligados request_uri, response_uris, request_schema_uris, response_schema_uris e recipe_uri.
Use docs_search para conceitos de apoio (autenticação, webhooks, fluxos de trabalho).

Competências de IA

As competências de agente pré-construídas usam este servidor MCP como sua fonte de verdade. As competências dão ao seu agente de codificação um fluxo de trabalho estruturado para construir contra as APIs Wink — em vez de adivinhar endpoints, o agente lê os contratos em direto diretamente do servidor MCP.

Consulte AI Skills para competências disponíveis e instruções de instalação.

Notas

Cada URI retornado pode ser aberto pelo agente para conteúdo completo.
A árvore wink://api é em direto e segue o catálogo OpenAPI atual em vez de um índice gerado do repositório.
As sugestões aparecem automaticamente quando as consultas estão vazias.

Wink no GitHub