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

# MCP Server

> Configure servidores MCP (Model Context Protocol) para estender as capacidades dos seus agentes

## Visão Geral

O **MCP Server** (Model Context Protocol) permite que você conecte seus agentes a servidores externos que fornecem ferramentas e funcionalidades adicionais. A **Evo AI fornece uma biblioteca completa** de servidores MCP pré-configurados, permitindo que você expanda as capacidades dos seus agentes com:

* **APIs externas** e serviços web
* **Bancos de dados** e sistemas de armazenamento
* **Ferramentas especializadas** para tarefas específicas
* **Recursos do sistema** local ou remoto

<Note>
  **Biblioteca Evo AI**: Os servidores MCP são fornecidos e mantidos pela Evo AI.
  Você só precisa configurar as variáveis necessárias e selecionar as ferramentas desejadas.
</Note>

## Como Configurar um MCP Server

### Passo 1: Acessar Configurações do Agente

<AccordionGroup>
  <Accordion icon="gear" title="Navegar para configurações">
    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="server" title="Acessar MCP Servers">
    1. Na tela de configurações, localize a seção **"MCP Servers"**
    2. Clique em **"Add"** para adicionar um novo servidor MCP

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/mcp_server01_option.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=d3e52aaa66f71d1bec66599dd219b1e9" alt="Opção para Adicionar MCP Server" width="1148" height="372" data-path="images/prints/mcp_server01_option.png" />

    <Info>
      Cada agente pode ter múltiplos servidores MCP configurados simultaneamente.
    </Info>
  </Accordion>
</AccordionGroup>

### Passo 2: Selecionar Servidor MCP

<AccordionGroup>
  <Accordion icon="list" title="Escolher da biblioteca Evo AI">
    1. Uma **biblioteca de servidores MCP** mantida pela Evo AI será exibida
    2. Navegue pela lista e selecione o servidor que atende às suas necessidades
    3. Cada servidor tem uma descrição das funcionalidades que oferece
    4. **Todos os servidores são pré-testados** e mantidos pela equipe Evo AI

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/mcp_server02_select.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=2581ca73fb39553c419935e0f5c6255e" alt="Biblioteca de Servidores MCP da Evo AI" width="1101" height="756" data-path="images/prints/mcp_server02_select.png" />

    <Info>
      **Biblioteca Curada**: Todos os servidores MCP são selecionados, testados e mantidos pela Evo AI para garantir qualidade e confiabilidade.
    </Info>
  </Accordion>
</AccordionGroup>

### Passo 3: Configurar Variáveis e Ferramentas

<AccordionGroup>
  <Accordion icon="gear" title="Configurar variáveis do servidor">
    1. Após selecionar o servidor da biblioteca, você verá a **tela de configuração**
    2. Preencha apenas as **variáveis necessárias** (como API keys, URLs, credenciais)
    3. **Não é necessário configurar o servidor** - ele já está pronto para uso
    4. A Evo AI cuida de toda a infraestrutura e manutenção

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/mcp_server03_condif_server.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=00b66ab68c8e357d2688f4c2b2c5809b" alt="Configuração Simples do Servidor MCP" width="1069" height="1170" data-path="images/prints/mcp_server03_condif_server.png" />

    <Tip>
      Você só precisa fornecer suas credenciais específicas. Todo o resto já está configurado pela Evo AI.
    </Tip>
  </Accordion>

  <Accordion icon="wrench" title="Selecionar ferramentas disponíveis">
    **Na mesma tela de configuração:**

    1. **Visualize as ferramentas** já disponibilizadas pelo servidor
    2. **Marque as ferramentas** que seu agente irá utilizar
    3. **Configure parâmetros específicos** apenas se necessário
    4. **Teste a conectividade** antes de salvar

    **Vantagens da biblioteca Evo AI:**

    * 🔍 **Ferramentas pré-testadas** e otimizadas
    * 📊 **Documentação integrada** para cada ferramenta
    * 🌐 **Atualizações automáticas** sem intervenção
    * 📁 **Suporte técnico** da equipe Evo AI
    * 🔧 **Performance otimizada** para a plataforma
  </Accordion>

  <Accordion icon="check" title="Salvar configuração">
    1. **Revise suas configurações** (apenas variáveis e ferramentas selecionadas)
    2. **Teste a conexão** - a Evo AI valida automaticamente
    3. Clique em **"Save"** para aplicar as configurações
    4. O servidor estará **imediatamente disponível** para o agente

    <Info>
      A infraestrutura do servidor é gerenciada pela Evo AI. Você só configura o que precisa usar.
    </Info>
  </Accordion>
