IA e assistentes

Como conectar o Claude ao Little Hotelier (MCP, passo a passo)

Conecte o Claude ao Little Hotelier com um conector personalizado: cole um URL, inicie sessão e permita o acesso. Prompts, segurança e problemas comuns.

10 min de leitura Hotelier Tools
Guia de configuração MCP do Hotelier Tools com a explicação What is MCP? e o Claude Desktop selecionado, que mostra os passos e o trecho de configuração com o URL do servidor MCP
Nesta página
  1. O que você precisa antes de começar
  2. Como conectar o Claude ao Little Hotelier (claude.ai e Claude Desktop)
  3. Usar uma chave de API em vez de iniciar sessão
  4. O que perguntar primeiro ao Claude
  5. O que o Claude pode fazer com os dados do seu hotel e como mantê-los seguros?
  6. Os dados dos meus hóspedes são enviados à Anthropic?
  7. Resolução de problemas
  8. Próximos passos

O Little Hotelier não tem um servidor MCP próprio (em outubro de 2026), mas você pode conectar o Claude a ele através do Hotelier Tools, que mantém um para o seu hotel. No Claude, abra Customize → Connectors → Add custom connector, cole https://dashboard.hotelier.tools/api/mcp, inicie sessão no Hotelier Tools e clique em Allow access (permitir acesso). O Claude passa a responder com base nas suas reservas em tempo real e, se você deixar, a fazer alterações.

A ideia é nova para você? Leia primeiro o que é um servidor MCP. Leva três minutos.

O que você precisa antes de começar

O Hotelier Tools lê os seus dados com o login do Little Hotelier do seu próprio hotel. Não é afiliado à SiteMinder, ao Little Hotelier nem à Anthropic, nem tem o aval deles.

Como conectar o Claude ao Little Hotelier (claude.ai e Claude Desktop)

Este é o caminho recomendado. Você inicia sessão pelo navegador, por isso não há chave para copiar. Estes passos seguem as instruções atuais da Anthropic para contas Free, Pro e Max.

  1. Abra o claude.ai ou a app Claude Desktop e vá a Customize → Connectors. Em algumas versões ainda aparece como Settings → Connectors.
  2. Clique em Add custom connector (em algumas contas: + Add e depois Add custom connector).
  3. Dê-lhe o nome Hotelier Tools e cole o URL do servidor MCP: https://dashboard.hotelier.tools/api/mcp
  4. Se o Claude perguntar como as pessoas iniciam sessão, escolha Sign in now. Se pedir um cliente OAuth, escolha Register automatically: o servidor do Hotelier Tools aceita esse registo automático. Se só vir Advanced settings, deixe-as vazias.
  5. Clique em Add e depois em Connect. Abre-se uma janela do Hotelier Tools.
  6. Inicie sessão no Hotelier Tools. Em Authorize MCP access, escolha a propriedade (só se tiver várias) e clique em Allow access.
Cartão Authorize MCP access: AI assistant (MCP client) pede acesso à sua conta do Hotelier Tools através da API MCP, o e-mail com sessão iniciada, um token que expira em 30 dias e os botões Deny e Allow access
Clique em Allow access (se tiver várias propriedades, escolha primeiro uma). O Claude nunca vê a sua palavra-passe / senha.
  1. Comece uma conversa nova, clique em +, abra Connectors e confirme que o Hotelier Tools está ativado.
  2. Faça uma primeira pergunta (exemplos abaixo). O Claude mostra que ferramenta quer usar e pergunta antes de a executar.

O início de sessão dura 30 dias. Depois disso, o Claude pede que você se conecte de novo.

Num plano Team ou Enterprise

Um Owner adiciona o conector uma vez: Organization settings → Connectors → Add → Custom → Web, com o mesmo URL. Cada colega abre depois Customize → Connectors, encontra o Hotelier Tools com a etiqueta Custom e clica em Connect. Cada conexão inicia sessão no Hotelier Tools em separado, e o Claude age com as permissões do login usado.

