Como configurar a conexão MCP?

Introdução

Para conectar a sua conta mobile-calendar à aplicação Claude ou ao ChatGPT, basta copiar o endereço do servidor no painel, adicioná-lo na aplicação de IA e dar autorização na página mobile-calendar. Só precisa de configurar a conexão uma vez e pode revogar o acesso a qualquer momento. O artigo O que é o servidor MCP? explica o que é esta funcionalidade e o que a aplicação pode fazer.

Instruções

Copiar o endereço do servidor

• No menu à esquerda, clique na aba Integrações -> API e MCP.
• Vá para a aba Servidor MCP.
• Será apresentado um cartão «Servidor MCP» com o endereço do servidor, os passos para a conexão e as regras de segurança.

• Na secção «Como conectar?», clique no botão Copiar endereço.
• O endereço do campo Endereço do servidor MCP será copiado para a área de transferência.

Adicionar o servidor na aplicação Claude

• Na aplicação Claude, abra as configurações e selecione Conectores (Connectors).
• Selecione a opção para adicionar um conector personalizado (Add custom connector).
• Introduza um nome para o conector, por exemplo, mobile-calendar, e cole o endereço do servidor que copiou.
• Confirme a adição do conector. Se aparecer o botão Conectar junto ao conector, clique nele.
• A página de autorização do mobile-calendar será aberta no navegador.

Adicionar o servidor na aplicação ChatGPT

• No ChatGPT, abra a página Plugins (Plugins) no navegador.
• Clique no botão + e selecione Adicionar servidor MCP personalizado.
• Introduza um nome, por exemplo, mobile-calendar, e cole o endereço do servidor que copiou no campo URL do servidor.
• Se a aplicação perguntar o modo de autenticação (Authentication), selecione OAuth.
• Confirme o aviso de risco (Compreendo e quero continuar) e clique em Criar como plugin.
• Instale o plugin criado para o poder usar numa conversa.
• Durante a conexão, a página de autorização do mobile-calendar será aberta no navegador.

Dar autorização

• Inicie sessão no mobile-calendar como faz no painel. A autorização é concedida na página mobile-calendar, e a aplicação de IA não tem acesso à sua senha.
• Na página de autorização, verifique:
  • o nome e o endereço da aplicação que está a pedir acesso à conta,
  • a conta indicada por baixo de «Sessão iniciada como»,
  • a lista «A aplicação poderá:», que indica o âmbito de acesso correspondente às suas permissões.

• Clique no botão Permitir para conectar a aplicação. O botão Recusar interrompe a conexão.
• A aplicação aparecerá na lista «Aplicações conectadas».
• Será enviada uma mensagem com o assunto «Nova aplicação de IA conectada à conta» para o endereço de e-mail do proprietário da conta. Se um funcionário tiver conectado a aplicação, também receberá a mensagem.

A etiqueta amarela «Aplicação não verificada» significa que não foi possível confirmar quem está por detrás da aplicação, mesmo que o nome ou o endereço lhe pareçam familiares. Só conecte essa aplicação se tiver a certeza da sua origem.

Utilizar uma aplicação conectada

• Numa conversa com a aplicação de IA, escreva o que precisa, por exemplo: «Que reservas chegam amanhã?».
• A aplicação irá consultar os dados da sua conta mobile-calendar ou guardar nela a alteração que pediu.

Desconectar uma aplicação

• Aceda à aba Integrações -> API e MCP e vá para a aba Servidor MCP.
• Na lista «Aplicações conectadas», encontre a aplicação à qual pretende revogar o acesso.

• Clique no botão Desconectar junto à aplicação selecionada.
  • Aparecerá uma janela «Desconectar aplicação?» no centro do ecrã.
  • Clique no botão Desconectar.

• A aplicação perderá imediatamente o acesso à conta. Pode voltar a conectá-la mais tarde.

Quando a assinatura expirar, as aplicações conectadas perderão o acesso à conta até a assinatura ser renovada.

Aplicações dos funcionários

Um funcionário conecta uma aplicação com o seu próprio login, da mesma forma que o proprietário da conta. A aplicação só pode consultar e alterar aquilo a que o funcionário tem acesso no painel, de acordo com as suas permissões e os quartos que lhe foram atribuídos.

• Lista de conexões: o proprietário da conta também vê as aplicações dos funcionários na lista «Aplicações conectadas» e pode desconectá-las. A coluna Quem conectou indica a quem pertence a conexão. O funcionário só vê as aplicações conectadas com o seu login.
• Alteração das permissões: é aplicada imediatamente, também na aplicação conectada.
• Perda de acesso: as aplicações do funcionário serão desconectadas se o proprietário alterar a senha ou o endereço de e-mail do funcionário, terminar a sessão nos dispositivos dele ou remover o funcionário.

Consultar operações nos registos

• Aceda à aba Integrações -> API e MCP e vá para a aba Registos.
• No campo Conta, selecione Servidor MCP na lista suspensa.

• A lista mostrará apenas as operações realizadas pelas aplicações conectadas.

A opção Servidor MCP aparece na lista depois de conectar a primeira aplicação e inclui todas as aplicações conectadas. No campo Conta, também pode selecionar Mobi e as suas próprias contas de API. O artigo Registos descreve os restantes filtros e os detalhes das entradas.

Problemas mais comuns

A aplicação de IA pede confirmação antes de fazer uma alteração

O Claude e o ChatGPT podem pedir a sua confirmação antes de guardar uma alteração. Esta é uma medida de segurança da aplicação de IA, não um erro de conexão. Verifique o que a aplicação pretende alterar e confirme ou rejeite a operação.

A aplicação recusou-se a executar a operação

Uma aplicação de IA externa não executará algumas operações. Por exemplo, não reduzirá um preço para metade ou menos, não fornecerá um código de porta nem enviará uma mensagem a um destinatário que não seja o hóspede da reserva. Execute essa operação no painel ou com o Mobi.

Não existe uma opção para adicionar um servidor na aplicação de IA

A possibilidade de adicionar um servidor MCP personalizado depende do plano da aplicação Claude ou do ChatGPT e, nos planos empresariais, também das permissões concedidas pelo administrador. Consulte a ajuda da aplicação em questão ou pergunte ao administrador da sua organização.

A página de autorização está noutro idioma

No canto superior direito da página de autorização, clique na bandeira do idioma e selecione o seu idioma.

A aplicação não aparece na lista «Aplicações conectadas»

Na lista «Aplicações conectadas», clique em Atualizar. Se a aplicação continuar sem aparecer, conecte-a novamente na aplicação de IA.