</AccordionGroup>

## Biblioteca de Servidores Evo AI

### Servidores Disponíveis

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="Busca e Pesquisa">
    **Brave Search** - Integração com o mecanismo de busca Brave. Permite buscas web gerais e locais, fornecendo informações atualizadas e relevantes.

    **Google Search** - Capacidades de busca web usando a API do Google Custom Search e funcionalidade de extração de conteúdo de páginas web.

    **Perplexity Ask** - Integração com a API Sonar para pesquisa em tempo real, fornecendo aos assistentes de IA capacidades de pesquisa web sem precedentes.

    **OpenAI WebSearch** - Acesso à funcionalidade de busca web da OpenAI, permitindo que assistentes de IA busquem na web durante conversas.

    **Tavily** - Servidor MCP que oferece busca web inteligente, extração de conteúdo e rastreamento estruturado de sites com capacidades avançadas de IA.
  </Accordion>

  <Accordion icon="code" title="Desenvolvimento e DevOps">
    **Github** - Integração completa com APIs do GitHub, permitindo automação avançada e capacidades de interação para desenvolvedores.

    **Gitlab** - Servidor MCP para a API do GitLab, habilitando gerenciamento de projetos, operações de arquivos e muito mais.

    **Calculator** - Servidor para cálculos matemáticos precisos, permitindo que LLMs realizem operações numéricas avançadas.

    **Uptime Kuma** - Servidor para gerenciar monitores do Uptime Kuma, permitindo monitoramento de disponibilidade de serviços.

    **Whois** - Permite que agentes de IA realizem consultas WHOIS e recuperem detalhes de domínios, verificando disponibilidade e propriedade.
  </Accordion>

  <Accordion icon="building" title="CRM e Produtividade">
    **Hubspot** - Integração completa com HubSpot CRM, permitindo que assistentes de IA executem ações e interajam com dados do HubSpot.

    **ClickUp** - Integração completa com ClickUp para gerenciamento de tarefas, projetos, espaços, listas e pastas através de protocolo padronizado.

    **Notion** - Servidor MCP oficial do Notion para integração completa com workspaces, páginas, bancos de dados e blocos.

    **Slack** - Integração com Workspaces do Slack, suportando múltiplos transportes sem necessidade de permissões ou bots aprovados por admins.
  </Accordion>

  <Accordion icon="globe" title="Web Scraping e Extração">
    **Firecrawl** - Implementação MCP que integra com Firecrawl para capacidades avançadas de web scraping com renderização JS e extração de conteúdo.

    **Sequential Thinking** - Ferramenta para resolução dinâmica e reflexiva de problemas através de processo de pensamento estruturado.
  </Accordion>

  <Accordion icon="chart-line" title="Dados e Analytics">
    **Yahoo Finance** - Servidor para interagir com Yahoo Finance, fornecendo acesso a preços, informações de empresas e dados financeiros.

    **Pinecone Developer** - Permite que assistentes de codificação se conectem com projetos e documentação do Pinecone para configuração de índices e busca vetorial.
  </Accordion>

  <Accordion icon="plane" title="Viagem e Hospedagem">
    **Airbnb** - Servidor para buscar listagens do Airbnb e obter detalhes de hospedagem para planejamento de viagens.

    **Travel Planner** - Implementação MCP para interagir com Google Maps e serviços de planejamento de viagem, incluindo busca de locais e cálculo de tempos.
  </Accordion>

  <Accordion icon="image" title="Mídia e Conteúdo">
    **Image Generation** - Servidor que oferece capacidades de geração de imagens usando o modelo Replicate Flux.
  </Accordion>
</AccordionGroup>

### Como Usar os Servidores

