> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evo-ai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Note>
  **Servidores Externos**: Diferente da biblioteca Evo AI, aqui você configura servidores MCP hospedados externamente.
  Você é responsável pela manutenção e disponibilidade desses servidores.
</Note>

## 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

<AccordionGroup>
  <Accordion icon="gear" title="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

    <Info>
      Aqui você criará uma biblioteca de Custom MCPs que poderão ser reutilizados em diferentes agentes.
    </Info>
  </Accordion>

  <Accordion icon="server" title="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`

    <Tip>
      Use nomes descritivos para facilitar a identificação quando selecionar nos agentes.
    </Tip>
  </Accordion>

  <Accordion icon="shield" title="Configuração de autenticação">
    Configure headers necessários para autenticação:

    **Headers Personalizados:**

    ```json theme={null}
    {
      "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

    <Warning>
      Headers de autenticação são armazenados de forma criptografada na plataforma.
    </Warning>
  </Accordion>

  <Accordion icon="bolt" title="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

    <Tip>
      SSE é ideal para servidores que processam tarefas longas ou fornecem atualizações em tempo real.
    </Tip>
  </Accordion>

  <Accordion icon="check" title="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

    <Info>
      Após salvar, o Custom MCP estará disponível para ser selecionado em qualquer agente.
    </Info>
  </Accordion>
</AccordionGroup>

### Parte 2: Selecionar Custom MCP no Agente

<AccordionGroup>
  <Accordion icon="robot" title="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
  </Accordion>

  <Accordion icon="plus" title="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

    <Info>
      Você pode selecionar múltiplos Custom MCPs para o mesmo agente. Cada agente pode ter um conjunto diferente de servidores.
    </Info>
  </Accordion>

  <Accordion icon="check" title="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

    <Tip>
      Teste o agente em uma conversa para verificar se os Custom MCPs estão funcionando corretamente.
    </Tip>
  </Accordion>
</AccordionGroup>

## Vantagens do Novo Sistema

<AccordionGroup>
  <Accordion icon="recycle" title="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
  </Accordion>

  <Accordion icon="users" title="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
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="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
  </Accordion>
</AccordionGroup>

***

🔧 **Custom MCP configurado!** Agora você pode integrar servidores MCP externos personalizados com autenticação customizada e suporte a SSE para máxima flexibilidade!