Servidores MCP

A Wink expõe dois servidores MCP autenticados. Ambos usam login interativo OAuth2 (fluxo de código de autorização PKCE) — seu agente de IA abre uma aba do navegador para que você faça login com sua conta Wink. Sem segredos de cliente para gerenciar.

Servidor	URL	O que faz
Inventory API	https://api.wink.travel/mcp	Inventário, reservas, tarifas, canais de venda, análises e todas as operações da plataforma
Integrations	https://integrations.wink.travel/mcp	Integrações de gerenciador de canais — sincronize propriedades, tarifas e disponibilidade com OTAs

---

Como a autenticação funciona

Os servidores MCP da Wink usam o fluxo OAuth2 Authorization Code + PKCE e suportam Dynamic Client Registration (RFC 7591). Veja o que acontece quando você conecta pela primeira vez:

1. Seu cliente de IA descobre o servidor de autorização a partir dos metadados /.well-known/oauth-protected-resource do endpoint MCP.
2. O cliente se registra automaticamente via Dynamic Client Registration — não é necessário configurar a aplicação manualmente.
3. O cliente abre uma aba do navegador para https://iam.wink.travel. Você faz login com sua conta Wink e aprova as permissões solicitadas na tela de consentimento.
4. A Wink emite um token de acesso vinculado à sua conta e identidade.
5. O cliente de IA anexa o token a cada requisição MCP. Todos os resultados das ferramentas são automaticamente limitados à sua entidade gestora.
6. Tokens expiram após 3 horas. Seu cliente de IA atualiza silenciosamente em segundo plano sem solicitar login novamente.

Cada chamada de ferramenta é executada sob sua identidade — as mesmas regras de ACL que protegem o portal web se aplicam ao agente de IA.

---

Conecte seu cliente de IA

Claude Code

1. Certifique-se de que o Claude Code está atualizado:

   npm install -g @anthropic-ai/claude-code

2. Adicione o servidor MCP Inventory da Wink:

   claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

3. O Claude Code contata o servidor, descobre o servidor de autorização e abre seu navegador padrão.

4. Faça login na Wink e aprove as permissões solicitadas na tela de consentimento.

5. O Claude Code confirma a conexão. Digite /mcp para verificar se o servidor aparece e suas ferramentas foram carregadas.

Para adicionar também o servidor Integrations:

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

Compartilhe com sua equipe

Adicione --scope project ao claude mcp add e o Claude Code grava a URL do servidor em .mcp.json na raiz do repositório. Faça commit desse arquivo — cada membro da equipe completa seu próprio login no navegador na primeira conexão.

Claude Desktop

1. Edite o arquivo 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

2. Adicione as entradas dos servidores MCP:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Feche completamente e reinicie o Claude Desktop (use Quit no menu — fechar a janela não é suficiente).

4. O Claude Desktop abre uma aba do navegador para cada novo servidor. Faça login na Wink e aprove as permissões.

5. O ícone de plugue na barra inferior mostra ambos os servidores como conectados.

OpenAI Codex

1. Certifique-se de que o Codex CLI está instalado:

   npm install -g @openai/codex

2. Abra (ou crie) o arquivo de configuração do Codex:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Adicione as entradas dos servidores MCP da Wink:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. Inicie o Codex. Na primeira vez, o Codex abre uma aba do navegador para https://iam.wink.travel.

5. Faça login na Wink e aprove as permissões solicitadas.

6. O Codex confirma a conexão. Execute codex e peça para listar as ferramentas disponíveis para verificar se os servidores Wink estão ativos.

Nota

O suporte MCP do Codex CLI requer a versão 1.0 ou superior. Execute codex --version para verificar e npm install -g @openai/codex para atualizar.

ChatGPT

O suporte a servidores MCP está disponível no app desktop do ChatGPT para assinantes Plus, Pro, Team e Enterprise.

1. Baixe e instale o app desktop do ChatGPT se ainda não o fez.

2. Abra o app e clique no ícone do seu perfil no canto superior direito, depois escolha Configurações.

3. Vá para Conectores (ou Servidores MCP, dependendo da versão do app) e clique em Adicionar.

4. Insira a URL do servidor Inventory da Wink:

   https://api.wink.travel/mcp

   Depois clique em Conectar.

5. O ChatGPT abre uma aba do navegador para https://iam.wink.travel. Faça login na Wink e aprove as permissões.

6. Repita os passos 4–5 para o servidor Integrations:

   https://integrations.wink.travel/mcp

7. Ambos os servidores aparecem na sua lista de Conectores. Inicie um novo chat — as ferramentas Wink estarão disponíveis automaticamente.

Limitação do app web

Servidores MCP só podem ser configurados no app desktop. A interface web do ChatGPT em chatgpt.com não suporta servidores MCP personalizados.

Cursor

1. Abra (ou crie) o arquivo de configuração MCP do Cursor:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Adicione as entradas dos servidores MCP da Wink:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Abra o Cursor. Vá para Configurações → Configurações do Cursor → MCP e confirme que ambos os servidores aparecem com indicador de status verde. Se estiverem vermelhos, clique em Atualizar.

4. O Cursor abre uma aba do navegador para https://iam.wink.travel. Faça login na Wink e aprove as permissões.

5. Abra um chat (Ctrl+L / Cmd+L) e peça para o Cursor listar as ferramentas Wink disponíveis para confirmar a conexão.

Configuração com escopo de projeto

