Como ligar ao Morada OS uma ferramenta que ainda não está na prateleira, colando o endereço do servidor que o fornecedor te deu.
A prateleira de Conectores traz as ferramentas que a Morada já preparou para você. Quando a ferramenta que a sua equipe usa não está lá, e o fornecedor dela oferece um endereço para conectar assistentes de IA, você mesmo pode adicioná-la: cola o endereço, o Morada OS lista o que aquela ferramenta sabe fazer e a assistente passa a usá-la nas conversas, sempre pedindo a sua confirmação.É o mesmo movimento de instalar um aplicativo novo no celular, com uma diferença importante: o aplicativo da loja passou por uma revisão, e este endereço não passou por nenhuma.
O fornecedor da ferramenta que você usa oferece um endereço para ligá-la a assistentes de IA. Ele costuma chamar isso de servidor MCP na documentação dele.
Você confia no fornecedor
Um conector personalizado alcança um serviço que a Morada não revisou. Adicione só endereços de fornecedores que a sua empresa já usa e conhece.
Para o time de TI: cada pessoa adiciona os próprios conectores personalizados, e eles ficam visíveis só para quem os adicionou. O Morada OS aceita apenas endereços públicos que comecem com https://, recusa endereços de dentro da rede da empresa, e toda ação de um conector personalizado passa por uma confirmação da pessoa no chat. Não existe rotina automática, agendamento ou sincronização em segundo plano.
Você precisa de duas informações, e as duas vêm do fornecedor da ferramenta, não da Morada:
O endereço do servidor
Um endereço que começa com https://, algo como https://exemplo.com/mcp. Procure na documentação do fornecedor por “MCP”, “conectar a um assistente de IA” ou “integração com IA”.
A chave, se houver
Alguns servidores atendem sem pedir nada. Outros pedem uma chave de acesso, que você gera no painel do próprio fornecedor, ou um login na sua conta.
Não sabe se o serviço oferece isso? Pergunte ao suporte do fornecedor se ele tem um servidor MCP e qual é o endereço. Se a resposta for não, o conector personalizado não vai adiantar.
No menu lateral do Morada OS, clique em Conectores.Há duas portas de entrada para adicionar um conector: o botão Adicionar no canto superior direito, que abre um menu com Adicionar conector personalizado, e o cartão pontilhado com o mesmo nome, no fim da sua lista de conectores.
2
Preencher o endereço
Nome: como você quer chamar esse conector. É o nome que vai aparecer no cartão e na busca.Endereço do servidor: cole o endereço que o fornecedor te deu, começando com https://.Descrição (opcional): uma linha sobre para que serve. Ajuda você a se lembrar depois, e ajuda a busca a encontrar.
3
Dizer como o servidor pede autorização
Em Como o servidor pede autorização, escolha a opção que o fornecedor indicou:
Opção
Quando escolher
O que acontece
Login no serviço
O fornecedor pede que você entre na sua conta.
O serviço abre em uma janela própria e você autoriza, como acontece no HubSpot.
Chave de acesso
O fornecedor te deu uma chave para colar.
O Morada OS pede a chave no passo seguinte.
Sem autenticação
O servidor é público e atende sem pedir nada.
A conexão acontece na hora.
Ao escolher Chave de acesso, aparece também o campo Nome do cabeçalho. O fornecedor diz qual usar. Na dúvida, deixe Authorization, que é o mais comum.
4
Ler o aviso e confirmar
Antes do botão, a caixa mostra o aviso que vale para todo conector personalizado: a Morada não verifica esses servidores, e o servidor recebe os dados que você autorizar em cada uso.Clique em Adicionar.
5
Concluir a autorização, quando houver
Um servidor sem autenticação já fica conectado. Nos outros dois casos o cartão aparece à espera: em Chave de acesso, o Morada OS mostra a tela Informe a chave de acesso para você colar a chave; em Login no serviço, ele abre a página de login do fornecedor.A chave fica guardada de forma criptografada e não é exibida de novo em lugar nenhum. Para trocá-la, clique em Desvincular na página do conector: o campo Chave de acesso reaparece e você cola a nova. O conector continua na sua prateleira o tempo todo.
6
Pronto para usar
O conector aparece em Conectados por você, com a etiqueta Personalizado e o número de ferramentas que o servidor oferece. Quando você tem pelo menos um, a prateleira ganha o filtro Só os meus.
Um conector personalizado funciona com uma regra própria, mais rígida do que a dos conectores da prateleira: toda ferramenta pede a sua confirmação no chat, toda vez.Nos conectores que a Morada preparou, uma consulta que não altera nada roda direto e só as ações de gravar esperam o seu clique. Aqui não: como ninguém revisou o servidor, o Morada OS não confia no que ele diz sobre as próprias ferramentas, e trata todas como ação. Você continua no controle de cada passo, ao custo de um clique a mais.Na prática: sempre que a assistente precisa de uma ferramenta do conector, aparece um cartão de aprovação no chat com o que ela vai fazer, e nada acontece antes do seu clique.É essa confirmação a cada uso que protege você quando o serviço muda do outro lado. O cartão mostra a ferramenta como ela está naquele momento, então uma mudança feita pelo fornecedor nunca roda sem você ver.
Isso vale só para os conectores personalizados. HubSpot, Google Workspace, Microsoft 365 e os demais conectores da prateleira mantêm o comportamento de sempre: consultar acontece direto, gravar espera a sua aprovação.
Abra Conectores e clique no cartão do seu conector. A página lista tudo o que aquele servidor oferece, com uma etiqueta em cada ferramenta:
Perguntar antes: o Morada OS pede a sua confirmação no chat antes de usar aquela ferramenta. É como todas nascem, e não há como deixar nenhuma delas rodando sozinha.
Nunca: a ferramenta fica indisponível. A assistente não a usa nem pergunta por ela.
Use Aplicar a todas para mudar a lista inteira de uma vez, por exemplo para bloquear o conector sem removê-lo.
A página do conector tem duas saídas, e elas fazem coisas diferentes:
1
Desvincular
Encerra a sua conexão e apaga a chave ou o login guardados pelo Morada OS. O conector continua na sua prateleira, desconectado, pronto para você conectar de novo.
2
Remover conector
Tira o conector da sua prateleira de vez. A confirmação avisa: “Apagamos suas permissões e a credencial deste servidor. Você pode adicionar de novo depois.” Clique em Remover para concluir.
Os dois resolvem o lado do Morada OS. Se você gerou uma chave no painel do fornecedor, apague-a lá também: enquanto ela existir, ela continua valendo para quem a tiver.
Guarda a sua chave criptografada e a envia só para aquele servidor. Pede a sua confirmação antes de cada ação. Mostra na tela, antes do seu clique, exatamente o que vai ser enviado.
O que ele não faz
Não verifica o servidor que você colou. Não entrega o conteúdo das suas conversas ao servidor: ele recebe apenas o que você autorizar em cada uso. Não usa a ferramenta sem você pedir.
A conexão é sua e de mais ninguém: o conector que você adiciona aparece só para você, e cada colega que quiser a mesma ferramenta adiciona a dele. Também não existe rotina em segundo plano: a assistente só toca naquele servidor dentro de uma conversa que você começou.
Não foi possível usar esse endereço. Verifique a URL e tente novamente.
Esta é a resposta para qualquer endereço que o Morada OS não aceita: um erro de digitação, um endereço que não começa com https://, ou um endereço de dentro de uma rede privada, que ele recusa por segurança. Confira o endereço com a documentação do fornecedor, letra por letra, e tente de novo.
Verifique o endereço: esse nome de servidor não existe.
O nome do servidor tem algum caractere que não pode existir em um endereço, como uma vírgula ou um sublinhado. Costuma ser sobra de um “copiar e colar” que levou junto a pontuação da frase.
Este servidor já está disponível no catálogo. Conecte-se pelo card oficial.
A ferramenta que você tentou colar já está na prateleira, preparada pela Morada. Use o cartão oficial dela: ele traz ícone, descrição e o comportamento de leitura direta que o conector personalizado não tem. O link para abri-lo aparece logo abaixo da mensagem.
Você já adicionou este servidor.
Esse endereço já está na sua prateleira, talvez com outro nome. Procure por ele na busca dos conectores.
Chave inválida para este servidor. Verifique e tente novamente.
O servidor respondeu que não reconhece a chave. Como a chave foi recusada, a conexão não chegou a existir e o campo Chave de acesso continua na tela: gere ou copie a chave de novo no painel do fornecedor e cole ali. Vale conferir também se o Nome do cabeçalho é o que o fornecedor pediu.
Este servidor exige autenticação que este conector não fornece.
Você escolheu uma forma de autorização diferente da que o servidor espera, por exemplo Sem autenticação em um servidor que pede login. Remova o conector e adicione de novo escolhendo Chave de acesso ou Login no serviço.
Não foi possível conectar ao servidor MCP. Verifique a URL e tente novamente.
O endereço é válido, mas ninguém atendeu. Pode ser o servidor do fornecedor fora do ar, ou um endereço que mudou. Tente mais tarde e, se persistir, confirme o endereço com o fornecedor.
Você atingiu o limite de conectores personalizados.
Existe um teto de conectores personalizados por pessoa. Remova algum que você não usa mais para abrir espaço.
Muitas tentativas seguidas. Aguarde um instante.
Foram muitas tentativas de conexão em pouco tempo. Espere alguns instantes e tente de novo.