Central de Ajuda

Português

Español

Português

Español

Appearance

Conectar servidores MCP ​

Acesso

Caminho: Menu lateral → Opa! IA → Servidores MCP → Adicionar novo

Visão geral ​

MCP (Model Context Protocol) é uma forma padronizada de ligar a inteligência artificial a sistemas externos. Com um servidor MCP conectado, o assistente inteligente consulta dados e executa ações nesses sistemas durante a conversa, por exemplo verificar a situação do contrato do cliente no IXC Provedor ou criar um cadastro em um CRM. Assim, o assistente resolve o pedido sem que um atendente precise abrir o outro sistema.

Há três tipos de servidor MCP:

TipoPara que serve
IXC ProvedorConecta o assistente ao seu IXC Provedor. Veja o passo a passo abaixo.
IXC ACSConecta o assistente ao IXC ACS, para consultar e agir nos equipamentos dos clientes. Veja [[servidor mcp com o acs
PersonalizadoQualquer servidor MCP, informando URL e autenticação.

Pré-requisitos ​

  • Opa! IA contratado e permissão Ambiente de IA no grupo de permissões. Veja Criar e configurar um grupo de permissão.
  • Para o IXC Provedor: acesso de administrador ao IXC Provedor e um usuário com permissão de acesso à API.
  • Para o Personalizado: o endereço (URL) do servidor MCP e os dados de autenticação, se houver.

Passo a passo ​

Conectar o IXC Provedor ​

  1. Acesse Opa! IA → Servidores MCP e clique em Adicionar novo.
  2. Em Tipo de MCP, escolha IXC Provedor.
  3. Em URL, informe o endereço do MCP do seu IXC Provedor, no formato https://[endereço do seu IXC Provedor]/services/mcp.
  4. Em Crie os tokens de autenticação, siga os passos no IXC Provedor:
    1. Acesse Configurações → Integrações → OAuth Server e adicione um novo item. Em Descrição, use um nome fácil de identificar.
    2. Em Redirect URL, cole o endereço de retorno que o Opa! Suite mostra na tela. Use o botão de copiar. Ele tem o formato https://[endereço do seu Opa! Suite]/services/ai-environment/mcp-servers/ixc-provedor/oauth2/callback.
    3. Salve e copie o Client ID e o Client Secret gerados.
  5. Em Vincule os tokens ao servidor MCP, cole o Client ID e o Client Secret.
  6. Em Permita a conexão do sistema, confirme antes se o seu usuário no IXC Provedor tem a opção Permite acesso à API (em Configurações → Usuários). Depois, clique em Conceder acesso e autorize na janela que abre.
  7. Quando o status mudar de Pendente para Permissão concedida, clique em Adicionar servidor.

Conectar um servidor MCP personalizado ​

  1. Em Opa! IA → Servidores MCP, clique em Adicionar novo.
  2. Em Tipo de MCP, escolha Personalizado.
  3. Em Dados de integração, preencha:
    • Nome: um nome para identificar a conexão.
    • URL: o endereço do servidor MCP.
    • Headers (opcional): cabeçalhos exigidos pela integração, em formato JSON.
  4. Em Autenticação, escolha o Método de autenticação:
    • Sem autenticação: quando o servidor não exige credenciais.
    • Basic: informe Username e Password.
    • Bearer token: informe o token.
  5. Clique em Adicionar servidor.

Testar a conexão ​

  1. Abra o servidor na lista de Servidores MCP.
  2. Clique em Testar conexão. A janela Resultado do teste de conexão mostra o resultado.
  3. Se a conexão funcionar, aparece Conexão estabelecida com sucesso! com o número de ferramentas encontradas. Se a conexão funcionar mas o servidor não tiver ferramentas, aparece Conexão estabelecida, mas nenhuma ferramenta foi encontrada. Se falhar, aparece Erro de conexão. Verifique se o servidor MCP está acessível.

Nas seções Dados de integração e Autenticação da tela do servidor, você pode editar as informações a qualquer momento.

Vincular o servidor a um assistente ​

  1. Abra o assistente em Opa! IA → Assistentes inteligentes, aba Perfil.
  2. Em Servidores MCP, selecione os servidores. A lista mostra os servidores cadastrados aqui.
  3. Clique em Publicar alterações.

Com o servidor vinculado, o assistente passa a poder usar as ferramentas que ele oferece. Você também pode inserir uma ferramenta do MCP numa etapa específica das instruções ou do fluxo, digitando /. Veja Montar o fluxo de interações do assistente.

Resultado esperado ​

O servidor aparece na lista de Servidores MCP, com Nome, Origem (Nativo do sistema ou Adicionado pelo usuário) e Estado. O assistente vinculado passa a consultar e executar ações no sistema externo durante as conversas.

Problemas comuns ​

  • O botão Conceder acesso está desabilitado: preencha URL, Client ID e Client Secret antes.
  • A janela de autorização mostra erro: confira se o Redirect URL cadastrado no IXC Provedor é exatamente o endereço mostrado pelo Opa! Suite e se o seu usuário tem Permite acesso à API.
  • Aparece "Erro de conexão": confira a URL, a autenticação e se o servidor está acessível pela internet.
  • O servidor não aparece no assistente: ele precisa estar cadastrado em Opa! IA → Servidores MCP. Atualize a tela do assistente.

Boas práticas ​

  • Use um usuário próprio no IXC Provedor para a integração, com só as permissões necessárias.
  • Vincule ao assistente só os servidores de que ele precisa.
  • Descreva nas instruções quando o assistente deve usar o sistema externo.
  • Teste o assistente na Pré-visualização antes de publicar.

Conteúdos relacionados ​