Na app móvel

Segundo a Anthropic, um conector que configurou no claude.ai ou no Claude Desktop também está disponível no Claude para iOS e Android. Adicionar um diretamente no telemóvel / celular ainda está em beta, por isso faça a configuração num computador.

Usar uma chave de API em vez de iniciar sessão

A maioria das pessoas deve usar o início de sessão acima. Uma chave de API é útil quando você quer um acesso que não expire ao fim de 30 dias, ou quando usa um cliente que não consegue iniciar sessão pelo navegador.

  1. No Hotelier Tools, abra Developer → API & MCP → API Keys (/developer/api-keys).
  2. Em "Generate a new key", escreva um nome como claude-desktop e clique em Generate key (gerar chave).
  3. Copie-a agora. A página avisa: "Copy this key now — it will not be shown again." (Copie esta chave agora: não voltará a ser mostrada.) As chaves começam por htk_.
Página API keys logo depois de gerar uma chave: caixa verde Key generated com o aviso Copy this key now, it will not be shown again, com a chave mascarada e um botão de copiar, a nova chave Blog integration em Active keys junto a outra chave, cada uma com Revoke, e um aviso de API key created
Crie uma chave, ou revogue uma, na página API Keys. A chave completa só é mostrada uma vez.

No claude.ai, algumas organizações veem uma área Request headers na janela do conector. A Anthropic marca-a como beta e só disponível para um conjunto limitado de organizações. Se a tiver, escolha No sign-in, adicione o cabeçalho authorization e insira Bearer htk_YOUR_API_KEY (com a palavra Bearer e um espaço).

No Claude Desktop, o ficheiro / arquivo de configuração (Settings → Developer → Edit Config) destina-se a servidores que são executados no seu próprio computador. A documentação da Anthropic diz que os servidores remotos se adicionam através de Connectors. A página MCP Setup do Hotelier Tools mostra um trecho com url + headers; se o Claude Desktop o ignorar, a solução habitual é a ponte gratuita da comunidade mcp-remote, que precisa do Node.js instalado. Esta é uma configuração típica, que não foi testada em todas as versões do Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "hotelier-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://dashboard.hotelier.tools/api/mcp",
        "--header",
        "Authorization:${HT_AUTH}"
      ],
      "env": {
        "HT_AUTH": "Bearer htk_YOUR_API_KEY"
      }
    }
  }
}

Guarde o ficheiro, feche o Claude Desktop por completo e volte a abri-lo. O cabeçalho é escrito sem espaço depois dos dois pontos de propósito: a documentação do mcp-remote explica que o Claude Desktop no Windows pode corromper os espaços nos argumentos.

Chave de API ou início de sessão: qual usar?

Início de sessão (OAuth)Chave de API (htk_…)
ConfiguraçãoCole o URL, inicie sessão, Allow accessGere uma chave, cole-a numa configuração
Duração30 dias; depois, conecte de novoAté você a revogar
Ideal paraclaude.ai, Claude Desktop, app móvelScripts, Claude Code, Cursor e VS Code
Revogar em/developer/api-keys (Active keys)/developer/api-keys

As duas funcionam da mesma forma depois de conectadas: o Claude age como a pessoa que iniciou sessão ou criou a chave, numa única propriedade, com as permissões atuais dessa pessoa.

O que perguntar primeiro ao Claude

Comece com perguntas que apenas consultam dados. Mencionar "Hotelier Tools" ajuda o Claude a escolher o conector certo em vez de pesquisar na web.

Claude

Com o Hotelier Tools, quem chega hoje e amanhã? Mostre nome, noites, quarto e qualquer saldo ainda por pagar.

Claude

Que reservas com chegada nos próximos 7 dias ainda não têm quarto atribuído?

Claude

Que hóspedes fizeram check-out na semana passada e ainda não têm fatura? Para cada um, diga-me o motivo de ainda não poder ser faturado.

Claude

