Como configurar uma conexão MCP?

Introdução

Para conectar sua conta mobile-calendar ao Claude ou ao ChatGPT, basta copiar o endereço do servidor no painel, adicioná-lo no aplicativo de IA e conceder acesso na página do mobile-calendar. Você configura a conexão uma única vez e pode revogar o acesso a qualquer momento. O artigo O que é um servidor MCP? explica o que é essa funcionalidade e o que o aplicativo pode fazer.

Instruções

Copiar o endereço do servidor

• No menu à esquerda, clique na aba Integrações -> API & MCP.
• Acesse a aba Servidor MCP.
• Na tela, será exibido o cartão “Servidor MCP” com o endereço do servidor, as etapas de conexão e as regras de segurança.

• Na seçã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 no aplicativo Claude

• No aplicativo Claude, abra as configurações e selecione Conectores (Connectors).
• Selecione a opção para adicionar um conector personalizado (Add custom connector).
• Digite um nome para o conector, por exemplo, mobile-calendar, e cole o endereço do servidor copiado.
• Confirme a adição do conector. Se o botão Conectar aparecer ao lado do conector, clique nele.
• A tela de consentimento do mobile-calendar será aberta no navegador.

Adicionar o servidor no aplicativo ChatGPT

• No ChatGPT, abra a página Plugins (Plugins) no navegador.
• Clique no botão + e selecione Adicionar servidor MCP personalizado.
• Digite um nome, por exemplo, mobile-calendar, e cole o endereço do servidor copiado no campo URL do servidor.
• Se o aplicativo perguntar o modo de login (Autenticação), selecione OAuth.
• Confirme o aviso de risco (Entendo e quero continuar) e clique em Criar como plugin.
• Instale o plugin criado para usá-lo em uma conversa.
• Durante a conexão, a tela de consentimento do mobile-calendar será aberta no navegador.

Conceder acesso

• Entre no mobile-calendar como você faz para acessar o painel. Você concede o acesso na página do mobile-calendar, e o aplicativo de IA não tem acesso à sua senha.
• Na tela de consentimento, confira:
  • o nome e o endereço do aplicativo que está solicitando acesso à conta;
  • a conta exibida abaixo de “Conectado como”;
  • a lista “O aplicativo poderá:”, que indica o escopo de acesso de acordo com suas permissões.

• Clique no botão Permitir para conectar o aplicativo. O botão Negar interrompe a conexão.
• O aplicativo será exibido na lista “Aplicativos conectados”.
• Uma mensagem “Novo aplicativo de IA conectado à conta” será enviada para o endereço de e-mail do proprietário da conta. Se um funcionário conectou o aplicativo, ele também receberá a mensagem.

O rótulo amarelo “Aplicativo não verificado” indica que não foi possível confirmar quem está por trás do aplicativo, mesmo que o nome ou o endereço pareçam conhecidos. Conecte esse aplicativo somente se tiver certeza de sua procedência.

Usar o aplicativo conectado

• Em uma conversa com o aplicativo de IA, escreva o que você precisa, por exemplo: “Quais reservas chegam amanhã?”.
• O aplicativo lerá os dados da sua conta mobile-calendar ou salvará nela a alteração que você solicitar.

Desconectar o aplicativo

• Acesse a aba Integrações -> API & MCP e, em seguida, a aba Servidor MCP.
• Na lista “Aplicativos conectados”, encontre o aplicativo cujo acesso você deseja revogar.

• Clique no botão Desconectar ao lado do aplicativo selecionado.
  • Uma janela “Desconectar o aplicativo?” será exibida no centro da tela.
  • Clique no botão Desconectar.

• O aplicativo perderá imediatamente o acesso à conta. Você poderá conectá-lo novamente mais tarde.

Quando a Assinatura expirar, os aplicativos conectados perderão o acesso à conta até que ela seja renovada.

Aplicativos dos funcionários

O funcionário conecta o aplicativo usando seu próprio login, da mesma forma que o proprietário da conta. O aplicativo só pode ver e alterar o que o funcionário pode ver e alterar no painel, de acordo com suas permissões e os quartos atribuídos a ele.

• Lista de conexões: o proprietário da conta também vê os aplicativos dos funcionários na lista “Aplicativos conectados” e pode desconectá-los. A coluna Quem conectou indica a quem pertence a conexão. O funcionário vê apenas os aplicativos conectados com seu login.
• Alteração das permissões: entra em vigor imediatamente, inclusive no aplicativo conectado.
• Perda de acesso: os aplicativos do funcionário serão desconectados se o proprietário alterar a senha ou o endereço de e-mail dele, desconectar os dispositivos dele ou remover o funcionário.

Verificar operações nos registros

• Acesse a aba Integrações -> API & MCP e, em seguida, a aba Registros.
• No campo Conta, selecione Servidor MCP na lista suspensa.

• A lista exibirá somente as operações realizadas pelos aplicativos conectados.

O item Servidor MCP aparece na lista depois que você conecta o primeiro aplicativo e inclui todos os aplicativos conectados. No campo Conta, você também pode selecionar Mobi e suas próprias contas de API. O artigo Registros descreve os outros filtros e os detalhes dos registros.

Problemas mais comuns

O aplicativo de IA pede confirmação antes de fazer uma alteração

Claude e ChatGPT podem pedir sua confirmação antes de salvar uma alteração. Essa é uma medida de segurança do aplicativo de IA, não um erro de conexão. Confira o que o aplicativo pretende alterar e confirme ou rejeite a operação.

O aplicativo recusou a operação

O aplicativo de IA externo não realiza algumas operações. Por exemplo, ele não reduzirá um preço pela metade ou mais, 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. Faça esse tipo de operação no painel ou pelo Mobi.

Não há opção para adicionar um servidor no aplicativo de IA

A possibilidade de adicionar seu próprio servidor MCP depende do plano do Claude ou do ChatGPT e, nos planos empresariais, também das permissões concedidas pelo administrador. Consulte a ajuda do aplicativo correspondente ou fale com o administrador da sua organização.

A tela de consentimento está em outro idioma

No canto superior direito da tela de consentimento, clique na bandeira de idioma e selecione seu idioma.

O aplicativo não aparece na lista “Aplicativos conectados”

Na lista “Aplicativos conectados”, clique em Atualizar. Se o aplicativo ainda não aparecer, conecte-o novamente no aplicativo de IA.