Saltar para o conteúdo
PipMCP

Integração · Agendamento

Conecte Claude e ChatGPT ao Cloudbeds

Pergunte à sua IA sobre os chegamentos de hoje, quais quartos estão livres no próximo fim de semana ou quais ainda precisam de limpeza, e obtenha a resposta do Cloudbeds. Ela pode pesquisar reservas e hóspedes, verificar disponibilidade e tarifas, e ler o painel da recepção. Também pode criar reservas, atribuir quartos, fazer check-in e check-out, adicionar cobranças e notas, registrar pagamentos e definir o status de limpeza.

Ligar Cloudbeds gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

  • “Como fica hoje na recepção?”

    A IA lê o painel: chegadas, partidas, hóspedes em casa, ocupação e quartos disponíveis.

  • “Temos um quarto para 2 adultos entre 14 e 16 de março?”

    Ela verifica a disponibilidade para as datas e lista os tipos de quartos livres, com preços.

  • “Quais quartos estão sujos agora?”

    Ela lista os quartos com status de limpeza sujo, ocupação e o zelador atribuído.

O que a sua IA pode fazer

Reservas e hóspedes

Pesquisar, criar e atualizar reservas, adicionar hóspedes e notas, e procurar ou atualizar perfis de hóspedes.

Quartos e tarifas

Verificar disponibilidade, listar tipos de quartos, quartos e planos de tarifa, atribuir ou mover quartos e ver quartos não atribuídos.

Folios e limpeza

Adicionar itens e pagamentos a um folio, listar métodos de pagamento e extras, e ler ou definir o estado do quarto.

  • “Faça check-in da reserva Hansen e coloque-os no quarto 12.”

    Ela encontra a reserva, atribui o quarto e faz o check-in dos hóspedes.

  • “Adicione dois pequenos-almoços à reserva Hansen e anote que chegam atrasados.”

    Ela adiciona o item de pequeno-almoço ao folio e uma nota interna à reserva.

  • “O hóspede pagou 1.200 em dinheiro na recepção. Registre-o.”

    Ela procura o código para dinheiro e registra o pagamento no folio. Nenhum cartão é cobrado.

