Servidores MCP Personalizados

​

O que são Servidores MCP Personalizados?

Servidores MCP personalizados permitem que você estenda os recursos de integração do Manus além dos conectores pré-construídos. Se sua organização usa ferramentas internas, APIs proprietárias ou serviços especializados não cobertos por conectores MCP padrão, você pode construir um servidor personalizado que conecta o Manus a esses sistemas. Um servidor MCP personalizado atua como uma ponte entre o Manus e sua infraestrutura interna, permitindo os mesmos fluxos de trabalho multi-aplicativo contínuos que você obtém com conectores pré-construídos—mas adaptado às suas ferramentas e requisitos específicos.

​

Por Que Construir Servidores MCP Personalizados?

​

Sistemas Internos

Muitas organizações dependem de ferramentas personalizadas, bancos de dados internos ou software proprietário. Servidores MCP personalizados permitem que o Manus se integre a esses sistemas, trazendo dados internos para seus fluxos de trabalho de AI. Exemplos:

• CRM interno ou banco de dados de clientes
• Ferramentas proprietárias de gerenciamento de projetos
• Plataformas de análise personalizadas
• Sistemas legados com APIs

​

Serviços Especializados

Alguns serviços de terceiros não possuem conectores MCP pré-construídos. Se você usa uma ferramenta especializada ou serviço de nicho, você pode construir um servidor personalizado para conectá-lo ao Manus. Exemplos:

• Software específico da indústria
• Serviços regionais não cobertos por conectores padrão
• Plataformas emergentes sem integrações oficiais

​

Lógica de Negócios Personalizada

Servidores MCP personalizados podem implementar lógica específica de negócios, transformações de dados ou regras de validação que vão além de simples chamadas de API. Isso permite que você aplique políticas organizacionais e fluxos de trabalho dentro das integrações do Manus. Exemplos:

• Fluxos de trabalho de aprovação antes de atualizações de dados
• Validação de dados contra padrões internos
• Autenticação personalizada ou requisitos de segurança
• Processos de múltiplas etapas específicos para sua organização

​

Como Funcionam os Servidores MCP Personalizados

Um servidor MCP personalizado é um serviço leve que implementa a especificação do Protocolo de Contexto do Modelo. Ele expõe endpoints que o Manus pode chamar para ler dados, realizar ações ou executar lógica personalizada dentro de seus sistemas.

​

Arquitetura

Seu Sistema Interno ↔Servidor MCP Personalizado ↔Manus O servidor MCP fica entre o Manus e seus sistemas internos, traduzindo as solicitações do Manus em ações dentro de suas ferramentas e retornando resultados em um formato que o Manus entende.

​

Protocolo

Servidores MCP personalizados implementam um protocolo padronizado que define:

• Ferramentas: Ações que o Manus pode realizar (ex.: “get_customer_data”, “update_project_status”)
• Recursos: Dados que o Manus pode ler (ex.: documentos, registros, arquivos)
• Prompts: Modelos predefinidos para operações comuns

​

Construindo um Servidor MCP Personalizado

​

Pré-requisitos

• Acesso à API ao sistema que você deseja integrar
• Ambiente de desenvolvimento (Node.js, Python ou qualquer linguagem que possa executar um servidor web)
• Compreensão da especificação MCP (disponível na documentação Manus)

​

Implementação Básica

Um servidor MCP personalizado mínimo inclui:

1. Endpoint do servidor: Um serviço web que responde a solicitações do protocolo MCP
2. Definições de ferramentas: Descrições das ações que Manus pode realizar
3. Autenticação: Tratamento seguro de credenciais e chaves API
4. Manipuladores de solicitação: Lógica que executa ações e retorna resultados

​

Exemplo: Integração de CRM Interno

Aqui está um exemplo conceitual de um servidor MCP personalizado para um CRM interno: Ferramentas expostas:

• get_customer_info(customer_id): Recuperar detalhes do cliente
• update_customer_notes(customer_id, notes): Adicionar notas ao registro do cliente
• search_customers(query): Pesquisar banco de dados de clientes
• create_follow_up_task(customer_id, task_description, due_date): Criar todas as tarefas

Autenticação: Chave API ou token OAuth para seu CRM interno Implantação: Hospedado em sua infraestrutura ou em um ambiente de nuvem seguro Uma vez implantado, você conecta este servidor personalizado ao Manus, e ele aparece ao lado de conectores pré-construídos. Você pode então usar prompts de linguagem natural como:

• “Obter informações do cliente para o ID de cliente 12345”
• “Pesquisar clientes na área de São Francisco”
• “Atualizar notas para o cliente 67890 com nossa conversa recente”

​

Conectando um Servidor MCP Personalizado

​

Passo 1: Implantar Seu Servidor

Hospede seu servidor MCP personalizado em uma infraestrutura que você controla. Certifique-se de que ele esteja acessível via HTTPS e tenha medidas de segurança adequadas em vigor.

​

Passo 2: Adicionar ao Manus

No Manus, navegue atéConfigurações → Integrações → Servidores MCP Personalizados e clique emAdicionar Servidor.

​

Passo 3: Fornecer Detalhes do Servidor

