​
Visão Geral

O Custom MCP permite que você conecte servidores MCP externos hospedados em sua própria infraestrutura ou serviços terceiros. Esta funcionalidade oferece máxima flexibilidade para:
  • Integrar servidores MCP próprios hospedados externamente
  • Conectar com APIs especializadas não disponíveis na biblioteca Evo AI
  • Usar autenticação customizada com headers personalizados
  • Implementar SSE (Server-Sent Events) para comunicação em tempo real
Servidores Externos: Diferente da biblioteca Evo AI, aqui você configura servidores MCP hospedados externamente. Você é responsável pela manutenção e disponibilidade desses servidores.

​
Como Configurar um Custom MCP

O processo de configuração dos Custom MCPs foi dividido em duas etapas principais:
  1. Cadastrar o Custom MCP no menu de configurações
  2. Selecionar o Custom MCP nas configurações do agente

​
Parte 1: Cadastrar Custom MCP

  1. No menu principal, vá para “Configurações”
  2. Procure pela seção “Tools & Integrations”
  3. Dentro dela, clique em “Custom MCP”
  4. Clique em “Adicionar Novo Custom MCP” ou “New Custom MCP”
  5. Você será direcionado para o formulário de cadastro
Aqui você criará uma biblioteca de Custom MCPs que poderão ser reutilizados em diferentes agentes.
Configure as informações fundamentais do seu servidor MCP:Nome do Servidor:
  • Nome identificador para o servidor
  • Usado para referência interna
  • Exemplo: “Servidor CRM Personalizado”, “API Financeira”
Descrição:
  • Descrição das funcionalidades oferecidas
  • Ajuda você e outros usuários a entender o propósito
  • Exemplo: “Integração com sistema CRM interno”
URL do Servidor MCP:
  • Endpoint completo do seu servidor MCP externo
  • Deve suportar o protocolo MCP padrão
  • Exemplo: https://meu-servidor.com/mcp
Use nomes descritivos para facilitar a identificação quando selecionar nos agentes.
Configure headers necessários para autenticação:Headers Personalizados:
{
  "Authorization": "Bearer seu-token-aqui",
  "X-API-Key": "sua-api-key",
  "X-Custom-Header": "valor-personalizado",
  "Content-Type": "application/json"
}
Tipos de autenticação suportados:
  • Bearer Token - Para APIs OAuth
  • API Key - Chaves de acesso simples
  • Basic Auth - Usuário e senha codificados
  • Custom Headers - Headers específicos da API
Headers de autenticação são armazenados de forma criptografada na plataforma.
Suporte a SSE (Server-Sent Events):
  • ✅ Streaming de respostas em tempo real
  • ✅ Atualizações contínuas de status
  • ✅ Notificações push do servidor
  • ✅ Conexões persistentes para baixa latência
Configurações avançadas:
  • Timeout: Tempo limite para conexões
  • Retry attempts: Tentativas de reconexão
  • SSE endpoint: Endpoint específico para eventos
SSE é ideal para servidores que processam tarefas longas ou fornecem atualizações em tempo real.
  1. Revise todas as configurações cuidadosamente
  2. Teste a conectividade se houver opção de teste
  3. Clique em “Salvar” ou “Save”
  4. O Custom MCP ficará disponível na sua biblioteca
Após salvar, o Custom MCP estará disponível para ser selecionado em qualquer agente.

​
Parte 2: Selecionar Custom MCP no Agente

  1. Vá para a tela de agentes no dashboard
  2. Localize o agente que deseja configurar
  3. Clique no ícone de “Configurações” (⚙️) no card do agente e em seguida em “Editar”
  4. Você será direcionado para a tela de configurações do agente
  1. Na tela de configurações do agente, localize a seção “Custom MCP”
  2. Clique em “Add” para adicionar um Custom MCP
  3. Uma lista dos Custom MCPs cadastrados será exibida
  4. Selecione os servidores que este agente deve usar
  5. Clique em “Salvar” para aplicar
Você pode selecionar múltiplos Custom MCPs para o mesmo agente. Cada agente pode ter um conjunto diferente de servidores.
Após salvar:
  • Os Custom MCPs selecionados aparecerão na lista do agente
  • O agente terá acesso às ferramentas desses servidores
  • Você pode adicionar/remover servidores a qualquer momento
Teste o agente em uma conversa para verificar se os Custom MCPs estão funcionando corretamente.

​
Vantagens do Novo Sistema

Benefícios:
  • 🔄 Reutilizar o mesmo Custom MCP em múltiplos agentes
  • 🎯 Especializar agentes com servidores específicos
  • 🛠️ Manter configurações centralizadas
  • 📊 Gerenciar todos os servidores em um lugar
Facilita trabalho em equipe:
  • 👥 Compartilhar Custom MCPs entre membros da equipe
  • 📚 Biblioteca centralizada de servidores organizacionais
  • 🔧 Manutenção simplificada de integrações
  • 📈 Evolução dos servidores sem impacto nos agentes

​
Solução de Problemas

Servidor não conecta:
  • Verifique se a URL está correta e acessível
  • Confirme se os headers de autenticação estão válidos
  • Teste conectividade de rede
  • Verifique se o servidor está online
Erro de autenticação:
  • Valide tokens e API keys
  • Confirme formato dos headers
  • Verifique se credenciais não expiraram
  • Teste autenticação diretamente no servidor
SSE não funciona:
  • Confirme se servidor suporta Server-Sent Events
  • Verifique headers específicos para SSE
  • Teste endpoint de eventos separadamente
  • Monitore logs de reconexão
Ferramentas não aparecem:
  • Verifique endpoint /mcp/capabilities
  • Confirme formato da resposta JSON
  • Valide estrutura das ferramentas
  • Teste chamadas manuais ao servidor
🔧 Custom MCP configurado! Agora você pode integrar servidores MCP externos personalizados com autenticação customizada e suporte a SSE para máxima flexibilidade!