115 ferramentas para Cloudbeds

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

  • add_guest_to_reservationAltera dadosAdicionar um hóspede extra a uma reserva existente (`reservation_id`) com nome, e-mail, telefone, endereço e detalhes do documento de identificação.
  • add_items_to_reservationAltera dadosAdicionar itens personalizados (cobranças), como extras ou serviços, ao folio de uma reserva via `reservation_id` e `items` (nome, quantidade, preço).
  • add_reservation_noteAltera dadosAdicionar um comentário interno (`reservation_note`) a uma reserva feita por `reservation_id`.
  • assign_roomAltera dadosAtribuir ou mover o quarto de uma reserva: passar `reservation_id` e `new_room_id` (e `old_room_id` ao mover).
  • check_availabilityVerificar quais tipos de quarto estão disponíveis e seus preços para `start_date` a `end_date` com o número de `rooms`, `adults` e `children`.
  • check_in_roomAltera dadosCheck-in de uma reserva (`reservation_id`), opcionalmente apenas um quarto (`room_id`).
  • check_out_roomAltera dadosCheck-out de uma reserva (`reservation_id`), opcionalmente apenas um quarto (`room_id`).
  • create_access_tokenElimina dadosCriar um novo token de acesso. Ação destrutiva; pode exigir aprovação. Resumo da API: accesstoken.
  • create_accountAltera dadosCriar uma nova conta. Resumo da API: postNewHouseAccount.
  • create_adjustmentAltera dadosCriar um novo ajuste. Resumo da API: postAdjustment.
  • create_allotment_blockAltera dadosCriar um novo bloco de alocação. Resumo da API: createAllotmentBlock.
  • create_app_errorAltera dadosCriar um novo erro do aplicativo. Resumo da API: postAppError.
  • create_app_property_settingAltera dadosCriar uma nova configuração de propriedade do aplicativo. Resumo da API: postAppPropertySettings.
  • create_app_stateAltera dadosCriar um novo estado do aplicativo. Resumo da API: postAppState.
  • create_categoryAltera dadosCriar uma nova categoria. Resumo da API: postItemCategory.
  • create_credit_cardAltera dadosCriar um novo cartão de crédito. Resumo da API: postCreditCard.
  • create_custom_fieldAltera dadosCriar um novo campo personalizado. Resumo da API: postCustomField.
  • create_documentAltera dadosCriar um novo documento. Resumo da API: postGuestDocument.
  • create_document_2Altera dadosCriar um novo documento. Resumo da API: postReservationDocument.
  • create_document_postAltera dadosCriar um novo documento. Resumo da API: postFile.
  • create_email_scheduleVisível para outras pessoasCriar um novo agendamento de e-mail. Tem efeitos visíveis fora deste sistema. Resumo da API: postEmailSchedule.
  • create_email_templateVisível para outras pessoasCriar um novo modelo de e-mail. Tem efeitos visíveis fora deste sistema. Resumo da API: postEmailTemplate.
  • create_government_receiptAltera dadosCriar uma nova nota fiscal governamental. Resumo da API: postGovernmentReceipt.
  • create_guest_photoAltera dadosCriar uma nova foto de hóspede. Resumo da API: postGuestPhoto.
  • create_guests_to_roomAltera dadosCriar um novo grupo de hóspedes para quarto. Resumo da API: postGuestsToRoom.
  • create_housekeeperAltera dadosCriar um novo zelador. Resumo da API: postHousekeeper.
  • create_housekeeping_assignmentAltera dadosCriar uma nova atribuição de limpeza. Resumo da API: postHousekeepingAssignment.
  • create_inventoryAltera dadosCriar um novo inventário. Resumo da API: postItemsToInventory.
  • create_messageAltera dadosCriar uma nova mensagem. Resumo da API: createAllotmentBlockNotes.
  • create_message_2Altera dadosCriar uma nova mensagem. Resumo da API: postGuestNote.
  • create_message_postAltera dadosCriar uma nova mensagem. Resumo da API: postGroupNote.
  • create_payment_2Altera dadosCriar um novo pagamento. Resumo da API: postVoidPayment.
  • create_payment_3Movimenta dinheiroCriar um novo pagamento. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: postCharge.
  • create_payment_postAltera dadosCriar um novo pagamento. Resumo da API: postCustomPaymentMethod.
  • create_productAltera dadosCriar um novo produto. Resumo da API: postItem.
  • create_product_2Altera dadosCriar um novo produto. Resumo da API: appendCustomItem.
  • create_product_3Altera dadosCriar um novo produto. Resumo da API: postVoidItem.
  • create_reservationAltera dadosCriar uma reserva com datas (`start_date`, `end_date`), nome do hóspede, email e país, `rooms` (tipo de quarto e quantidade), adultos, crianças, `source_id` e `payment_method`. O hóspede pode receber um email de confirmação de reserva.
  • create_room_blockAltera dadosCriar um novo bloqueio de quartos. Resumo da API: postRoomBlock.
  • create_webhookElimina dadosCriar um novo webhook. Ação destrutiva; pode exigir aprovação. Resumo da API: postWebhook.
  • delete_adjustmentsMovimenta dinheiroExcluir permanentemente uma cobrança. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: deleteAdjustment.
  • delete_allotment_blocksElimina dadosExcluir permanentemente um bloqueio de alocação. Ação destrutiva; pode exigir aprovação. Resumo da API: deleteAllotmentBlock.
  • delete_app_property_settingsElimina dadosExcluir permanentemente uma configuração de propriedade do app. Ação destrutiva; pode exigir aprovação. Resumo da API: deleteAppPropertySettings.
  • delete_messagesMovimenta dinheiroExcluir permanentemente uma mensagem. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: deleteGuestNote.
  • delete_messages_deleteMovimenta dinheiroExcluir permanentemente uma mensagem. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: deleteReservationNote.
  • delete_room_blocksElimina dadosEliminar permanentemente um bloco de quarto. Ação destrutiva; pode exigir aprovação. Resumo da API: deleteRoomBlock.
  • delete_webhooksMovimenta dinheiroEliminar permanentemente um webhook. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: deleteWebhook.
  • get_dashboardObter o resumo do balcão de hoje (ou de um `date` específico): chegadas, partidas, hóspedes em casa, ocupação e quartos disponíveis.
  • get_guestObter o perfil de um hóspede pelo `guest_id` ou `reservation_id`: detalhes de contato, endereço, documentos e notas.
  • get_property_detailsObter detalhes do alojamento: nome, endereço, informações de contacto, moeda, horários de entrada/saída e políticas.
  • get_reservationObter uma reserva por `reservation_id` com hóspedes, quartos, datas, saldo e estado.
  • list_accountsListar contas. Filtros opcionais: ID do imóvel. Resumo da API: getHouseAccountList.
  • list_allotment_blocksListar blocos de alocação. Filtros opcionais: ID do imóvel, código do bloco de alocação, nome do bloco de alocação, código do grupo, ID do perfil do grupo ou código do evento. Os resultados são paginados. Resumo da API: getAllotmentBlocks.
  • list_app_property_settingsListar configurações do aplicativo para o imóvel. Filtros opcionais: ID do imóvel. Resumo da API: getAppPropertySettings.
  • list_app_settingsListar configurações do aplicativo. Filtros opcionais: ID do imóvel. Resumo da API: getAppSettings.
  • list_app_statesListar estados do aplicativo. Filtros opcionais: ID do imóvel. Resumo da API: getAppState.
  • list_categoriesListar categorias. Filtros opcionais: ID do imóvel. Resumo da API: getItemCategories.
  • list_currency_settingsListar configurações de moeda. Filtros opcionais: ID do imóvel. Resumo da API: getCurrencySettings.
  • list_custom_fieldsListar campos personalizados. Filtros opcionais: ID do imóvel, ID do campo personalizado ou shortcode. Resumo da API: getCustomFields.
  • list_documentsListar documentos. Filtros opcionais: ID do imóvel, código do grupo, ordenar por, ordenar por ou nome. Os resultados são paginados. Resumo da API: getFiles.
  • list_email_schedulesListar agendamentos de e-mail. Filtros opcionais: ID do imóvel. Resumo da API: getEmailSchedule.
  • list_email_templatesListar modelos de e-mail. Filtros opcionais: ID do imóvel. Resumo da API: getEmailTemplates.
  • list_groupsListar grupos. Filtros opcionais: ID do imóvel, código do grupo, ID do perfil do grupo, tipo, status ou criado a partir de. Os resultados são paginados. Resumo da API: getGroups.
  • list_guest_listsListar listas de hóspedes. Filtros opcionais: IDs do imóvel, resultados a partir de, resultados até, check-in a partir de, check-in até ou check-out a partir de. Os resultados são paginados. Resumo da API: getGuestList.
  • list_guests_getListar hóspedes. Filtros opcionais: status, ID do imóvel, resultados a partir de ou resultados até. Os resultados são paginados. Resumo da API: getGuestsByStatus.
  • list_guests_modifiedsListar hóspedes modificados. Filtros opcionais: ID do alojamento, em casa, data de início/fim dos resultados, check-in ou check-out. Resultados paginados. Resumo da API: getGuestsModified.
  • list_hotelsListar alojamentos. Filtros opcionais: ID do alojamento, nome ou cidade do alojamento. Resultados paginados. Resumo da API: getHotels.
  • list_housekeepersListar hóspedes de limpeza. Filtro opcional: ID do alojamento. Resultados paginados. Resumo da API: getHousekeepers.
  • list_housekeeping_statusListar o estado de limpeza das quartos (limpo/sujos, ocupado, responsável pela limpeza), filtrado por `room_condition`, `room_occupied`, quartos ou responsáveis.
  • list_itemsListar itens extras/produtos (ex: pequeno-almoço, estacionamento) que podem ser adicionados a uma fatura.
  • list_messagesListar mensagens. Filtros opcionais: ID do alojamento, código de bloco de aforamento ou estado. Resultados paginados. Resumo da API: listAllotmentBlockNotes.
  • list_messages_2Listar mensagens. Filtros opcionais: ID do alojamento ou ID do hóspede. Resumo da API: getGuestNotes.
  • list_messages_getListar mensagens. Filtros opcionais: ID do alojamento ou código de grupo. Resultados paginados. Resumo da API: getGroupNotes.
  • list_metadataListar metadados.
  • list_package_namesListar nomes de pacotes. Filtro opcional: ID do alojamento. Resumo da API: getPackageNames.
  • list_packagesListar pacotes. Filtros opcionais: ID do alojamento. Resumo da API: getPackages.
  • list_payment_methodsListar os métodos de pagamento aceites pelo alojamento, com os códigos a utilizar ao registar um pagamento.
  • list_payments_getListar pagamentos. Filtro opcional: ID do alojamento. Resumo da API: getPaymentsCapabilities.
  • list_productsListar produtos. Filtros opcionais: ID do alojamento ou ID de item. Resumo da API: getItem.
  • list_projectsListar projetos. Filtros opcionais: referência do trabalho ou estado. Resumo da API: getRateJobs.
  • list_rate_plansListar planos de taxa e preços para `start_date` a `end_date`, opcionalmente para um tipo de quarto ou código promocional.
  • list_ratesListar taxas. Filtros opcionais: ID do tipo de quarto, data inicial, data final, adultos, crianças ou taxas detalhadas. Resumo da API: getRate.
  • list_reservation_assignmentsListar atribuições de reserva. Filtros opcionais: ID do alojamento ou data. Resumo da API: getReservationAssignments.
  • list_reservation_notesListar as notas internas de uma reserva por `reservation_id`.
  • list_reservation_room_detailsListar detalhes do quarto da reserva. Filtros opcionais: ID do alojamento ou ID de sub-reserva. Resumo da API: getReservationRoomDetails.
  • list_reservations_with_ratesListar reservas com detalhes de tarifa noturna, filtradas por datas de saída, `modified_from`/`modified_to` ou `guest_id`. Útil para perguntas sobre receita.
  • list_room_blocksListar blocos de quartos. Filtros opcionais: ID da propriedade, ID do bloco de quarto, ID do tipo de quarto, ID do quarto, data inicial ou final. Os resultados são paginados. Resumo da API: getRoomBlocks.
  • list_room_typesListar tipos de quarto com capacidade, descrição e fotos.
  • list_roomsListar os quartos da propriedade junto com seus tipos; com `start_date`/`end_date` mostra quais quartos estão livres.
  • list_rooms_fees_and_taxesListar taxas e impostos dos quartos. Filtros opcionais: ID da propriedade, data inicial, data final, total de quartos, quantidade de quartos ou adultos por quarto. Resumo da API: getRoomsFeesAndTaxes.
  • list_sourcesListar fontes de reserva (direta, Booking.com, presencial...) com seus IDs para criar reservas.
  • list_taxes_and_feesListar impostos e taxas. Filtros opcionais: ID da propriedade, incluir excluídos, incluir expirados, incluir impostos personalizados, disponível para ou ID da fonte. Resumo da API: getTaxesAndFees.
  • list_unassigned_roomsListar quartos que ainda não foram atribuídos a nenhuma reserva hoje.
  • list_userinfosListar informações de usuário. Filtros opcionais: ID da propriedade, ID da organização ou detalhes do papel.
  • list_usersListar usuários. Filtros opcionais: IDs das propriedades. Resumo da API: getUsers.
  • list_webhooksListar webhooks. Filtros opcionais: ID da propriedade. Resumo da API: getWebhooks.
  • record_paymentAltera dadosRegistrar um pagamento no folio da reserva (`reservation_id`) com `type` (código do método de pagamento), `amount` e `description`. Isso apenas registra o pagamento no Cloudbeds; não cobra um cartão.
  • search_guestsLocalizar hóspedes por `status` (em casa, não check-in, check-out, cancelado) e opcionalmente `guest_name`, quarto, reserva ou datas de check-in/check-out. Resumo da API: searchGuests.
  • search_reservationsPesquisar reservas por `status`, hóspede `first_name`/`last_name`, faixas de data de check-in/check-out, quarto, origem ou `modified_from`. Retorna IDs de reserva; use `page` e `limit` para paginação.
  • set_housekeeping_statusAltera dadosDefinir o `room_condition` (limpo, sujo, inspecionado), não perturbar, serviço recusado ou comentários do `room_id` de uma sala.
  • update_accountsVisível para outras pessoasAtualizar uma conta existente. Tem efeitos visíveis fora deste sistema. Resumo da API: putHouseAccountStatus.
  • update_allotment_blocksAltera dadosAtualizar um bloco de alocação existente. Resumo da API: updateAllotmentBlock.
  • update_app_property_settingsAltera dadosAtualizar uma configuração de propriedade de aplicativo existente. Resumo da API: putAppPropertySettings.
  • update_groupsAltera dadosAtualizar um grupo existente. Resumo da API: patchGroup.
  • update_groups_putAltera dadosAtualizar um grupo existente. Resumo da API: putGroup.
  • update_guestVisível para outras pessoasAtualizar os detalhes de um convidado por `guest_id`: nome, e-mail, telefone, endereço, data de nascimento, empresa ou documento de identificação. Apenas os campos que você passar são alterados.
  • update_housekeepersVisível para outras pessoasAtualizar um zelador existente. Tem efeitos visíveis fora deste sistema. Resumo da API: putHousekeeper.
  • update_inventoriesVisível para outras pessoasAtualizar um inventário existente. Tem efeitos visíveis fora deste sistema. Resumo da API: putItemToInventory.
  • update_messagesAltera dadosAtualizar uma mensagem existente. Resumo da API: updateAllotmentBlockNotes.
  • update_messages_2Visível para outras pessoasAtualizar uma mensagem existente. Tem efeitos visíveis fora deste sistema. Resumo da API: putReservationNote.
  • update_messages_putVisível para outras pessoasAtualizar uma mensagem existente. Tem efeitos visíveis fora deste sistema. Resumo da API: putGuestNote.
  • update_ratesAltera dadosAtualizar uma tarifa existente. Resumo da API: patchRate.
  • update_rates_putAltera dadosAtualizar uma tarifa existente. Resumo da API: putRate.
  • update_reservationVisível para outras pessoasAtualizar uma reserva com `reservation_id`: alterar `status` (confirmada, cancelada, check-in, check-out, no-show...), data de saída, quartos, horário de chegada ou campos personalizados. `send_status_change_email` envia um e-mail ao hóspede.
  • update_room_blocksVisível para outras pessoasAtualizar um bloco de quarto existente. Os efeitos são visíveis fora deste sistema. Resumo da API: putRoomBlock.

