Skip to content

Servidores MCP ​

Introdução ​

O que é o servidor MCP?

MCP é a sigla para Model Context Protocol (Protocolo de Contexto do Modelo). Pense nele como uma ponte inteligente e segura que conecta o cérebro do Opa! IA ao universo de informações e ferramentas externas. Ele atua como um intermediário que busca, organiza e entrega o contexto necessário para que a inteligência artificial possa entender suas solicitações e agir de maneira assertiva.

Qual a função de um Servidor MCP? ​

A principal função do Servidor MCP é atuar como uma ponte universal. Ele conecta o Opa!IA a uma vasta gama de recursos externos, permitindo que a inteligência artificial:

  • Acesse APIs e bancos de dados: Permite buscar informações em tempo real, como cotações de preços, a previsão do tempo ou as últimas notícias.

  • Integre-se a sistemas externos: Conecta-se diretamente a aplicativos e plataformas que você já usa, desde sistemas de ERP a plataformas de e-commerce.

  • Utilize ferramentas de trabalho: Interage com planilhas, sistemas de CRM e outros softwares internos da sua empresa para consultar ou inserir dados.

  • Execute ações: Vai além do diálogo, realizando tarefas específicas como abrir um chamado, atualizar um cadastro ou enviar uma notificação.

Por que utilizar o Servidor MCP na sua empresa? ​

Integrar um Servidor MCP à sua operação com o Opa! IA significa transformar a inteligência artificial em um membro ativo e funcional da sua equipe. Em vez de ser apenas uma fonte de consulta, a IA passa a executar tarefas, trazendo ganhos diretos de produtividade e inteligência para o seu negócio.

Aqui estão os principais motivos para adotar essa tecnologia na sua operação:

Benefício principalDescriçãoComo funciona na prática (exemplo)
Automação inteligente de processosVá além dos chatbots que apenas respondem perguntas. Com o MCP e o Opa! IA execute fluxos de trabalho completos.Em vez de um funcionário precisar consultar o estoque, acessar o CRM e redigir um e-mail com orçamento, o Opa!IA pode ser instruído a fazer tudo isso em uma única consulta, automatizando o processo.
Decisões mais rápidas e baseadas em dadosSua equipe não precisará mais navegar por múltiplas telas ou esperar por relatórios. As informações do seu negócio estarão disponíveis através de uma simples conversa.Você pode perguntar: "Qual foi nosso produto mais vendido na última semana em São Paulo?" e obter uma resposta precisa e imediata, extraída diretamente dos seus sistemas de vendas.
Redução de erros e aumento da eficiênciaAo automatizar tarefas manuais e repetitivas (copiar/colar informações, preencher planilhas, atualizar cadastros), você minimiza drasticamente a chance de erros humanos.Isso libera sua equipe para focar em atividades estratégicas que exigem criatividade e julgamento humano (negociar, planejar campanhas), em vez de gastar tempo em processos operacionais.
Proatividade no atendimento e vendasO sistema pode ser configurado para não apenas reagir, mas também para agir de forma proativa com base em gatilhos e dados.O Opa! IA pode identificar automaticamente um cliente inativo há mais de 90 dias, consultar seu histórico e sugerir proativamente ao vendedor uma oferta personalizada para reativá-lo.

Configurando MCP ​

Acesso ao formulário ​

Acesso ao formulário

Caminho: Menu (Opa! IA -> Servidores MCP -> Conectar novo servidor MCP)

Servidor MCP integrado ao IXC Provedor ​

Se a integração com o IXC Provedor já estiver ativa e configurada, o sistema preencherá automaticamente os dados necessários para a criação do servidor MCP.


1. Exemplo de URL ​

Caso já exista uma integração configurada, o endereço será exibido automaticamente no seguinte formato:

https://dominioixc.com.br/services/mcp


2. Criação dos Tokens de Autenticação ​

Para gerar o token de conexão do MCP, siga as etapas abaixo:

  1. Acesse o IXC Provedor.

  2. Vá até Configurações > Integrações > OAuth Server.

  3. Adicione um novo item e preencha o campo Descrição com um nome de fácil identificação.

  4. No campo Redirect URL, cole o link abaixo e salve:

https://dominioixc.com.br/services/ai-environment/mcp-servers/ixc-provedor/oauth2/callback

Após salvar, copie os dados fornecidos pelo IXC Provedor e insira-os no sistema:

  • Client ID

  • Client Secret


3. Permitir Conexão do Sistema ​

