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 por espaço.
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 Configurações → Conexões → Conexões MCP.
Clique 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, o 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:
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.
OAuth: preencha, só se for o caso, ID do cliente OAuth (opcional), Segredo do cliente OAuth (opcional) e Permissões OAuth (opcional).
Clique em Salvar.
Conclua o processo conforme o método. Com OAuth, o Magnar inicia a autorização no serviço externo: faça login lá e autorize as permissões. Para repetir, use Autenticar na linha da conexão. Com os outros métodos, o Magnar consulta as ferramentas automaticamente depois de salvar.
Se precisar conferir ou renovar a lista de ferramentas, clique em Testar / atualizar ferramentas.
Abra um chat do mesmo espaço, escreva
/e selecione a conexão. Você também pode encontrá-la com/skill.
Autenticar aparece apenas nas conexões OAuth. Não é um passo obrigatório para os demais métodos.
Resultado esperado
A conexão aparece na lista 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>. Selecione-o ou copie-o da lista em vez de escrevê-lo de memória.
A Skill que o 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 o 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 um serviço
Na linha da conexão, clique em Desconectar. A conexão é removida do Magnar e deixa de estar disponível para novas chamadas. 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 no 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
O Magnar guarda criptografadas as credenciais necessárias para usar a conexão, e elas não aparecem na lista. Ao executar uma ferramenta, ele 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