Ferramentas e Níveis de Permissão do MCP 3CX

Introdução

A seguir, apresentamos uma explicação sobre as funções de IA suportadas pelo Servidor 3CX MCP e os níveis de permissão relacionados. Isso permitirá que você gerencie as permissões dos clientes de IA, as conexões com o MCP e os recursos específicos do PABX acessíveis à IA.

Configurações de Aprovação da Ferramenta de Cliente de IA

Essas configurações definem como o cliente de IA acessa ferramentas específicas, atuando como o primeiro filtro antes que qualquer solicitação chegue ao PABX.

  • Sempre permitir: O cliente executa a ferramenta imediatamente, sem intervenção.
  • Requer aprovação: O cliente solicita a confirmação do usuário antes de executar cada solicitação.
  • Negar: O cliente impede totalmente a execução da ferramenta.

Aprovação de ferramenta MCP do 3CX no Claude

Essas configurações do lado do cliente não concedem direitos adicionais no 3CX, mas determinam como (e se) uma solicitação é enviada ao 3CX. O Servidor 3CX MCP continua avaliando cada solicitação como se fosse o próprio usuário autenticado no 3CX.

Integração de Permissões do 3CX

As capacidades da IA estão estritamente limitadas às permissões do usuário do 3CX que autorizou a conexão. O Servidor MCP mapeia a solicitação da IA para essa conta específica, herdando todos os controles de acesso baseados em funções e todas as capacidades associadas.

  • As restrições no nível da conta, como acesso por departamento, gerenciamento de filas ou configurações de DID, são respeitadas em todos os momentos.
  • Se um usuário específico do 3CX não tiver permissão para modificar dados, a IA não poderá realizar essas ações, independentemente da configuração do lado do cliente.
  • A ferramenta de Consulta está estritamente limitada a operações somente de leitura para garantir a integridade do banco de dados.

Funções dos Usuários e Acesso às Ferramentas

A lista a seguir mostra as ferramentas disponíveis no Servidor 3CX MCP. O que um usuário pode ver ou fazer com elas depende das permissões da conta 3CX utilizada para a conexão.

Ferramentas Somente para Leitura

Essas ferramentas permitem que a IA visualize informações do PABX. Elas não alteram as configurações do PABX nem afetam as chamadas.

Usuário, Contatos e Lista Telefônica

  • Pesquisar por e-mail - Encontre um contato pelo endereço de e-mail.
  • Pesquisar ramal - Encontre um contato pelo número exato do ramal.
  • Listar contatos do CRM – Pesquisar contatos em um CRM integrado.
  • Listar lista telefônica - Pesquisar nas listas telefônicas disponíveis do 3CX.
  • Listar usuários - Listar usuários e ramais do PABX.

Chamadas, Gravações e Correio de Voz

  • Listar chamadas ativas - Mostrar as chamadas que estão ativas no momento.
  • Listar gravações - Exibir a lista de gravações disponíveis para o usuário autenticado.
  • Listar mensagens de voz — Exibe os itens de mensagens de voz disponíveis para o usuário autenticado.

Filas, Departamentos e Perfis

  • Lista de membros do departamento - Mostrar os membros de um departamento.
  • Lista de departamentos - Exibir os departamentos aos quais o usuário autenticado tem acesso.
  • Lista de perfis - Exibe os perfis de encaminhamento ou de presença disponíveis para o usuário atual.
  • Lista de agentes da fila - Exibir os agentes de uma fila.
  • Lista de filas - Exibe as filas às quais o usuário atual tem acesso ou pode gerenciar.

Sistema e Diagnósticos

  • Obter hora do servidor - Exibe a hora atual do servidor PABX.
  • Lista de registro de eventos - Pesquisar ou listar informações estruturadas sobre eventos do PABX.
  • Lista de serviços - Listar os serviços de PABX e seu status atual.
  • Pesquisar registros - Pesquise os registros do aplicativo usando os filtros disponíveis.

Inventário e Banco de Dados do PABX

  • Descrever tabela - Retorna o esquema de uma tabela de banco de dados acessível.
  • Lista de DIDs - Exibe a lista dos DIDs disponíveis no PABX.
  • Lista de bloqueios de IP - Lista as entradas na lista de bloqueios de IP.
  • Lista de pares - Listar os pares do PABX configurados.
  • Lista de números bloqueados do telefone - Lista de entradas na lista de números bloqueados do telefone.
  • Lista de tabelas - Exibe as tabelas do banco de dados acessíveis ao usuário atual.
  • Lista de troncos - Listar os troncos SIP configurados.
  • Consulta - Executar uma consulta SQL SELECT somente leitura nos dados acessíveis.

Ferramentas de Fluxo de Chamadas

  • Obter aplicativo de fluxo de chamadas - Recuperar detalhes de um aplicativo de fluxo de chamadas.
  • Obter arquivos do aplicativo de fluxo de chamadas - Recuperar os arquivos associados a um aplicativo de fluxo de chamadas.
  • Obter URL de edição - Retorna uma URL de edição para um objeto PABX compatível.
  • Listar aplicativos de fluxo de chamadas - Lista os aplicativos de fluxo de chamadas disponíveis no PABX.

Ferramentas de Gravação ou Exclusão

As ferramentas de gravação ou exclusão podem alterar o estado da chamada, o status do usuário, os dados de encaminhamento, as listas de bloqueio ou o fluxo da chamada. É altamente recomendável manter essas ferramentas configuradas como Necessita de aprovação ou Bloqueado, a menos que o fluxo de trabalho tenha sido revisado e o usuário autenticado tenha permissão para realizar a ação.

Ações Relacionadas a Chamadas, Filas e Perfis

  • Encerrar chamada - Encerrar uma chamada ativa selecionada.
  • Selecionar perfil - Ativar um perfil de encaminhamento ou de presença.
  • Definir mensagem do perfil - Definir ou remover a mensagem do perfil ativo.
  • Definir substituição de perfil - Aplicar uma substituição temporária de perfil.
  • Definir status do agente de fila - Registrar a entrada ou saída de um agente de fila quando o usuário tiver os direitos necessários.
  • Definir status da fila - Registrar o usuário atual como inserido ou retirado das filas.

Ações de Configuração do PABX

  • Adicionar entrada à lista de bloqueio de IPs - Adicionar um endereço IP à lista de bloqueio de IPs do PABX.
  • Adicionar número à lista de bloqueio - Adicionar um número à lista de bloqueio.
  • Atribuir DID - Atribuir um DID utilizando as permissões disponíveis para o usuário autenticado.
  • Remover entrada da lista de bloqueio de IPs - Remover um endereço IP da lista de bloqueio de IPs do PABX.
  • Remover número da lista de bloqueio - Remover um número da lista de bloqueio.
  • Atualizar o script do aplicativo de fluxo de chamadas - Atualiza o script utilizado por um aplicativo de fluxo de chamadas.

Veja Também

Última Atualização
Este documento foi atualizado pela última vez em 28 de julho de 2026
https://www.3cx.com.br/docs/mcp-tools-permissions/