Antes de finalizar, verifique se o seu usuário possui permissão de acesso à API:

  1. Acesse o IXC Provedor.

  2. Vá até Configurações > Usuários.

  3. Edite o usuário desejado, marque a opção Permite acesso à API e salve.

Agora, clique no botão abaixo para conceder a permissão de acesso:

Ao finalizar e conferir os dados, clique em Adicionar servidor. Após isso, você poderá utilizar os recursos do MCP no seu assistente inteligente.


Adicionando um MCP personalizado ​

  1. Na tela de Servidores MCP, clique em Adicionar novo.

  2. Em Tipo de MCP, selecione Personalizado.

  3. Na seção Dados de integração, preencha:

    • Nome: insira um nome para identificar a conexão (ex.: Webhook).

    • URL: insira o endpoint do sistema externo (ex.: http://192.168.0.11:3000/webhook).

    • Headers (opcional): se a integração exigir cabeçalhos específicos, insira-os em formato JSON.

  4. Defina o método de autenticação:

    • Sem autenticação → caso não seja necessário usuário/senha/token.

    • Basic → exige Username e Password.

    • Bearer Token → exige apenas um token de autenticação.

  5. Selecione a opção desejada e preencha os campos solicitados e clique em Adicionar servidor para salvar.

Após criar o servidor, será exibida a tela de configuração. Utilize a opção Testar conexão para validar o acesso.

Se for necessário, você poderá editar o servidor MCP a qualquer momento.


Exemplos e Casos de Uso ​

Caso 1: Automação para Provedores de Internet (IXC Provedor) ​

  • Cenário: Cliente da VelozNet reclama no WhatsApp de “sem internet”.

  • Sem integração: Atendente precisa consultar manualmente no IXC Provedor, processo demorado.

  • Com MCP:

    • O assistente pede o CPF.

    • Consulta automaticamente no IXC Provedor.

    • Retorna status da conexão (ATIVO, BLOQUEADO, SEM CONEXÃO.).

  • Resultado: Resposta instantânea, disponível 24/7, liberando a equipe para casos mais complexos.


Caso 2: Geração Automática de Leads (CRM) ​

  • Cenário: Visitante demonstra interesse em imóvel no site da Imobiliária Morar Bem.

  • Sem integração: Vendedor cadastra manualmente no CRM, sujeito a atrasos e erros.

  • Com MCP: O assistente coleta os dados e cria o lead direto no CRM.

  • Resultado: Cadastro imediato, sem falhas, garantindo agilidade no atendimento comercial.


Utilizando os servidores MCP nos assistentes inteligentes ​

Vinculando servidores MCP ao assistente ​

Ao configurar um assistente inteligente, é possível vincular um ou mais servidores MCP diretamente na tela de configuração. O campo Servidores MCP permite selecionar, de forma múltipla, todos os servidores previamente cadastrados na plataforma.

Campo Servidores MCP

Os servidores exibidos nesse campo são os mesmos cadastrados em Opa! IA > Servidores MCP. Certifique-se de que o servidor desejado esteja devidamente configurado antes de vinculá-lo ao assistente.

Ao vincular um servidor MCP, o assistente passa a ter acesso a todas as rotas disponibilizadas por aquele servidor e poderá utilizá-las dinamicamente durante as conversas, sem a necessidade de configurar cada ferramenta manualmente.

Dica

Vincule MCPs para expandir as capacidades do assistente. Cada servidor conecta o assistente a ferramentas e serviços externos, permitindo que ele consulte dados e execute ações automaticamente durante as conversas.

Utilizando ferramentas do MCP manualmente ​

Além da vinculação dinâmica via campo Servidores MCP, ainda é possível selecionar ferramentas específicas do MCP de forma manual nos comandos da plataforma, conforme o fluxo já existente. Ao editar um assistente e adicionar uma requisição ao fluxo, você pode:

  • Selecionar a ferramenta: Escolha um dos MCPs cadastrados (ex.: "CRM de Vendas" ou "IXC Provedor").
  • Mapear Variáveis de Envio: Defina quais informações da conversa serão enviadas para a API.
  • Mapear Variáveis de Resposta: Salve a resposta da API em novas variáveis para que o assistente possa utilizá-las nos próximos passos do fluxo.

Considerações Finais ​

Os Servidores MCP são o motor que transforma seu assistente! Ao conectar o Opa! IA aos seus sistemas centrais, você desbloqueia o verdadeiro potencial da automação inteligente, otimiza processos, reduz custos operacionais e libera sua equipe para focar no que realmente importa: o crescimento do seu negócio.

Leia também ​