Configure em três passos

  1. 1

    Escolha a aplicação

    Crie uma conta gratuita no PipMCP e escolha Cloudbeds na lista de aplicações.

  2. 2

    Cole a sua chave

    Cole uma chave da API Cloudbeds. Sua propriedade precisa de acesso à API. No Cloudbeds clique em Conta > Apps & Marketplace > Credenciais da API, clique em + Novas Credenciais, nomeie-a (o https://localhost é suficiente) e salve. Em seguida, clique em Criar na coluna Chave da API, marque as permissões necessárias, aprove com seu login do Cloudbeds e copie a chave. Ela é mostrada apenas uma vez.

  3. 3

    Adicione a ligação à sua IA

    Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:

    1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
    2. Cole a sua ligação no campo URL do servidor MCP remoto.
    3. Ative-o no menu + de uma conversa.

Perguntas

O que a IA pode fazer no Cloudbeds?

A IA pode ler o painel, detalhes da propriedade, reservas, hóspedes, quartos, tipos de quarto, planos de tarifa, disponibilidade, status de limpeza, notas, fontes, itens e métodos de pagamento. Ela pode criar e atualizar reservas, adicionar hóspedes, itens e notas, atribuir quartos, fazer check-in e check-out, registrar pagamentos, atualizar detalhes do hóspede e definir o status de limpeza.

A IA vê minhas credenciais do Cloudbeds?

Não. Suas credenciais Cloudbeds estão criptografadas em repouso e nunca são exibidas à IA. Após salvar, elas não aparecem novamente, nem mesmo para você. A IA só vê os resultados das ferramentas que chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, podendo começar com acesso de leitura apenas. Atualizar uma reserva pode cancelá-la ou enviar e-mail ao hóspede, e atualizar um hóspede altera seu perfil; ambos podem exigir sua aprovação antes de rodar. Todas as chamadas de ferramenta são registradas.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá em Configurações › Aplicações & Conectores › Avançado e ative o Modo Desenvolvedor, depois adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona também no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.

Qual é o custo?

O PipMCP tem um plano gratuito sem cartão de crédito necessário. Planos pagos cobram por tarefa concluída. Você também precisa de sua própria conta Cloudbeds.

Gravar um pagamento cobra o cartão do hóspede?

Não. Gravar um pagamento apenas adiciona-o ao folio da reserva no Cloudbeds, por exemplo dinheiro recebido na recepção. Não cobra um cartão. A IA usa os códigos de método de pagamento da propriedade para registrá-lo com o tipo correto.

Integrações relacionadas

Deixe a sua IA trabalhar em Cloudbeds ainda hoje.

Comece gratuitamente. A sua chave permanece encriptada e é você quem decide o que a IA pode fazer.

Ligar Cloudbeds gratuitamente

O PipMCP não tem qualquer afiliação com Cloudbeds. Os nomes dos produtos são marcas comerciais dos respetivos titulares.