Insira as seguintes informações:

• Nome do servidor: Um nome descritivo (por exemplo, “CRM Interno”, “Plataforma de Análise”)
• URL do servidor: O endpoint HTTPS onde seu servidor MCP está hospedado
• Autenticação: Chave API, token Bearer ou outras credenciais necessárias

​

Passo 4: Testar Conexão

Manus verificará se consegue se comunicar com seu servidor e recuperar a lista de ferramentas disponíveis.

​

Passo 5: Começar a Usar

Uma vez conectadas, suas ferramentas personalizadas aparecerão nas integrações disponíveis do Manus. Faça referência a elas em prompts assim como faria com conectores pré-construídos.

​

Considerações de Segurança

​

Autenticação

Servidores MCP personalizados devem implementar autenticação robusta:

• Use chaves API, tokens OAuth ou outros métodos seguros
• Nunca exponha credenciais em URLs ou logs
• Gire as credenciais regularmente

​

Autorização

Implemente verificações de autorização adequadas:

• Verifique se o usuário solicitante tem permissão para acessar os dados
• Aplique controle de acesso baseado em função (RBAC), se aplicável
• Registre todas as tentativas de acesso para fins de auditoria

​

Transmissão de Dados

• Use HTTPS para toda a comunicação
• Criptografe dados sensíveis em repouso e em trânsito
• Implemente limitação de taxa para prevenir abusos

​

Segurança de Rede

• Implante servidores MCP dentro do perímetro da sua rede segura
• Use firewalls e controles de acesso para restringir quem pode acessar o servidor
• Considere conexões VPN ou de rede privada para integrações altamente sensíveis

​

Melhores Práticas

​

Design da Ferramenta

Mantenha as ferramentas focadas: Cada ferramenta deve executar uma ação clara. Em vez de uma única ferramenta “manage_customer”, crie ferramentas separadas para “get_customer”, “update_customer”, “delete_customer”. Forneça descrições claras: Manus usa descrições de ferramentas para entender quando usar cada ferramenta. Escreva descrições claras e específicas que expliquem o que a ferramenta faz e quando é apropriada. Lide com erros de forma elegante: Retorne mensagens de erro significativas que ajudem Manus (e usuários) a entender o que deu errado e como corrigir.

​

Desempenho

Otimize os tempos de resposta: Manus aguarda as respostas do servidor MCP. Mantenha as operações rápidas armazenando dados em cache, usando consultas eficientes e evitando processamento desnecessário. Implemente tempos limite: Defina tempos limite razoáveis para chamadas API para evitar que Manus espere indefinidamente se o seu sistema interno estiver lento ou sem resposta. Use operações assíncronas para tarefas longas: Se uma operação demorar mais do que alguns segundos, considere retornar imediatamente com um ID de tarefa e fornecer uma ferramenta separada para verificar o status.

​

Monitoramento

Registre todas as solicitações: Acompanhe o que Manus está solicitando e como seu servidor responde. Isso ajuda na depuração e na compreensão dos padrões de uso. Monitore o desempenho: Acompanhe os tempos de resposta, taxas de erro e volume de uso para identificar problemas antes que afetem os usuários. Configure alertas: Seja notificado se o seu servidor MCP ficar sem resposta ou começar a retornar erros.

​

Casos de Uso de Exemplo

​

Base de Conhecimento Interna

Cenário: Sua organização tem uma wiki interna ou base de conhecimento com políticas da empresa, procedimentos e documentação. Servidor MCP Personalizado: Fornece ferramentas para buscar na base de conhecimento, recuperar artigos específicos e encontrar documentos relacionados. Workflow do Manus: “Busque em nossa base de conhecimento interna a política de reembolso de despesas e resuma os pontos principais.”

---

​

Plataforma de Análise Personalizada

Cenário: Você tem uma plataforma de análise proprietária que rastreia métricas de negócios não disponíveis em ferramentas padrão. Servidor MCP Personalizado: Expõe ferramentas para consultar métricas, gerar relatórios e recuperar dados históricos. Workflow do Manus: “Puxe nossos dados de custo de aquisição de clientes para o Q4 e crie uma análise de tendências comparando-o com o Q3.”

---

​

Integração de Sistema Legado

Cenário: Sua organização depende de um sistema legado que não possui APIs ou integrações modernas. Servidor MCP Personalizado: Atua como um wrapper em torno do sistema legado, traduzindo chamadas de API modernas para o formato que o sistema legado entende. Workflow do Manus: “Verifique os níveis de estoque no sistema legado para o SKU do produto 98765 e crie uma solicitação de reabastecimento se o estoque estiver abaixo de 100 unidades.”

---

​

Fluxos de Trabalho de Aprovação de Múltiplas Etapas

Cenário: Sua organização exige fluxos de trabalho de aprovação para certas ações (por exemplo, solicitações de orçamento, acesso a dados). Servidor MCP Personalizado: Implementa ferramentas que criam solicitações de aprovação, verificam o status de aprovação e executam ações aprovadas. Workflow do Manus: “Crie uma solicitação de orçamento de $50.000 para a campanha de marketing e notifique a equipe financeira para aprovação.”

​

Perguntas Comuns