Servidor MCP

Visão Geral

O servidor MCP hospedado do Wink está disponível em:

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

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

Navegar pela documentação de produtos e plataforma (wink://docs/...)
Navegar pelas especificações OpenAPI ao vivo e documentação de operações (wink://api/...)
Realizar buscas semânticas / por palavra-chave leves sobre documentos e APIs ao vivo

Transporte

Use o endpoint HTTP principal e transmissível:

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

Se seu cliente suporta apenas SSE, use:

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

Claude Code

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

Anthropic recomenda o transporte HTTP remoto para servidores MCP hospedados na nuvem:

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 status do servidor. Se quiser compartilhar 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: Docs MCP quickstart para Codex

A OpenAI documenta a configuração MCP via CLI do Codex, e observa que a configuração é compartilhada com a extensão do IDE:

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

Cursor

Documentação MCP do Cursor: https://cursor.com/docs/context/mcp Configuração: Adicione o servidor remoto via configuraçõ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 (usuário ou workspace 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 conexão e navegar pelas ferramentas.
O seletor de ferramentas permite ativar/desativar api_search e docs_search.
Adicione contexto: Visualização 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 específico de documentação (Markdown / MDX)
`wink://api`	Catálogo OpenAPI ao vivo descoberto a partir da configuração swagger do Wink
`wink://api/{apiName}`	Resumo compacto da API com autenticação, tags, cabeçalhos e operações de exemplo
`wink://api/{apiName}/operations`	Listagem completa de operações agrupadas por tag
`wink://api/{apiName}/operation/{key}`	Detalhe individual da operação (parâmetros, corpo da requisição, respostas)
`wink://api/{apiName}/schema/{schemaName}`	Esquema de componente resolvido com campos aninhados, tipos e exemplos
`wink://api/{apiName}/operation/{key}/request`	Visão focada na requisição com entradas obrigatórias e payload de exemplo mínimo
`wink://api/{apiName}/operation/{key}/response/{status}`	Visão focada na resposta para um código de status específico
`wink://api/{apiName}/operation/{key}/recipe`	Fluxo orientado a tarefas para chamar essa operação corretamente

Ferramentas de Busca (Referência Rápida)

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

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

Padrão Típico de Uso

Execute api_search com sua intenção (ex: “create affiliate” ou “payment receipt”).
Abra o URI retornado wink://api/..., ou siga seus campos vinculados 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).

Skills de IA

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

Veja AI Skills para skills 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 é ao vivo e segue o catálogo OpenAPI atual em vez de um índice gerado do repositório.
Sugestões aparecem automaticamente quando as consultas estão vazias.

Wink no GitHub