<AccordionGroup>
  <Accordion icon="rocket" title="Configuração simplificada">
    **Benefícios:**

    * 🚀 **Setup instantâneo** - Servidores prontos para uso
    * 🔧 **Configuração mínima** - Apenas suas credenciais de API
    * 📚 **Documentação integrada** - Guias dentro da plataforma
    * ✅ **Testes automáticos** - Validação de conectividade

    <Info>
      Cada servidor requer apenas as variáveis de ambiente específicas (como API\_KEY). A Evo AI cuida de toda a infraestrutura.
    </Info>
  </Accordion>

  <Accordion icon="shield" title="Confiabilidade garantida">
    **Qualidade assegurada:**

    * 🔒 **Segurança validada** - Todos os servidores são auditados
    * 🔄 **Atualizações automáticas** - Sempre na versão mais recente
    * 📊 **Monitoramento 24/7** - Disponibilidade garantida
    * 🛠️ **Suporte técnico** - Equipe especializada disponível

    <Tip>
      A biblioteca é constantemente atualizada com novos servidores e melhorias.
    </Tip>
  </Accordion>
</AccordionGroup>

## Tipos de Servidores MCP Comuns

### Servidores de Dados

<AccordionGroup>
  <Accordion icon="database" title="Bancos de dados">
    **Funcionalidades típicas:**

    * Consultas SQL em tempo real
    * Inserção e atualização de dados
    * Relatórios e análises
    * Backup e sincronização

    **Variáveis comuns:**

    * `DATABASE_URL`: URL de conexão
    * `USERNAME`: Usuário do banco
    * `PASSWORD`: Senha de acesso
    * `SCHEMA`: Schema específico
  </Accordion>

  <Accordion icon="cloud" title="APIs de terceiros">
    **Exemplos de integrações:**

    * CRM (Salesforce, HubSpot)
    * E-commerce (Shopify, WooCommerce)
    * Comunicação (Slack, Discord)
    * Produtividade (Google Workspace, Microsoft 365)

    **Configurações típicas:**

    * `API_KEY`: Chave de acesso da API
    * `BASE_URL`: URL base do serviço
    * `RATE_LIMIT`: Limite de requisições
    * `TIMEOUT`: Timeout das requisições
  </Accordion>
</AccordionGroup>

### Servidores de Ferramentas

<AccordionGroup>
  <Accordion icon="calculator" title="Processamento e cálculos">
    **Capacidades:**

    * Cálculos matemáticos complexos
    * Processamento de dados estatísticos
    * Análise financeira
    * Conversões de unidades

    **Ferramentas disponíveis:**

    * `calculate`: Operações matemáticas
    * `analyze_data`: Análise estatística
    * `convert_units`: Conversão de medidas
    * `financial_calc`: Cálculos financeiros
  </Accordion>

  <Accordion icon="file" title="Manipulação de arquivos">
    **Funcionalidades:**

    * Leitura e escrita de arquivos
    * Conversão entre formatos
    * Processamento de imagens
    * Análise de documentos

    **Ferramentas típicas:**

    * `read_file`: Ler conteúdo de arquivos
    * `write_file`: Criar/editar arquivos
    * `convert_format`: Converter formatos
    * `extract_text`: Extrair texto de documentos
  </Accordion>
</AccordionGroup>

## Casos de Uso Avançados

### Integração Multi-Servidor

<AccordionGroup>
  <Accordion icon="sitemap" title="Workflows complexos">
    **Cenários:**

    * Agente que consulta CRM + banco de dados + API de pagamento
    * Processamento de dados que envolve múltiplas fontes
    * Automação que integra diferentes sistemas empresariais

    **Configuração:**

    1. Configure múltiplos servidores MCP no mesmo agente
    2. Defina a ordem de execução das ferramentas
    3. Configure fallbacks para cenários de falha
    4. Monitore a performance do workflow completo
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **Servidor MCP não conecta:**

    * Verifique se as credenciais estão corretas
    * Confirme se o servidor está online e acessível
    * Teste conectividade de rede
    * Verifique logs de erro no dashboard

    **Ferramentas não funcionam:**

    * Confirme se as ferramentas foram selecionadas corretamente
    * Verifique permissões de acesso no servidor externo
    * Teste cada ferramenta individualmente
    * Consulte documentação específica do servidor MCP

    **Performance lenta:**

    * Verifique latência de rede para o servidor
    * Otimize parâmetros de timeout
    * Considere usar cache quando possível
    * Monitore rate limits das APIs externas

    **Erros de autenticação:**

    * Regenere API keys se necessário
    * Verifique se credenciais não expiraram
    * Confirme permissões no sistema externo
    * Teste autenticação diretamente na API
  </Accordion>
</AccordionGroup>

***

🔧 **Configuração concluída!** Seus agentes agora têm acesso a ferramentas e recursos externos através do protocolo MCP. Explore as possibilidades e crie experiências ainda mais poderosas!