O servidor MCP da Sweeply liga assistentes de IA como o Claude, o Cursor e o n8n aos dados operacionais em tempo real do seu hotel na Sweeply. Depois de ativado, pode perguntar em linguagem simples quantos quartos continuam sujos, que partidas não têm empregada de andares atribuída ou que problemas de manutenção estão em aberto há mais de uma semana, e obter os mesmos números que a sua equipa vê na aplicação web. O servidor está em beta e é apenas de leitura: o assistente pode consultar o seu hotel, mas ainda não pode alterar nada.

A Sweeply vende software de operações hoteleiras, pelo que este artigo descreve o nosso próprio produto. Todos os detalhes abaixo provêm da documentação MCP da Sweeply.

O que é um servidor MCP e porque é que um hotel precisa de um?

MCP significa Model Context Protocol, um padrão aberto que permite a um assistente de IA chamar ferramentas noutro software. Em vez de copiar números de relatórios e colá-los numa conversa, o assistente pergunta diretamente ao sistema e responde com dados em tempo real. Para um hotel, isto significa que um diretor geral, um diretor de alojamento ou um responsável de housekeeping pode fazer perguntas como as faria a um colega, e o assistente vai buscar a resposta à Sweeply.

A Sweeply já gere o housekeeping, a manutenção e os pedidos dos hóspedes sobre o seu PMS, com o estado dos quartos sincronizado a partir do PMS através de uma das mais de 20 integrações. O servidor MCP abre esse mesmo panorama às ferramentas de IA que os seus gestores já utilizam, sem mais um painel para aprender.

O que pode perguntar ao assistente?

O assistente pode ler a sua vista geral de housekeeping, os quartos, as tarefas, os problemas de manutenção, o horário da equipa e os relatórios. Perguntas típicas da documentação:

• “Quantos quartos continuam sujos neste momento?”

• “Que partidas de amanhã não têm empregada de andares atribuída?”

• “Mostre os problemas de manutenção em aberto há mais de uma semana.”

• “Como é a carga de trabalho da próxima semana?”

Como os quartos e os funcionários podem ser indicados pelo nome em texto simples, também pode perguntar sobre um único quarto ou pessoa. Se um nome for ambíguo, o servidor devolve os candidatos em vez de adivinhar, para que o assistente lhe possa perguntar a qual se referia.

Como é uma verificação matinal?

Um responsável de housekeeping pode começar o dia com uma breve conversa. Pedir a vista geral de hoje devolve as chegadas, as partidas, as estadias em curso e quantos quartos estão limpos, sujos ou inspecionados. Uma pergunta de seguimento como “que check-outs continuam por atribuir?” lista esses quartos por número, e “quem está de turno hoje?” mostra a equipa disponível para os assumir. Antes da reunião da tarde, “mostre os problemas de manutenção em aberto há mais de uma semana” apresenta os problemas a acompanhar, cada um com o respetivo quarto e comentários.

O assistente responde a cada pergunta com os dados em tempo real da Sweeply, por isso ninguém precisa de exportar um relatório ou de ir ao escritório ver o quadro. A atribuição dos quartos continua a ser feita na Sweeply, uma vez que a beta não faz alterações.

Que ferramentas inclui o servidor MCP da Sweeply?

A beta tem doze ferramentas de leitura em três grupos. Os assistentes chamam primeiro get_property_context, para saberem o seu fuso horário, a data de hoje e as suas categorias de tarefas antes de responderem.

As datas podem ser escritas como YYYY-MM-DD ou simplesmente como hoje, amanhã ou ontem, sempre no fuso horário do hotel. As listas param nas 50 linhas e indicam quantas linhas existem no total, para que o assistente saiba quando está a ver apenas parte de uma lista.

Como ligar o Claude, o Cursor ou o n8n?

Todos os clientes precisam das mesmas duas coisas: o endereço do servidor https://mcp.getsweeply.com e um cabeçalho Authorization com a sua chave de API da Sweeply. Os passos:

1. Peça à Sweeply que ative o MCP para o seu hotel. Durante a beta está desativado por predefinição; contacte o suporte ou o seu gestor de conta.

