Conecte a CLI do ChatGPT ao Servidor MCP 3CX

Introdução

Este guia explica como conectar a CLI do Codex ao Servidor 3CX MCP. Após a configuração, o Codex poderá consultar informações do PABX e executar ações compatíveis de acordo com as permissões do usuário 3CX autenticado.

Requisitos

Antes de começar, certifique-se de ter:

  • Um PABX 3CX acessível publicamente.
  • Acesso de administrador a Admin > Integrações > Clientes MCP.
  • Um usuário do 3CX capaz de se autenticar no aplicativo e utilizar as ferramentas necessárias.
  • O Codex CLI está instalado e eu já fiz login.

Copie a URL do Servidor MCP do 3CX

Adicionar Cliente MCP no 3CX

Faça login no Console de Admin 3CX e acesse Admin > Integrações > Clientes MCP > Adicionar Cliente MCP. Copie a URL do Servidor MCP exibida pelo 3CX e utilize-a exatamente como está indicada.

Conecte a CLI do ChatGPT ao 3CX

Adicionar o Servidor MCP

Abra o PowerShell (ou um terminal) na área de trabalho (geralmente uma pasta de projeto) onde você deseja usar a conexão e execute o comando a seguir, substituindo o FQDN do exemplo pela URL do Servidor MCP copiada do 3CX.

codex mcp add 3CX --url https://mypbx.3cx-example.com/mcp

Aprovar Acesso ao 3CX

Autorização de acesso do Codex no 3CX

Quando o comando for executado com sucesso, o Codex abre a página de autorização do 3CX no seu navegador. Faça login com o usuário do 3CX desejado, verifique o acesso solicitado e selecione Permitir.

Iniciar o Codex

Volte ao PowerShell (ou ao seu terminal) e inicie o cliente a partir da mesma pasta.

codex

Testar a Conexão

Faça uma pergunta simples, como “Usando meu 3CX MCP, diga-me quantos ramais tenho no meu PABX”. Uma resposta positiva confirma que o Codex consegue acessar o PABX e utilizar as ferramentas disponíveis para o usuário autenticado.

Permissões e Limites

As solicitações do MCP utilizam as permissões do usuário do 3CX que aprovou a conexão. O Codex só pode ler informações ou realizar ações às quais esse usuário tenha acesso no 3CX.

Se uma solicitação for recusada ou retornar informações limitadas, verifique a função e os direitos do usuário no 3CX. Consulte a Referência de Ferramentas e Permissões do 3CX MCP para obter mais detalhes.

Veja Também

Última Atualização

Este documento foi atualizado pela última vez em 6 de agosto de 2026

https://www.3cx.com.br/docs/connect-chatgpt-cli/