Conecte o ChatGPT ou o Claude ao Servidor MCP 3CX

Introdução

Este documento explica como configurar a integração entre sua IA (neste exemplo, vamos abordar o uso de um agente de chat) e seu PABX.

Isso permite que seu agente de chat consulte a maioria das informações do PABX (por exemplo: solicitar uma lista de ramais ou chamadas ativas). Essa funcionalidade pode ser uma excelente ferramenta complementar ao Console de Admin.

Requisitos de Instalação

Antes de começar, o administrador do PABX deve preparar o seguinte:

  • Seu PABX 3CX deve estar acessível publicamente na porta 443.
  • Se o seu PABX NÃO estiver funcionando na porta 443, NÃO será possível se conectar ao OpenAI (Web), ao Claude (Web) ou ao Claude (Desktop); você ficará restrito ao uso do OpenAI (Desktop), do OpenAI (Terminal) ou do Claude (Terminal).
  • Um usuário do 3CX com permissão para se autenticar no aplicativo e utilizar as ferramentas necessárias.
  • Seu cliente/agente de IA preferido; por exemplo, o ChatGPT ou o Claude.

Configurando o ChatGPT

  • Acesse sua conta do OpenAI ChatGPT e faça login.

Acesso às Configurações do ChatGPT

  • Na página do ChatGPT, clique no seu perfil, na parte inferior da barra lateral, e clique na opção Configurações

Ativação do Modo de Desenvolvedor no ChatGPT

  • Ative o Modo de Desenvolvedor
  • Se a opção estiver oculta ou não puder ser ativada, é possível que você faça parte de um espaço de trabalho corporativo. Entre em contato com seu administrador para ativar as permissões para a criação de conectores MCP personalizados.

Adicionar Cliente MCP no 3CX

Adicionar plug-in no ChatGPT

  • Clique no ícone +.

Novo plugin MCP do 3CX no ChatGPT

  • Forneça os seguintes detalhes:
  • Ícone
  • Nome
  • Descrição
  • URL de Conexão

Configuração de MCP personalizado no ChatGPT

  • Se você estiver usando o ChatGPT Desktop, o local correto para inserir a URL é na aba “Streamable HTTP”.

Novo Plugin 3CX MCP no ChatGPT

  • Forneça as credenciais e autorizações corretas para a configuração
  • Autenticação (O tipo de autenticação deve ser OAuth).
  • Marque a caixa de seleção “Entendi e desejo continuar”.
  • Clique no botão Criar para continuar.

Autorização do conector 3CX MCP no ChatGPT

  • Será solicitado que você faça login no portal 3CX quando for solicitado a autorizar a integração.

Permissões solicitadas pelo ChatGPT no 3CX

  • Confirme as configurações e opções adicionais da ferramenta e do ambiente de execução apresentadas pelo cliente de IA.

Teste de consulta ao PABX via ChatGPT

  • Inicie uma nova conversa e teste a funcionalidade com uma consulta como: “Quantos ramais meu PABX possui?”.

Configurando o Claude

  • Acesse sua conta do Claude e faça login.

Adicionar conector personalizado no Claude

  • Acesse Personalizar -> Conectores e clique na opção de menu Adicionar -> Adicionar conector personalizado.

Adicionar Cliente MCP no 3CX

  • Recupere a URL do MCP do seu PABX em Admin > Integrações > Clientes MCP > Adicionar cliente MCP no Console de Admin 3CX.

Adicionar conector MCP 3CX no Claude

  • Dê um nome ao seu conector e insira a URL do endpoint do Servidor MCP 3CX; clique no botão Adicionar

Autorização de permissões do MCP 3CX para Claude

  • Confirme as configurações e opções adicionais da ferramenta e do ambiente de execução apresentadas pelo cliente de IA.

Teste de consulta no Claude

  • Inicie uma nova conversa e teste a funcionalidade com uma consulta como: “Quantas ramais meu PABX possui?”.

Permissões e Limites

As operações de IA realizadas por meio do MCP utilizam as credenciais da sua conta 3CX, o que significa que elas herdam sua função e suas permissões atuais. Elas só podem realizar ações ou acessar informações para as quais você já está autorizado a lidar diretamente no 3CX.

Isso significa que tentar acessar e utilizar funcionalidades às quais você não tem acesso resultará em erros, e esse é o comportamento esperado. Veja Ferramentas e Níveis de Permissão do MCP 3CX para obter mais informações sobre permissões.

Habilitar a Adição de Plugins em Toda a Organização

Também é possível disponibilizar seu conector para uso em toda a sua organização da mesma forma descrita acima, por meio das seções relacionadas ao espaço de trabalho na interface do usuário do seu provedor de IA.

Para gerenciar implantações organizacionais, direitos de publicação e restrições de nível administrativo, consulte a documentação oficial fornecida pelos provedores da plataforma:

Veja Também

Última Atualização
Este documento foi atualizado pela última vez em 4 de agosto de 2026
https://www.3cx.com.br/docs/connect-chatgpt-claude-mcp-server/