Servidores MCP
As ferramentas MCP da Wink são publicadas como conjuntos de ferramentas — endpoints focados, cada um cobrindo uma tarefa. Conecta o seu cliente de IA ao um ou dois que correspondem ao seu trabalho, não a todos.
Cada endpoint usa login interativo OAuth2 (fluxo de código de autorização PKCE): o seu agente de IA abre uma aba do navegador, você inicia sessão com a sua conta Wink, e está feito. Sem segredos de cliente para gerir.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpPor que as ferramentas estão divididas por endpoints
Seção intitulada “Por que as ferramentas estão divididas por endpoints”A Wink expõe cerca de 500 ferramentas. Entregar todas elas a um agente de uma só vez é tecnicamente possível — e uma má ideia.
As definições das ferramentas consomem contexto. Cada ferramenta que um servidor MCP anuncia é carregada na janela de contexto do modelo antes de realizar qualquer trabalho, juntamente com a sua descrição e esquema completo de parâmetros. Quinhentas dessas consomem uma grande parte do orçamento que a sua tarefa real necessita, em cada pedido.
A qualidade da escolha diminui à medida que a lista cresce. Um agente que escolhe entre 500 ferramentas com nomes semelhantes faz escolhas piores do que um que escolhe entre 40. Se integrar um channel manager, cerca de vinte ferramentas são relevantes para si; as outras 480 são ruído que dificulta encontrar a ferramenta certa.
O trabalho é genuinamente separável. Alguém a sincronizar disponibilidade de um PMS e alguém a criar páginas de afiliados partilham quase nenhuma ferramenta. Dividir por tarefa significa que cada ligação transporta o vocabulário de uma tarefa.
Diretório de endpoints
Seção intitulada “Diretório de endpoints”Dois hosts servem conjuntos de ferramentas. Os números de ferramentas são aproximados e crescem com o tempo.
https://api.wink.travel — a plataforma
Seção intitulada “https://api.wink.travel — a plataforma”| Endpoint | Ferramentas | O que cobre |
|---|---|---|
/mcp/extranet/facilities | ~64 | Inventário reservável e no local: quartos e tipos de quartos, spas, restaurantes, salas de reuniões, atividades, atrações, locais, outros itens vendáveis |
/mcp/extranet/property | ~62 | Registo da propriedade e seus termos comerciais: perfil e conteúdo, extras, políticas de cancelamento, benefícios, anúncios |
/mcp/settings | ~60 | Administração da conta: perfil e branding da entidade gestora, gestores e suas permissões, personalização, webhooks, preferências de notificação |
/mcp/studio/embeds | ~48 | Publicação de inventário curado: widgets, grelhas e grelhas classificadas, cartões, mapas, links profundos para inventário e páginas de fornecedores |
/mcp/extranet/rates | ~44 | Preços e disponibilidade: períodos e lotes de tarifas de inventário, planos tarifários, tarifas principais, tarifas especiais e promocionais |
/mcp/extranet/operations | ~39 | Gestão diária de uma propriedade ativa: reservas e seu ciclo de vida, avaliações e respostas de hóspedes, feeds de calendário, tarefas agendadas |
/mcp/extranet/distribution | ~37 | Onde o inventário é vendido: canais de venda e modificadores de tarifa, pedidos de relacionamento com afiliados e fornecedores, registo, captura de leads |
/mcp/studio/curation | ~35 | Construção de coleções comercializáveis: listas estáticas e dinâmicas, listas classificadas, pesquisas guardadas, agregados de propriedades |
/mcp/link-manager | ~28 | Coleções de links sindicados, seu design, categorias e etiquetas, além de URLs encurtadas |
/mcp/reference | ~24 | Dados de consulta apenas leitura: países, moedas e taxas de câmbio, idiomas, fusos horários, consultas geográficas, geolocalização por IP |
/mcp/analytics | ~18 | Análise de reservas e receitas: visões gerais, gráficos de linha, rankings, desempenho de afiliados, métricas de partilha |
/mcp/payment | ~18 | Operações financeiras: razão, levantamentos e estimativas de taxas, agregados de fundos de reserva |
/mcp/booking-engine | ~17 | Caminho de compra para o viajante: pesquisa e consulta, carrinho de compras e checkout, listas de desejos, personalização de campanhas |
/mcp/social | ~17 | Contas sociais ligadas, publicação e agendamento de posts, leitura de insights de posts |
/mcp/travel-agent | ~8 | Reservas facilitadas por agentes em nome dos viajantes, e relatórios de agentes |
https://integrations.wink.travel — integrações de channel manager
Seção intitulada “https://integrations.wink.travel — integrações de channel manager”Um endpoint, porque este host existe para uma tarefa.
| Endpoint | Ferramentas | O que cobre |
|---|---|---|
/mcp/channel-manager | ~9 | Ligação e verificação de uma integração de channel manager, PMS ou CRS |
Cada endpoint também inclui uma ferramenta ping, para confirmar que a ligação está ativa antes de pedir trabalho real.
Pagamentos agentic
Seção intitulada “Pagamentos agentic”Para o fluxo completo de reserva do viajante, ligue o Wink Booking Engine em https://api.wink.travel/mcp/booking-engine e uma carteira de pagamento compatível. Adicionar o MCP da Wink abre o login no navegador e a seleção de permissões; o seu cliente trata depois da autenticação.
O Booking Engine inclui pesquisa de destino, pesquisa de hotéis e quartos, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, recuperação de reservas e recibos, quando as reservas e pagamentos agentic estão ativados para esse ambiente. Veja Agentic Payments para configuração da ligação, permissões a selecionar e passos da pesquisa à confirmação.
Que conjuntos de ferramentas preciso?
Seção intitulada “Que conjuntos de ferramentas preciso?”| Se você é… | Ligue-se a |
|---|---|
| Integrador de channel manager, PMS ou CRS | integrations.wink.travel/mcp/channel-manager — apenas este |
| Gestor de conteúdo de uma propriedade | /mcp/extranet/property + /mcp/extranet/facilities |
| Gestor de quartos e tipos de quartos | /mcp/extranet/facilities |
| Gestor de preços e disponibilidade | /mcp/extranet/rates |
| Gestor de reservas diárias | /mcp/extranet/operations |
| Expansão da distribuição | /mcp/extranet/distribution + /mcp/analytics |
| Criação de páginas de afiliados | /mcp/studio/curation + /mcp/studio/embeds |
| Gestão de páginas link-in-bio | /mcp/link-manager + /mcp/social |
| Reserva em nome de viajantes | /mcp/travel-agent |
| Reconciliação financeira | /mcp/payment |
| Reserva de quarto com agente de IA | /mcp/booking-engine + carteira de pagamento compatível — veja Agentic Payments |
| Construção de experiência de reserva | /mcp/booking-engine; opcionalmente /mcp/reference para consultas adicionais |
O Booking Engine inclui o fluxo principal de reserva. Fornece descoberta de conta e personalização, pesquisa de destino, disponibilidade de hotéis e detalhes de tarifas de quartos, carrinhos de compras, checkout e gestão de reservas do viajante. Ferramentas de reserva e pagamento agentic também estão incluídas quando ativadas para esse ambiente.
Para pesquisa de hotéis baseada em cidade, use destination_lookup_search_suggestions para resolver o destino, depois inventory_search_city para encontrar hotéis e tarifas disponíveis. Ambas as ferramentas estão em /mcp/booking-engine, portanto este fluxo não requer ligação ao Reference.
Adicione /mcp/reference quando precisar de consultas de suporte como países, moedas e taxas de câmbio, idiomas suportados, fusos horários, pesquisas geográficas mais amplas, classificações OTA ou conhecimento público de propriedades. São adições opcionais ao fluxo de reserva.
Comece com um. Adicione outro quando precisar de algo que ele não possa fazer — cada ligação é independente, e adicionar uma nunca afeta as outras.
Como funciona a autenticação
Seção intitulada “Como funciona a autenticação”Os servidores MCP da Wink usam o fluxo OAuth2 Authorization Code + PKCE e suportam Dynamic Client Registration (RFC 7591). Isto acontece quando se liga pela primeira vez:
- O seu cliente de IA descobre o servidor de autorização a partir dos metadados
/.well-known/oauth-protected-resourcedo endpoint MCP. - O cliente regista-se automaticamente via Dynamic Client Registration — não é necessário configurar manualmente a aplicação.
- O cliente abre uma aba do navegador para
https://iam.wink.travel. Você inicia sessão com a sua conta Wink e aprova as permissões solicitadas no ecrã de consentimento. - A Wink emite um token de acesso associado à sua conta e identidade.
- O cliente de IA anexa o token a cada pedido MCP. Todos os resultados das ferramentas são automaticamente limitados à sua entidade gestora.
- Os tokens expiram após 3 horas. O seu cliente de IA atualiza silenciosamente em segundo plano sem pedir novamente.
Cada chamada de ferramenta é executada sob a sua identidade — as mesmas regras ACL que protegem o portal web aplicam-se ao agente de IA.
Ligue o seu cliente de IA
Seção intitulada “Ligue o seu cliente de IA”Adicione cada conjunto de ferramentas ao Claude como um conector personalizado. Não há ficheiro de configuração para editar nem aplicação ou segredo para criar.
-
No Claude, abra Customize › Connectors, clique em Add, depois em Add custom connector.
-
Introduza um Nome (por exemplo Wink Link manager) e, como URL do servidor MCP, um conjunto de ferramentas do diretório acima, por exemplo:
https://api.wink.travel/mcp/link-managerClique em Continue.
-
O Claude deteta o login da Wink. Mantenha Authentication: Sign in now e OAuth client: Register automatically, depois clique em Add.
-
Clique em Connect. Abre-se uma página de login da Wink em
https://iam.wink.travel. Inicie sessão na Wink e aprove as permissões no ecrã de consentimento. -
As ferramentas do conector estão agora disponíveis nas suas conversas. Repita para cada conjunto de ferramentas que o seu trabalho necessita; cada um é um conector próprio.
-
Certifique-se de que o Claude Code está atualizado:
Janela do terminal npm install -g @anthropic-ai/claude-code -
Escolha um conjunto de ferramentas do diretório acima e adicione-o. Por exemplo, preços e disponibilidade:
Janela do terminal claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
O Claude Code contacta o servidor, descobre o servidor de autorização e abre o seu navegador padrão.
-
Inicie sessão na Wink e aprove o pedido de permissão no ecrã de consentimento.
-
O Claude Code confirma a ligação. Escreva
/mcppara verificar se o servidor aparece e as suas ferramentas foram carregadas.
Adicione tantos conjuntos de ferramentas quanto o seu trabalho necessitar — cada um é uma entrada de servidor separada com o seu próprio nome:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpSó precisa de iniciar sessão uma vez. Após a primeira aprovação no navegador, o Claude Code reutiliza a sua sessão Wink para endpoints adicionais da Wink.
-
Edite o ficheiro de configuração do Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Adicione as entradas dos servidores MCP:
claude_desktop_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Feche completamente e reinicie o Claude Desktop (use Quit no menu — fechar a janela não é suficiente).
-
O Claude Desktop abre uma aba do navegador para cada novo servidor. Inicie sessão na Wink e aprove as permissões.
-
O ícone de ficha na barra inferior mostra ambos os servidores como ligados.
-
Certifique-se de que o Codex CLI está instalado:
Janela do terminal npm install -g @openai/codex -
Abra (ou crie) o ficheiro de configuração do Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Adicione as entradas dos servidores MCP da Wink:
~/.codex/config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Inicie o Codex. Na primeira utilização, o Codex abre uma aba do navegador para
https://iam.wink.travel. -
Inicie sessão na Wink e aprove as permissões solicitadas.
-
O Codex confirma a ligação. Execute
codexe peça para listar as ferramentas disponíveis para verificar se os servidores Wink estão ativos.
O suporte a servidores MCP está disponível na app desktop ChatGPT para subscritores Plus, Pro, Team e Enterprise.
-
Descarregue e instale a app desktop ChatGPT se ainda não o fez.
-
Abra a app e clique no ícone do seu perfil no canto superior direito, depois escolha Settings.
-
Vá a Connectors (ou MCP Servers dependendo da versão da app) e clique em Add.
-
Introduza a URL de um conjunto de ferramentas do diretório acima, por exemplo:
https://api.wink.travel/mcp/extranet/ratesDepois clique em Connect.
-
O ChatGPT abre uma aba do navegador para
https://iam.wink.travel. Inicie sessão na Wink e aprove as permissões. -
Repita os passos 4–5 para qualquer outro conjunto de ferramentas que o seu trabalho necessite, por exemplo:
https://api.wink.travel/mcp/extranet/operations -
Cada conjunto de ferramentas aparece na sua lista de Connectors. Inicie uma nova conversa — as ferramentas Wink ficam disponíveis automaticamente.
-
Abra (ou crie) o ficheiro de configuração MCP do Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Adicione as entradas dos servidores MCP da Wink:
~/.cursor/mcp.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Abra o Cursor. Vá a Settings → Cursor Settings → MCP e confirme que ambos os servidores aparecem com indicador de estado verde. Se estiverem vermelhos, clique em Refresh.
-
O Cursor abre uma aba do navegador para
https://iam.wink.travel. Inicie sessão na Wink e aprove as permissões. -
Abra uma conversa (
Ctrl+L/Cmd+L) e peça ao Cursor para listar as ferramentas Wink disponíveis para confirmar a ligação.
-
Abra (ou crie) o ficheiro de configuração MCP do Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Adicione as entradas dos servidores MCP da Wink:
~/.codeium/windsurf/mcp_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Reinicie completamente o Windsurf (Ficheiro → Quit, depois reabra).
-
Vá a Settings → MCP Servers e verifique se ambos os servidores aparecem como ligados. O Windsurf abre uma aba do navegador para
https://iam.wink.travelna primeira utilização. -
Inicie sessão na Wink e aprove as permissões. Os servidores ficam verdes no painel de configurações assim que autenticados.
O Cline é uma extensão para VS Code com gestor integrado de servidores MCP. Não é necessário editar JSON manualmente.
-
Instale o Cline a partir do Marketplace do VS Code:
- Abra o VS Code e pressione
Ctrl+Shift+X/Cmd+Shift+X - Procure por Cline e clique em Install
- Abra o VS Code e pressione
-
Clique no ícone do Cline na Barra de Atividades (barra lateral esquerda) para abrir o painel do Cline.
-
Clique no ícone MCP Servers (ícone de ficha) na barra de ferramentas do Cline, depois escolha Edit MCP Settings.
-
O VS Code abre o ficheiro
cline_mcp_settings.json. Adicione as entradas da Wink:cline_mcp_settings.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Guarde o ficheiro. O Cline recarrega automaticamente e abre uma aba do navegador para
https://iam.wink.travel. -
Inicie sessão na Wink e aprove as permissões. Ambos os servidores aparecem como ativos no painel MCP Servers.
Escopos
Seção intitulada “Escopos”Quando aprova o ecrã de consentimento verá um detalhamento do que o agente está a solicitar. Os clientes MCP usam o mesmo vocabulário de permissões que o resto da plataforma — veja a referência completa de escopos na página de Autenticação.
Três coisas são específicas do MCP:
- Os escopos
mcp.read,mcp.writeemcp.removesão adicionalmente necessários para abrir o transporte MCP. Um cliente que detém um escopomcp.*é admitido em qualquer endpoint MCP da Wink, mas cada ferramenta que invoca ainda aplica o escopo da secção do endpoint que envolve (ex.:booking.read). - O MCP atua sempre como um utilizador autenticado. O cliente de IA recebe os escopos
mcp.*através do seu login, nunca de uma Aplicação que crie. Tokens máquina-a-máquina (client-credentials) não podem abrir o transporte MCP; use a API REST para trabalho servidor-a-servidor. - O cliente de IA solicita apenas os escopos que precisa. Pode negar permissões individuais no ecrã de consentimento — ferramentas que requerem um escopo negado retornam erro quando invocadas.
Os conjuntos de ferramentas não alteram nada disto. O endpoint a que se liga decide quais ferramentas são listadas, não o que elas estão autorizadas a fazer. Ligar a /mcp/payment não concede nenhuma permissão financeira que já não tivesse, e ligar a /mcp/reference não impede uma ferramenta de aplicar o seu próprio escopo. A autorização é decidida por chamada de ferramenta, a partir do seu token e das permissões da sua conta.
Resolução de problemas
Seção intitulada “Resolução de problemas”A aba do navegador não abre
O seu cliente de IA pode ainda não suportar o fluxo interativo PKCE. Verifique se está a usar uma versão recente:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT desktop: atualize pelo atualizador integrado da app
401 Unauthorized após iniciar sessão
O seu token em cache pode estar desatualizado. Remova e adicione novamente o servidor para forçar um novo login:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpPara Claude Desktop e ChatGPT, remova a entrada do servidor nas definições, reinicie a app e adicione novamente.
403 Forbidden ao chamar uma ferramenta específica
A ferramenta requer um escopo que não aprovou no ecrã de consentimento, ou uma permissão que a sua conta não possui. Reconecte o servidor — o ecrã de consentimento aparecerá novamente e poderá aprovar a permissão em falta. Se continuar a falhar, a ferramenta precisa de uma permissão de conta que não tem; ligar a outro conjunto de ferramentas não ajuda, pois os conjuntos não concedem permissões.
A ferramenta que preciso não está na lista
Provavelmente está ligado a um conjunto de ferramentas que não cobre essa tarefa. Verifique o diretório de endpoints e adicione o conjunto que cobre — as ligações são independentes, por isso adicionar um não altera os outros. Se não souber qual tem, ligue temporariamente a https://api.wink.travel/mcp, encontre a ferramenta, depois veja qual conjunto a lista.
404 Not Found num endpoint de conjunto de ferramentas
Verifique o caminho cuidadosamente — os conjuntos aninhados têm dois segmentos (/mcp/extranet/rates, não /mcp/extranet-rates), e os planos têm um (/mcp/link-manager). Note que um pedido não autenticado a qualquer caminho sob /mcp retorna 401, não 404, por isso só um 401 não indica se o endpoint existe.
Liguei a api.wink.travel/mcp/channel-manager e não obtive nada
Esse endpoint não existe. A integração de channel manager é servida apenas em https://integrations.wink.travel/mcp/channel-manager. Se também precisa de ler ou escrever as tarifas próprias de uma propriedade manualmente, isso é uma tarefa separada num endpoint separado — veja /mcp/extranet/rates.
O servidor aparece mas as chamadas às ferramentas retornam “conta não encontrada”
Está autenticado numa conta Wink que não tem entidade gestora. Vá a Wink Portal e assegure-se de que a sua conta está configurada antes de usar o servidor MCP.
O token expira durante a sessão
Os tokens são válidos por 3 horas. O Claude Code e o Claude Desktop atualizam tokens silenciosamente sem interromper a sessão. Se vir erros de autenticação após um longo período de inatividade, escreva uma nova mensagem — o cliente reautentica automaticamente.
Codex CLI mostra “MCP server unreachable”
Verifique se o seu ~/.codex/config.json é JSON válido (sem vírgulas finais) e que "type": "http" está definido. O Codex requer transporte HTTP para servidores remotos; transporte stdio é só para binários locais.
Menu “Connectors” do ChatGPT está ausente
O suporte MCP requer a versão da app desktop ChatGPT 1.2024.352 ou superior e uma subscrição ativa Plus, Pro, Team ou Enterprise. Atualize a app e verifique o seu plano em Settings → Account.
Servidor Cursor mostra vermelho / “Failed to connect”
Verifique se o seu ~/.cursor/mcp.json é JSON válido e contém "type": "http". Depois vá a Settings → Cursor Settings → MCP e clique em Refresh. Se o erro persistir, reinicie completamente o Cursor — as alterações na configuração nem sempre são aplicadas sem reinício.
Servidores MCP do Windsurf não aparecem nas definições
O Windsurf requer reinício completo (não só recarregar a janela) para aplicar alterações a mcp_config.json. Use File → Quit e reinicie. Se os servidores ainda não aparecerem, confirme que está na versão 1.4+ em Help → About Windsurf.
Opção “Add Server” do Cline não está visível
O gestor de servidores MCP requer o Cline 2.0 ou superior. Abra o painel de Extensões do VS Code, encontre o Cline e clique em Update se houver atualização disponível. Após atualizar, recarregue o VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Abrir Wink Portal Wink no GitHub
