Como conectar serviços externos por MCP
As conexões MCP permitem usar ferramentas de outros serviços pelo Assistente, para consultar informações ou realizar ações sem copiar dados à mão entre sistemas. Por exemplo, recuperar antecedentes de um processo ou atualizar o acompanhamento de um caso do escritório.
Antes de começar
Sessão iniciada e o espaço correto selecionado: o seu espaço pessoal ou uma organização da qual você seja membro.
Um serviço que ofereça um servidor MCP remoto compatível, acessível por HTTPS. Um endereço de site comum não serve: confirme com o fornecedor que ele entrega uma conexão MCP.
O endereço exato do servidor, informado pelo serviço ou pelo administrador dele.
O método de autenticação e os dados dele: token, cabeçalhos ou autorização OAuth.
Permissões no serviço externo para as ações que você quer realizar.
Você não precisa de um papel de administrador. A conexão é pessoal dentro do espaço ativo: ela não é compartilhada automaticamente com os demais membros da sua organização nem aparece nos seus outros espaços. Você pode ter até 20 conexões MCP personalizadas por espaço. Os plugins que você instala pelos Complementos não contam nesse limite.
Um servidor acessível apenas de uma rede interna ou do seu próprio computador não fica conectado só por você informar o endereço dele.
Passos
Abra Complementos → Conectores.
Clique em Adicionar → Conexão MCP personalizada.
Em Adicionar conexão, preencha Nome com uma descrição reconhecível, por exemplo "Gestão de processos".
Decida se marca Somente quando seleciono esta skill. Marcada, o uso fica reservado a você selecioná-la; sem marcar, a Magnar também pode encontrá-la quando for pertinente. As alterações passam a valer no próximo turno.
Preencha URL do servidor com o endereço que o fornecedor informou.
Em Autenticação, selecione o que o fornecedor indicar:
Automática (OAuth se necessário): vem selecionada. A Magnar detecta se o servidor exige login. Se o fornecedor informou dados adicionais, preencha-os em Configuração avançada de OAuth: Cabeçalhos (JSON), ID do cliente OAuth (opcional), Segredo do cliente OAuth (opcional) e Permissões OAuth (opcional).
Sem autenticação, para um servidor que não a exige.
Token bearer: preencha Token bearer. Você pode acrescentar Cabeçalhos (JSON) se o fornecedor exigir.
Cabeçalhos personalizados: preencha Cabeçalhos (JSON) com os nomes e valores informados pelo fornecedor.
Clique em Salvar.
Se o servidor pedir login, a Magnar abre a autorização no serviço externo: faça login lá e autorize as permissões. Para repetir, use Autenticar na ficha da conexão. Nos demais casos, a Magnar consulta as ferramentas automaticamente depois de salvar.
Se precisar conferir ou renovar a lista de ferramentas, clique em Testar / atualizar ferramentas nas ações da conexão.
Abra um chat do mesmo espaço, escreva
/e selecione a conexão. Você também pode encontrá-la com/skill.
Se o serviço que você quer usar estiver disponível como plugin, instale-o em Complementos → Descobrir. Use uma conexão MCP personalizada quando tiver o endereço de um servidor MCP compatível que você mesmo quer configurar.
Para alterar o nome, o endereço ou a configuração, abra a ficha da conexão e clique em Editar conexão. As suas credenciais salvas são mantidas, a menos que você marque Substituir as configurações de autenticação. Se você alterar a URL do servidor, terá que informar a autenticação para o novo endereço.
Resultado esperado
A conexão aparece em Complementos → Conectores com o nome e o endereço dela. Quando a lista de ferramentas está disponível, ela mostra também o comando e fica selecionável no chat. Ao atualizá-la corretamente, você verá um aviso de ferramentas atualizadas.
O comando tem o formato /mcp_<identificador>_<nome>. Consulte-o na ficha do conector ou selecione-o nas sugestões do chat, em vez de escrevê-lo de memória.
A Skill que a Magnar gera para a conexão é somente de leitura: ela não é editada nem compartilhada pela ficha de uma Skill normal. Isso não significa que as ferramentas do serviço sejam somente de leitura — algumas podem alterar dados, e a Magnar pode pedir a sua aprovação antes de executar uma ação.
Erros comuns
Um aviso pedindo para revisar os campos da conexão e tentar de novo — confira o endereço, o método e o formato dos cabeçalhos.
Um aviso de que não foi possível conectar, pedindo para revisar a URL e as credenciais ou autenticar de novo.
Um aviso de que a resposta de autenticação não é válida ou expirou — inicie Autenticar novamente.
Um aviso de que o servidor MCP devolveu um catálogo de ferramentas inválido ou incompatível — isso deve ser revisado pelo fornecedor do servidor.
Um aviso de que a conexão está ocupada, pedindo para tentar de novo.
Um aviso de que você pode conectar até 20 servidores MCP.
A conexão existe, mas não aparece como Skill: confira a autenticação dela e execute Testar / atualizar ferramentas. Salvá-la não garante que a lista de ferramentas tenha sido obtida.
O que você pode conectar
Estas são categorias compatíveis, não integrações certificadas com produtos específicos. Em todos os casos, o serviço precisa oferecer uma conexão MCP compatível:
Gestão de processos: consultar casos, responsáveis e andamentos.
Repositório documental: localizar contratos ou antecedentes aos quais você tenha acesso.
Gestão de tarefas: consultar pendências ou atualizar o acompanhamento de um caso.
As conexões MCP não substituem as integrações nativas de Drive ou E-mail, nem o trabalho em sites com o navegador.
Desconectar ou remover um conector
Desconectar conta: nas ações da conexão, retira a autorização da sua conta e mantém o conector, para que você possa se autenticar de novo depois.
Remover MCP: no menu do complemento, remove o conector da Magnar, que deixa de estar disponível para novas chamadas.
Nos dois casos, as conversas e os resultados já salvos não são apagados, e as ações já realizadas não são revertidas. Uma operação já enviada ao serviço pode terminar.
Desconectar ou remover na Magnar não equivale a revogar a permissão no fornecedor. Para uma revogação completa, remova também a autorização no serviço externo ou invalide o token por lá.
Segurança e créditos
A Magnar guarda criptografadas as credenciais necessárias para usar a conexão, e elas não aparecem na lista. Ao executar uma ferramenta, ela envia ao serviço externo os dados necessários para aquela ação, sob as permissões da conta conectada.
O trabalho do Assistente que usa uma conexão MCP pode consumir créditos, conforme o trabalho realizado. Não há uma tarifa fixa por chamada. O serviço externo pode aplicar os próprios limites ou cobranças.
Ficou com dúvidas? Fale com a gente pelo chat que ajudamos você.
Artigos relacionados