Custom MCP

Configure servidores MCP externos personalizados com SSE e autenticação customizada

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

Acessar menu de configurações

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.

Informações básicas do servidor

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.

Configuração de autenticação

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.

Configuração SSE e opções avançadas

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.

Salvar Custom MCP

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

Acessar configurações do 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

Adicionar Custom MCP ao 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.

Verificar configuração

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

Reutilização de servidores

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

Colaboração em equipe

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

Problemas comuns

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!