Conecte o Claude Terminal ao Servidor MCP 3CX

Introdução

Este guia explica como conectar o Claude Code em um terminal ao Servidor 3CX MCP. Após a autorização, o Claude poderá utilizar as ferramentas do MCP 3CX disponíveis para o usuário do 3CX que aprovou a conexão.

Requisitos

  • Seu PABX 3CX deve estar acessível ao público.
  • Um usuário do 3CX com permissão para se autenticar no aplicativo e utilizar as ferramentas necessárias.
  • O Claude Code foi instalado e o usuário fez login.
  • Foi aberto um terminal na pasta do projeto onde a conexão será utilizada.

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 aparece.

Conectar o Claude Terminal

Adicionar o Servidor MCP

Execute o comando a seguir na pasta do projeto. Substitua o FQDN de exemplo pela URL do Servidor MCP copiada do 3CX.

claude mcp add --scope project --transport http 3CX "https://yourpbx.3cx.eu/mcp"

Execute o Claude na mesma pasta.

claude

Aprovação do Servidor MCP 3CX

O Claude detecta o servidor MCP do novo projeto e pergunta como você deseja prosseguir.

Autenticar a Partir de /mcp

Alerta de autenticação MCP e comando /mcp

  • Digite /mcp para abrir o gerenciador do servidor MCP.

Gerenciador MCP com servidor 3CX

  • Selecione o servidor 3CX com as setas e pressione Enter.

Autenticação do Servidor MCP 3CX

  • Selecione Autenticar.

Autenticação 3CX via /mcp

  • O Claude abre a página de autorização no seu navegador. Caso ela não abra automaticamente, copie o URL exibido no terminal e abra-a manualmente.

Autorização de permissões MCP no 3CX

  • Faça login no 3CX, analise o acesso solicitado e selecione Permitir.

Autenticação MCP bem-sucedida no 3CX

  • O Claude confirma quando a autenticação é bem-sucedida.

Clientes MCP no Console de Admin 3CX

  • A conexão também aparece em Admin > Integrações > Clientes MCP no Console de Admin 3CX.

Teste a Conexão

Aprovação de ferramenta MCP 3CX no Claude

  • Pergunte: “Quantas linhas meu PABX tem?” Claude mostra à ferramenta 3CX qual ele deseja usar e solicita aprovação.

Teste de conexão com 3CX

  • Aprovar a solicitação para receber o resultado.

Permissões e Limites

O Claude utiliza as permissões do usuário do 3CX que aprovou a conexão. Ele só tem acesso aos dados e às ações que esse usuário já tem permissão para utilizar no 3CX.

Se uma solicitação for recusada ou retornar dados limitados, verifique a função e os direitos do usuário no 3CX. Consulte a Referência de Ferramentas e Permissões do MCP 3CX 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-claude-terminal/