2. Crie uma chave de API na aplicação web da Sweeply em Definições, Conta, Chaves de API, e copie-a de imediato, pois só é mostrada uma vez.

3. Adicione o servidor ao seu assistente com o endereço e o cabeçalho Authorization: Bearer seguido da sua chave.

No Claude na web, no computador ou no telemóvel, o servidor é adicionado em Definições, Conectores, como conector personalizado com o cabeçalho Authorization. O Claude Code, o Cursor e o n8n aceitam o mesmo endereço e cabeçalho nas respetivas definições; a documentação MCP da Sweeply tem a configuração exata para cada um. O ChatGPT ainda não é suportado, porque os conectores do ChatGPT iniciam sessão com OAuth e, por agora, o servidor MCP da Sweeply aceita apenas chaves de API.

Os dados do hotel estão seguros?

A conceção mantém o assistente dentro de um único hotel e afastado dos dados pessoais dos hóspedes:

• Uma chave, um hotel. A chave de API determina que hotel o assistente lê, por isso as ferramentas nunca pedem um hotel e não conseguem aceder a outro.

• Apenas leitura. Na beta, o assistente pode consultar, mas não pode criar, alterar nem eliminar nada.

• Sem dados pessoais dos hóspedes. As reservas incluem um id, datas, quarto e número de hóspedes, nunca nomes, endereços de email ou números de telefone.

• O texto da equipa é marcado como não fiável. Os comentários, as notas e as descrições de problemas são assinalados para que o assistente os trate como informação, nunca como instruções.

• Fácil de revogar. Elimine uma chave e o assistente perde o acesso no pedido seguinte. Atribua a cada pessoa ou ferramenta a sua própria chave, para poder remover uma sem afetar as outras.

Um ponto a ter em conta: uma chave de API não é um funcionário, por isso as funções da equipa e os grupos de áreas não limitam o que ela lê. Uma chave vê o hotel inteiro. O alojamento e o tratamento de dados seguem a configuração habitual da Sweeply, descrita na nossa página de segurança.

Como se enquadra com os agentes de IA da Sweeply?

Os agentes de IA da Sweeply trabalham dentro da Sweeply: o Tracey lê as observações das reservas e transforma-as em tarefas, e o Roomey atribui quartos. O servidor MCP funciona no sentido inverso. Permite que o assistente de uso geral que os seus gestores já utilizam leia a Sweeply, para que possam combinar respostas operacionais com o seu próprio email, folhas de cálculo ou planeamento numa única conversa.

O que vem a seguir?

O servidor MCP cresce com o feedback dos clientes. Comunique à Sweeply uma pergunta a que o assistente não conseguiu responder, e a equipa responde no mesmo dia com o que pretende desenvolver; as novas ferramentas são normalmente lançadas em poucos dias e aparecem automaticamente no seu assistente, sem reinstalação nem nova chave. O roteiro na documentação inclui:

• Fazer alterações em segurança: criar e atribuir tarefas e comunicar problemas, com um início de sessão pessoal para que cada alteração seja feita em nome de um funcionário.

• Vários hotéis ao mesmo tempo: uma única ligação para um grupo hoteleiro.

• Mais assistentes: suporte de início de sessão para o ChatGPT e outros clientes que usam apenas OAuth.

Envie ideias para support@getsweeply.com ou através do chat na aplicação Sweeply, com a pergunta que fez e o que esperava receber.

Quando este guia não se aplica

O servidor MCP lê dados da Sweeply, por isso só ajuda hotéis que já gerem as suas operações na Sweeply. Não lê o seu PMS diretamente para além do que a Sweeply sincroniza, não pode fazer alterações durante a beta e ainda não está disponível no ChatGPT. Se a sua equipa não utiliza um assistente de IA no trabalho, os relatórios e a vista geral em tempo real na aplicação web da Sweeply dão os mesmos números sem ele.

Fale com a nossa equipa comercial

Quer ver como os hotéis utilizam a Sweeply e o que os seus gestores poderiam perguntar a um assistente de IA sobre o seu hotel? Reserve uma chamada com a nossa equipa comercial.