Mostre-me os problemas em aberto das verificações automáticas, agrupados por data de chegada, com o que devo corrigir no Little Hotelier.

Claude

Quais são as minhas tarifas e a disponibilidade do próximo fim de semana, e como se comparam com os preços da concorrência que você tem?

Claude

Explique, passo a passo, o preço recomendado para um quarto duplo no sábado, 14 de novembro.

O Claude também pode combinar respostas: "Faça uma tabela das chegadas da próxima semana com saldos por pagar e redija um lembrete de pagamento educado para cada uma" funciona bem. Os rascunhos ficam no Claude; nada é enviado.

O que o Claude pode fazer com os dados do seu hotel e como mantê-los seguros?

O servidor MCP do Hotelier Tools oferece ao Claude mais de 100 ferramentas de hotel, sempre limitadas pelas suas permissões.

Pode ler: reservas e hóspedes, pagamentos, faturas e a preparação para faturar, tarifas e disponibilidade, preços da concorrência e recomendações de preço com as suas razões, problemas das verificações automáticas, a lista de hóspedes que não quer voltar a aceitar (do-not-rebook), a lista de espera, tarefas agendadas e os dados da propriedade lidos do Little Hotelier.

Pode alterar, quando o Claude chama a ferramenta: dados de reservas (primeiro uma proposta de antes/depois e depois um passo de aplicação que precisa de confirmed: true), registos de pagamento, a inclusão no envio da fatura no check-out, preços a partir das recomendações, stop sell por canal, entradas da lista de espera e tarefas agendadas.

Não pode fazer nada irreversível: essas ferramentas estão bloqueadas para o Claude e para qualquer outro cliente externo. Por exemplo, não pode:

  • enviar uma fatura por e-mail a um hóspede
  • fazer um reembolso
  • enviar o questionário do INE
  • convidar colegas para a conta
  • enviar por e-mail o link da fatura de um hóspede
  • responder a uma pergunta de um hóspede do Booking.com
  • executar a verificação da lista de espera que envia mensagens a hóspedes

Essas ações ficam no chat do dashboard do Hotelier Tools, atrás de um cartão de aprovação. O Claude também não pode ver outras propriedades, ir além das suas permissões nem fazer nada que o próprio Little Hotelier recusaria.

Ações de escrita: como manter o Claude seguro

Cinco hábitos mantêm isso seguro:

  1. Mantenha as aprovações ativas nas ferramentas de escrita. Em Customize → Connectors → Hotelier Tools, a Anthropic permite definir cada ferramenta como Always allow, Needs approval ou Blocked. As ferramentas de leitura podem ficar em "Always allow". Deixe em "Needs approval" tudo o que altera dados.
  2. Bloqueie o que nunca usa. Se o Claude nunca deve mexer em preços, defina apply_price_recommendations e set_channel_stop_sell como Blocked.
  3. Leia a proposta. Nas alterações de reserva, o Claude mostra primeiro um antes/depois a partir de propose_reservation_changes. Confirme a referência da reserva e os valores antes de dizer que sim.
  4. Atenção a instruções escondidas em texto. As mensagens de hóspedes e os sites são escritos por desconhecidos. Se o resultado de uma ferramenta de repente pedir ao Claude algo que você não pediu, pare. A Anthropic dá o mesmo conselho.
  5. Saiba quem está conectado. Cada conexão age como o login do Hotelier Tools que a criou. Revogue as antigas em /developer/api-keys, e sempre que alguém sair.

Os dados dos meus hóspedes são enviados à Anthropic?

Sim, as partes que o Claude lê. Quando o Claude chama uma ferramenta, o resultado (nomes de hóspedes, datas, valores) passa a fazer parte da sua conversa e é processado pela Anthropic nos termos do seu plano.

