MCP da stays para o time de operação
MCP da stays para o time de operação
Pergunte sobre reservas, ocupação e faturamento direto no Claude ou no ChatGPT e receba respostas com os dados reais da sua conta. Sem programação.
A funcionalidade será ativada logo após a contratação. Ao contratar, você recebe um e-mail de confirmação em até 24 horas.
Escreva como você falaria. O assistente busca os dados na sua conta stays e responde.
"Qual foi minha taxa de ocupação em julho, imóvel por imóvel?"
"Quanto faturei este mês comparado ao mesmo mês do ano passado?"
"Monta um gráfico do meu faturamento mês a mês neste ano."
"Qual imóvel teve a maior diária média no último trimestre?"
"Quais imóveis estão sem nenhuma reserva nos próximos 15 dias?"
"Traduz a descrição do Leblon 104 para inglês e espanhol."
Veja dicas e prompts prontos para usar a IA na rotina do aluguel por temporada.
ferramentas da API da stays que o assistente pode usar
áreas da operação cobertas, das reservas ao financeiro
consultas que apenas leem dados e não mexem em nada da conta
ações que criam, alteram ou removem dados — cada uma identificada e liberada separadamente
Cada pessoa ou agente recebe a lista exata do que pode usar. O que ficou de fora nem aparece para o assistente, e qualquer tentativa de uso é bloqueada.
As credenciais ficam guardadas com criptografia, e nenhuma ferramenta do MCP consegue ler, criar ou alterar uma credencial.
Cada conta tem a própria credencial e o próprio endereço da stays, então nenhum dado é compartilhado entre clientes.
A mesma conta pode ter um acesso só para check-in e outro para reservas, cada um limitado ao que a tarefa pede.
Se a credencial não for válida, o pedido é negado na hora. O MCP também não libera um acesso mais restrito como alternativa.
Entra como conector e passa a responder sobre a stays nas conversas do dia a dia.
Usa o mesmo MCP, com as mesmas permissões, então o time continua no assistente que já conhece.
Agentes de atendimento ou de check-in usam o MCP por conta própria, cada um limitado à tarefa que executa.
O MCP conecta a sua IA à stays, enquanto a API abre a stays para os outros sistemas da empresa. Dá para contratar só o MCP ou levar os dois no mesmo plano.
Conecta o Claude, o ChatGPT ou agentes de IA à sua conta. Você faz o pedido em português e o assistente consulta ou age na stays, sem nenhuma linha de código.
Integra a stays ao site próprio, ao BI, ao ERP e às automações da empresa. Para isso, é preciso um time técnico ou um parceiro que cuide do desenvolvimento.
Para quem quer usar IA na rotina da operação
Para quem quer IA e integrações com outros sistemas
A funcionalidade será ativada logo após a contratação. Ao contratar, você recebe um e-mail de confirmação em até 24 horas. Os valores são promocionais de lançamento e estão sujeitos a alteração.
São quatro etapas: ativar o app, encontrar o menu, criar a credencial e colar os dados no assistente. Quem preferir pode copiar a instrução pronta e deixar o próprio agente de IA fazer tudo pelo navegador.
No App Center, em Todos os Apps Disponíveis, há duas opções: o app MCP, para o plano MCP, e o app API Externa + MCP, para quem também quer integrar outros sistemas. Ative a que corresponde ao seu plano.
Ao criar a primeira credencial, o app cadastra sozinho a conta da stays no servidor MCP, então ninguém precisa digitar usuário ou senha da API.
MCP por R$ 57/mês ou API + MCP por R$ 95/mês. Ver planos
O app entra no menu principal, logo abaixo de Configurações, com o ícone de robô. Dentro dele, a aba MCP Server é onde ficam as credenciais.
A lista mostra nome, Client ID, tipo de autenticação e quantas tools cada credencial alcança. A aba Logs registra o uso.
Com a lista vazia, o botão é Criar primeira credencial. Depois, Nova credencial. Cada credencial é um acesso independente, que pode ser editado ou revogado sem afetar as outras.
Um rótulo para reconhecer o acesso. Ex.: Assistente IA — somente leitura.
Você recebe um Client ID e um Client secret — e o secret aparece uma única vez. É o modo usado pelo Claude e pelo ChatGPT.
Qualquer pessoa com a URL usa as tools escolhidas, porque a URL é o único segredo. Serve só para acessos públicos, como um agente de atendimento a hóspedes.
Escolha o que essa credencial pode fazer. Todas as tools inclui também as que forem criadas depois, por isso não use para um acesso só de leitura. Para leitura, busque e marque só as de consulta (nomes que começam com get_ ou list_). Deixe de fora tudo que cria, altera, apaga ou envia.
infoHoje o seletor agrupa as tools por área (Reservas, Calendário, Financeiro…), mas não marca quais são de leitura. Confira pelo nome antes de salvar.
Abre a tela Credencial criada com três campos que se copiam com um toque: URL de acesso (MCP), Client ID e Client secret. Guarde o secret num cofre de senhas antes de clicar em Concluir, porque ele não aparece de novo.
A URL de acesso tem o formato https://mcp.stays.net/mcp?clientId=…. Cole como está, sem tirar o ?clientId=.
Clientes configurados por arquivo mandam o Client ID e o secret no cabeçalho:
{
"mcpServers": {
"stays": {
"type": "streamable-http",
"url": "<URL de acesso>",
"headers": { "Authorization": "Basic <base64 de clientId:clientSecret>" }
}
}
}
Na lista, passe o mouse na credencial e clique em Editar: dá para trocar o nome e as tools. O tipo de autenticação não muda depois de criado.
Em Editar, Revogar credencial → Confirmar revogação. O acesso cai na hora e não pode ser desfeito.
Com acesso ao navegador, o assistente abre o painel na sua sessão, cria uma credencial OAuth só de leitura e liga o conector. A sua parte é fazer o login, caso a tela peça.
Você vai configurar o MCP da stays para mim, sozinho, usando o navegador. Objetivo: criar uma credencial MCP só de leitura, com autenticação OAuth, e conectar essa credencial ao assistente que eu uso (Claude ou ChatGPT). REGRAS - Use a ferramenta de interação com o navegador do usuário. Trabalhe na minha sessão já logada. - Nunca me peça senha e nunca digite senha. Se alguma tela pedir login, pare, peça que eu entre e continue quando eu avisar. - Não crie, altere nem revogue nada além do que está descrito aqui. Se aparecer algo inesperado, pare e me pergunte. - O Client secret aparece uma única vez. Use-o só para preencher o conector, não o repita na conversa e me lembre de guardá-lo num cofre de senhas. PASSO 1 — ABRIR O APP 1. Se não souber o endereço do meu painel stays (ex.: https://minhaconta.stays.net), pergunte. Depois abra o painel. 2. No menu principal, logo abaixo de "Configurações", abra o app "MCP" (ícone de robô). Ele fica no App Center, na categoria "API Stays". 3. Dentro do app, abra a aba "MCP Server". PASSO 2 — CRIAR A CREDENCIAL SÓ DE LEITURA 1. Clique em "Nova credencial" (ou "Criar primeira credencial", se a lista estiver vazia). 2. Nome: "Assistente IA — somente leitura". 3. Autenticação: "OAuth (client ID + secret)". Não use "Livre (sem autenticação)". 4. Tools: NÃO marque "Todas as tools" nem uma categoria inteira. Use a busca e marque, uma a uma, só ferramentas de consulta: nomes que começam com get_ ou list_, e buscas que apenas leem dados. Não marque nenhuma que crie, altere, apague, envie ou cancele (nomes com post_, put_, patch_, delete_, create, update, send, cancel). Na dúvida, deixe de fora. 5. Antes de salvar, me mostre a lista de tools marcadas e espere eu confirmar. 6. Clique em "Criar credencial". 7. Na tela "Credencial criada", copie a "URL de acesso (MCP)", o "Client ID" e o "Client secret". Depois clique em "Concluir". PASSO 3 — CONECTAR AO MEU ASSISTENTE Se não estiver claro qual eu uso, pergunte. Claude (claude.ai ou app): 1. Configurações → Conectores → Adicionar conector personalizado. 2. Nome: stays. URL do servidor: a URL de acesso inteira (termina em /mcp?clientId=…; não altere). 3. Em Configurações avançadas, preencha OAuth Client ID e OAuth Client Secret. 4. Adicione e clique em Conectar. A autorização volta sozinha, sem tela de consentimento. ChatGPT: 1. Configurações → Apps e conectores → Avançado: ative o modo desenvolvedor, se o plano exigir. 2. Criar conector: nome stays; URL do servidor MCP = a URL de acesso inteira; autenticação OAuth com o Client ID e o Client secret. 3. Salve e conecte. PASSO 4 — CONFERIR 1. Numa conversa nova, com o conector stays ativo, peça: "Liste as ferramentas da stays disponíveis" e depois "Quais check-ins tenho amanhã?". 2. Confirme que nenhuma ferramenta de criação, alteração, exclusão ou envio aparece. 3. Me devolva um resumo com: nome da credencial, Client ID, quantas tools foram liberadas e o resultado do teste. Não inclua o Client secret no resumo.
Novos recursos, correções e problemas identificados ficam registrados numa página só, para o time técnico saber o que mudou antes de mexer na integração.