> ## Documentation Index > Fetch the complete documentation index at: https://docs.morada.ai/llms.txt > Use this file to discover all available pages before exploring further. # Conector personalizado > 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. *** ## Para quem é 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. 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. *** ## Antes de começar Você precisa de duas informações, e as duas vêm do fornecedor da ferramenta, não da Morada: 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". 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. *** ## Como conectar 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. Prateleira de conectores do Morada OS, com o botão Adicionar no topo e o cartão pontilhado Adicionar conector personalizado no fim da lista **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. Caixa Adicionar conector personalizado, com os campos Nome, Endereço do servidor, Descrição e as três formas de 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. 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**. 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. 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**. Prateleira com o conector personalizado já conectado, com a etiqueta Personalizado, e o filtro Só os meus na barra de filtros *** ## O que acontece depois de conectar 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. *** ## Bloquear uma ferramenta que você não quer 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: Página do conector personalizado, com o aviso de confirmação e a lista de ferramentas com a etiqueta Perguntar antes * **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. *** ## Como remover A página do conector tem duas saídas, e elas fazem coisas diferentes: 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. 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. *** ## O que o Morada OS faz e o que não faz 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. 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. *** ## Mensagens que podem aparecer 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. 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. 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. Esse endereço já está na sua prateleira, talvez com outro nome. Procure por ele na busca dos conectores. 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. 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**. 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. Existe um teto de conectores personalizados por pessoa. Remova algum que você não usa mais para abrir espaço. Foram muitas tentativas de conexão em pouco tempo. Espere alguns instantes e tente de novo. * **Central de atendimento**: [support.morada.ai](https://support.morada.ai) * **E-mail**: `suporte@morada.ai` * **Status da plataforma**: [status.morada.ai](https://status.morada.ai) *** ## Próximos passos As ferramentas que a Morada já preparou, com o passo a passo de cada uma. O que a assistente enxerga, o que ela nunca faz sozinha e quem vê o quê.