Saltar para o conteúdo principal

Ligar o Claude, o ChatGPT ou outras ferramentas de IA

Adicione o conector MCP da VIVIN ao Claude, ao ChatGPT, ao Gemini ou a qualquer outra ferramenta de IA que suporte servidores MCP, e depois pergunte a essa ferramenta pelas suas reservas, inquilinos e finanças sem sair dela. MCP, o Model Context Protocol, é o padrão que as ferramentas de IA usam para se ligarem a outras aplicações.

Esta página trata das ferramentas de IA usadas por si e pela sua equipa. O ChatBot para inquilinos é um produto separado.

Onde encontrar: Definições → IA / MCP, subseparador Ligação MCP (https://platform.vivin.app/settings/mcp). O aviso Ir para o MCP em Definições → Integrações abre o mesmo sítio. Precisa da permissão de função Mcp (a linha Mcp em Account Settings em Definições → Utilizadores → Permissões por função), que o Super administrador e o Administrador têm por defeito. As outras funções com esta permissão veem, em vez disso, um cartão Ligar o seu cliente de IA com os passos do Claude e do ChatGPT. Só os Super administradores e os Administradores podem criar chaves de API.

Antes de ligar​

  • Acesso: a sua função tem a permissão Mcp, e um administrador não desligou o seu Acesso à IA.
  • Pelo menos uma área ativada: pelo menos uma área tem de estar em Apenas leitura ou Edição para si. Os administradores definem isto em Definições → IA / MCP → Permissões. Se todas as áreas estiverem Desligado, a página de aprovação não o deixa continuar.
  • O URL de ligação: aparece no topo de cada guia de ligação, com um botão Copiar URL. Cole-o exatamente como aparece. Não acrescente /sse nem qualquer outra terminação.

O subseparador Ligação MCP tem um cartão para Claude, ChatGPT, Gemini e Outros clientes. Cada cartão tem um botão Adicionar que abre o guia dessa ferramenta. Os passos estão também abaixo.

Ligar o Claude​

Funciona no claude.ai e na aplicação Claude para computador. Inicia sessão com a sua conta VIVIN, por isso não é preciso nenhuma chave de API.

  1. Abra o Claude e vá a Definições.
  2. Abra Connectors.
  3. Clique em Add custom connector.
  4. Introduza um nome, por exemplo "VIVIN", e cole o URL de ligação.
  5. Clique em Add. A VIVIN abre a página de aprovação. Confirme a conta e clique em Authorize.

Ligar o ChatGPT​

Inicia sessão com a sua conta VIVIN, por isso não é preciso nenhuma chave de API.

  1. Abra o ChatGPT e vá a Definições → Connectors. Nalguns planos, isto fica no menu lateral, em Plugins.
  2. Clique em + ou New para criar um conector personalizado.
  3. Dê-lhe um nome, por exemplo "VIVIN".
  4. Em Connection, escolha Server URL e cole o URL de ligação.
  5. Em Authentication, escolha OAuth.
  6. Marque I understand and want to continue e clique em Create.
  7. Inicie sessão com a sua conta VIVIN e clique em Authorize na página de aprovação.

Ligar o Gemini ou outra ferramenta de IA​

Iniciar sessão com a sua conta VIVIN funciona para o Claude, o ChatGPT e as aplicações de IA instaladas no seu computador que suportam o início de sessão. As outras ferramentas de IA na web precisam de uma chave de API.

  1. Na sua ferramenta de IA, abra as definições de servidores MCP. As ferramentas chamam-lhe servidor MCP, conector ou ferramenta personalizada.
  2. Adicione um servidor novo e cole o URL de ligação.
  3. Se a ferramenta oferecer o início de sessão, inicie sessão com a sua conta VIVIN e aprove.
  4. Se não conseguir iniciar sessão, crie uma chave de API e envie-a como Bearer token: Authorization: Bearer <your key>.

Para as ferramentas que usam um ficheiro de configuração JSON, o guia Outros clientes mostra um Exemplo de configuração do cliente MCP com o seu URL já preenchido, e um botão Copiar configuração:

{
  "mcpServers": {
    "vivin": {
      "url": "<your connection URL>",
      "headers": {
        "Authorization": "Bearer <your key>"
      }
    }
  }
}

Criar uma chave de API​

Só os Super administradores e os Administradores o podem fazer.

  1. Vá a Definições → IA / MCP → Chaves de API e clique em Gerar chave.
  2. Introduza um Nome da chave que diga onde a vai usar, por exemplo "Claude Desktop".
  3. Escolha uma Expiração: 30 dias, 90 dias (a predefinida), 180 dias ou Nunca expira.
  4. Clique em Gerar chave.
  5. Clique em Copiar chave e cole-a de imediato na sua ferramenta de IA. A VIVIN mostra a chave uma única vez.

A tabela Chaves de API lista todas as chaves da sua conta com a data em que cada uma foi Criada, a Última utilização e quando Expira. O Estado é Ativa, Revogada ou Expirada.

Uma chave age como a pessoa que a criou, com as permissões de IA dessa pessoa. Deixa de funcionar se essa pessoa for desativada ou se o seu Acesso à IA for desligado.

A página de aprovação​

Quando o Claude, o ChatGPT ou outra ferramenta se liga por início de sessão, a VIVIN abre para ela uma página Authorize. A página mostra:

  • Signed in as: o email VIVIN e a empresa em nome dos quais a ligação vai agir, com uma ligação Sign out.
  • The following tools will be available: as áreas que está prestes a partilhar. Cada uma mostra Read-only ou Edit e o seu número de ferramentas. Expanda uma área para ver as ferramentas.
  • Authorize para ligar, ou Cancel para recusar. Se cancelar, a ferramenta de IA é informada de que o acesso foi negado.

A página nunca pede a sua palavra-passe. Usa a sessão VIVIN do seu navegador. Se não tiver sessão iniciada, clique em Sign in to VIVIN. Inicia sessão da forma habitual (código enviado por email, início de sessão com a Google) e volta à página de aprovação.

Se a página disser No MCP tools are enabled for this user yet, o Authorize fica a cinzento. Peça a um administrador que ative pelo menos uma área em Definições → IA / MCP e comece a ligação de novo.

O que a IA ligada pode ver​

A ferramenta ligada lê os mesmos dados que o Genius, o assistente integrado da VIVIN, por isso pode perguntar-lhe, por exemplo, "Que unidades estão vagas no próximo mês?". Pode ler mas não alterar os seus dados, exceto os seus próprios relatórios agendados. Tal como o Genius, recebe exatamente as suas próprias permissões de IA. Para cada área, é a mais restritiva de três definições: a definição da conta, a definição para si em Permissões por utilizador e o limite imposto pela sua função. Os administradores definem as duas primeiras em Definições → IA / MCP. Até um administrador as alterar, todas as áreas estão em Apenas leitura e os Relatórios agendados estão em Edição.

ÁreaO que a IA pode ler
ReservasReservas, vagas, próximas entradas, planos de pagamento, resumo de vendas
AnúnciosUnidades, calendários, tabelas de renda, bloqueios manuais
PropriedadesPropriedades, as suas unidades, comentários, fechaduras inteligentes
InquilinosInquilinos e as suas reservas, pedidos de serviço, inquéritos
ManutençãoTickets, número de tickets e tempo até fechar, os check-ins e check-outs de hoje, progresso e passos de check-in/out, resumo das operações, relatórios e configuração do inventário
PagamentosValores de contrato, transações, pagamentos, cauções, descontos, definições de faturação
FaturasFaturas de despesas, mapa de custos, fluxos de caixa
ProprietáriosProprietários e relatórios de proprietário
AnálisesReceita, receitas por propriedade, visão geral das finanças, dívida, ocupação, custos, taxa de fecho da manutenção, objetivos de receita
CanaisEstado dos canais e integrações ligadas
ComunicaçãoRegras e mensagens automáticas, notificações, conversas de WhatsApp e de email, definições, FAQ e monitorização do ChatBot, feedback dos inquilinos sobre o ChatBot
SuporteOs seus tickets de suporte da VIVIN e a subscrição
EquipaMembros da equipa e as suas permissões
Relatórios agendadosOs seus próprios relatórios agendados
  • Apenas leitura: a IA não pode criar, alterar nem eliminar reservas, tickets, pagamentos nem mais nada. A Edição só está disponível para os Relatórios agendados. Aí, a sua ferramenta de IA pode criar, pausar, retomar, editar ou cancelar os seus próprios relatórios recorrentes ("envia-me todas as sextas-feiras quantos quartos ainda estão vagos"). Os tipos de relatório e a entrega estão descritos na página do Genius.
  • Exportações: em cada área, a IA pode também devolver as mesmas listas que pode exportar na VIVIN, em CSV, até 20 000 linhas.
  • As ligações que funcionam como chaves nunca são enviadas: as ligações do portal do inquilino, as ligações privadas de ficheiros e os feeds de calendário são retidos. A IA diz-lhe que existe um ficheiro, que depois abre na VIVIN.
  • Ajuda sobre o produto: um conjunto de ferramentas Guia VIVIN responde a perguntas "como faço …" sobre a VIVIN. Não contêm dados da conta e não dependem das definições das áreas.
  • O seu fornecedor de IA: os dados que estas ferramentas devolvem são enviados para a ferramenta de IA que ligou. Ligue apenas ferramentas que a sua empresa permita para dados de negócio.

Manter a ligação ou remover o acesso​

Uma ligação por início de sessão é autorizada por 60 dias. O período recomeça de cada vez que a ferramenta de IA renova o seu acesso, por isso uma ligação que use com regularidade mantém-se ligada. Se a ferramenta não renovar no prazo de 60 dias, pede-lhe que volte a iniciar sessão na VIVIN.

Quando um administrador altera as permissões de IA, as ferramentas ligadas assumem a alteração pouco depois. Não precisa de voltar a ligar.

Para remover o acesso:

Para parar…Faça isto
Uma ferramenta de IARemova o conector da VIVIN nas definições dessa ferramenta
Uma ferramenta que usa uma chave de APIDefinições → IA / MCP → Chaves de API → clique no ícone do lixo ao lado da chave → Revogar. O acesso termina de imediato e não pode ser restaurado.
Todas as ferramentas de IA que um membro da equipa ligouDefinições → IA / MCP → Permissões → Permissões por utilizador → escolha o Membro da equipa → Acesso à IA Desligado → Guardar alterações
Tudo para alguém que saiDesative-o em Definições → Utilizadores. As suas ligações por início de sessão e as suas chaves de API deixam de funcionar.

A VIVIN não mostra uma lista das aplicações ligadas por início de sessão. Para cortar o acesso a um membro da equipa, desligue o seu Acesso à IA.

Dicas​

  • Navegador partilhado? Confirme Signed in as na página de aprovação. Use Sign out para mudar para a conta VIVIN certa antes de clicar em Authorize.
  • Não crie chaves de API para colegas. Uma chave tem as permissões de quem a criou. Os colegas sem a função de administrador podem ligar o Claude ou o ChatGPT iniciando sessão com a sua própria conta.
  • A Janela de histórico (dias) (em Permissões por utilizador) aplica-se também às ferramentas de IA ligadas: o histórico de dinheiro (transações, receitas, fluxos de caixa, faturas, acertos de proprietários e exportações) é cortado nessa data, e a resposta di-lo. Os registos individuais abertos um a um e os dados atuais não são limitados.
  • A Atividade do Genius no subseparador Atividade não lista o que o Claude, o ChatGPT ou outras ferramentas ligadas fizeram. A tabela Chaves de API mostra, em Última utilização, quando cada chave foi usada.
  • Os títulos das ferramentas que a sua ferramenta de IA mostra seguem o idioma da interface da VIVIN (inglês, português, espanhol ou italiano) no momento em que ligou. Os nomes técnicos das ferramentas ficam em inglês.