Você também pode colocar um arquivo mcp.json na raiz do seu projeto em vez de ~/.cursor/. A configuração no nível do projeto tem prioridade e torna os servidores disponíveis para todos os membros da equipe que abrirem o projeto no Cursor.

Windsurf

1. Abra (ou crie) o arquivo de configuração MCP do Windsurf:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Adicione as entradas dos servidores MCP da Wink:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Reinicie completamente o Windsurf (Arquivo → Sair, depois reabra).

4. Vá para Configurações → Servidores MCP e verifique se ambos os servidores aparecem como conectados. O Windsurf abre uma aba do navegador para https://iam.wink.travel na primeira vez que for usado.

5. Faça login na Wink e aprove as permissões. Os servidores ficam verdes no painel de configurações após a autenticação.

Nota

O suporte MCP do Windsurf requer a versão 1.4 ou superior. Verifique em Ajuda → Sobre Windsurf e atualize no site do Windsurf se necessário.

Cline (VS Code)

O Cline é uma extensão do VS Code com um gerenciador de servidores MCP embutido. Não é necessário editar JSON manualmente.

1. Instale o Cline no Marketplace do VS Code:

   • Abra o VS Code e pressione Ctrl+Shift+X / Cmd+Shift+X
   • Procure por Cline e clique em Instalar

2. Clique no ícone do Cline na Barra de Atividades (barra lateral esquerda) para abrir o painel do Cline.

3. Clique no ícone Servidores MCP (ícone de plugue) na barra de ferramentas do Cline, depois escolha Editar Configurações MCP.

4. O VS Code abre o arquivo cline_mcp_settings.json. Adicione as entradas da Wink:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. Salve o arquivo. O Cline recarrega automaticamente e abre uma aba do navegador para https://iam.wink.travel.

6. Faça login na Wink e aprove as permissões. Ambos os servidores aparecem como ativos no painel Servidores MCP.

Alternativa: adicionar via URL

No painel Servidores MCP, clique em Adicionar Servidor e cole https://api.wink.travel/mcp diretamente. O Cline preenche a configuração automaticamente e gerencia a autenticação sem precisar editar JSON manualmente.

---

Escopos

Quando você aprova a tela de consentimento, verá um detalhamento do que o agente está solicitando. Clientes MCP usam o mesmo vocabulário de permissões do restante da plataforma — veja a referência completa de escopos na página de Autenticação.

Duas coisas são específicas do MCP:

• Os escopos mcp.read, mcp.write e mcp.remove são adicionais e obrigatórios para abrir o transporte MCP. Um cliente que possui um escopo mcp.* tem acesso a /mcp, mas cada ferramenta invocada ainda aplica o escopo da seção do endpoint que ela envolve (ex: booking.read).
• O cliente de IA solicita apenas os escopos que precisa. Você pode negar permissões individuais na tela de consentimento — ferramentas que requerem um escopo negado retornarão erro ao serem invocadas.

---

Solução de problemas

A aba do navegador não abre

Seu cliente de IA pode não suportar ainda o fluxo interativo PKCE. Verifique se está usando 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 embutido do app

401 Unauthorized após login

Seu token em cache pode estar expirado. Remova e adicione o servidor novamente para forçar um novo login:

# Claude Code
claude mcp remove wink-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

Para Claude Desktop e ChatGPT, remova a entrada do servidor nas configurações, reinicie o app e adicione novamente.

403 Forbidden ao chamar uma ferramenta específica

A ferramenta requer um escopo que você não aprovou na tela de consentimento. Reconecte o servidor — a tela de consentimento aparecerá novamente para que você aprove a permissão faltante.

O servidor aparece, mas chamadas de ferramenta retornam “conta não encontrada”

Você está logado em uma conta Wink sem entidade gestora. Acesse o Portal Wink e certifique-se de que sua conta está configurada antes de usar o servidor MCP.

Token expira durante a sessão

Tokens são válidos por 3 horas. Claude Code e Claude Desktop atualizam tokens silenciosamente sem interromper sua sessão. Se ocorrerem erros de autenticação após longo período ocioso, envie uma nova mensagem — o cliente se reautenticará automaticamente.

Codex CLI mostra “MCP server unreachable”

Verifique se seu ~/.codex/config.json é JSON válido (sem vírgulas finais) e que "type": "http" está configurado. O Codex requer transporte HTTP para servidores remotos; transporte stdio é só para binários locais.

Menu “Conectores” do ChatGPT está ausente

O suporte MCP requer o app desktop do ChatGPT versão 1.2024.352 ou superior e assinatura ativa Plus, Pro, Team ou Enterprise. Atualize o app e verifique seu plano em Configurações → Conta.

Servidor Cursor aparece vermelho / “Falha ao conectar”

Verifique se seu ~/.cursor/mcp.json é JSON válido e contém "type": "http". Depois vá em Configurações → Configurações do Cursor → MCP e clique em Atualizar. Se o erro persistir, reinicie completamente o Cursor — alterações na configuração nem sempre são aplicadas sem reinício.

Servidores MCP do Windsurf não aparecem nas configurações

O Windsurf requer reinício completo (não só recarregar janela) para aplicar mudanças em mcp_config.json. Use Arquivo → Sair e abra novamente. Se os servidores ainda não aparecerem, confirme que está na versão 1.4+ em Ajuda → Sobre Windsurf.

Opção “Adicionar Servidor” do Cline não está visível

O gerenciador de servidores MCP requer Cline 2.0 ou superior. Abra o painel de Extensões do VS Code, localize o Cline e clique em Atualizar se disponível. Após atualizar, recarregue o VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Abrir Portal Wink Wink no GitHub