Em outubro de 2026, a Anthropic diz que os dados de treino dos planos de consumidor "does not include raw content from connectors… including remote and local MCP servers" (não incluem conteúdo bruto de conectores, incluindo servidores MCP remotos e locais), a menos que você o copie para a conversa (fonte). Nos planos comerciais (Team, Enterprise, API), as entradas e saídas não são usadas para treino por padrão.

Os dados dos hóspedes são dados pessoais e o seu hotel continua responsável por eles. Peça ao Claude só o que precisa e desative o conector nas conversas que não o exigem.

Experimente na demo

Abra o mesmo ecrã na demo do Hotelier Tools, com dados inventados. Sem registo e sem instalar nada.

Resolução de problemas

O que você vêCausa provávelO que fazer
O Claude diz que não consegue conectar, ou um erro 401O início de sessão expirou (30 dias), a chave foi revogada ou já não tem acesso à propriedadeDisconnect e Connect de novo, ou crie uma chave nova
400 "No Little Hotelier credentials configured"O Little Hotelier ainda não está conectadoConecte-o em Credentials (/credentials)
403 permission_deniedO seu login não tem acesso à APIPeça ao proprietário que dê acesso à API à sua função
423 lh_frozenO início de sessão no Little Hotelier ficou em pausa após uma falha, muitas vezes por uma palavra-passe expiradaGuarde a palavra-passe nova em Credentials ou clique em Check now & resume
As ferramentas não aparecem na conversaO conector está desativado nesta conversa, ou o Desktop não foi reiniciado+ → Connectors → ative-o; reinicie o Claude Desktop depois de editar a configuração
A janela de início de sessão nunca abrePop-ups bloqueadosPermita pop-ups para o claude.ai e tente Connect de novo

Próximos passos

Perguntas frequentes

Que planos do Claude podem adicionar um conector personalizado?

Em outubro de 2026, a Anthropic lista os conectores personalizados nos planos Free, Pro, Max, Team e Enterprise. As contas Free podem adicionar um conector personalizado. No Team e no Enterprise, um Owner adiciona-o para a organização e cada membro conecta-se depois com o seu próprio login.

A conexão com o Little Hotelier funciona na app móvel do Claude?

Sim. Depois de a configurar no claude.ai ou no Claude Desktop, a Anthropic diz que também fica disponível no Claude para iOS e Android. Adicionar novos conectores personalizados pelo telefone ainda está em beta, por isso faça a configuração num computador.

Como desconecto o Claude ou renovo o acesso?

No Claude, abra Customize, depois Connectors, e escolha Disconnect ou Remove. No Hotelier Tools, abra Developer, API Keys e, em Active keys, revogue a conexão ou a chave que usou. Revogar do lado do Hotelier Tools corta o acesso de imediato.

O Claude pode alterar as minhas reservas ou preços?

Sim, se você deixar. As ferramentas de escrita são executadas quando o Claude as chama, e o Hotelier Tools não acrescenta um segundo cartão de aprovação fora do seu próprio dashboard, por isso mantenha a aprovação por ferramenta do Claude em Needs approval. Reembolsos, envio de faturas / notas fiscais por e-mail, envio do questionário do INE e outras ações irreversíveis estão bloqueados para o Claude.

O Little Hotelier tem um servidor MCP próprio?

Não tem um servidor oficial (em outubro de 2026). O trabalho da SiteMinder com MCP serve para vender quartos através de assistentes de IA, não para os proprietários consultarem os seus próprios dados. O Hotelier Tools mantém um servidor MCP independente que se conecta com o login do Little Hotelier do seu próprio hotel.

Isto é uma integração oficial da Anthropic ou do Little Hotelier?

Não. O Hotelier Tools é independente: não é afiliado à Anthropic, à SiteMinder nem ao Little Hotelier, nem tem o aval deles. Usa o protocolo MCP padrão que o Claude suporta em qualquer conector personalizado.

Partilhar

Tudo isto está no painel do Hotelier Tools

Faturas, verificações, preços, mensagens de hóspedes e relatórios do INE para o Little Hotelier. Grátis até 10 de janeiro de 2027.