Herramientas y Niveles de Permiso de 3CX MCP

Introducción

A continuación se ofrece una explicación de las funciones de IA compatibles con el servidor 3CX MCP y los niveles de permiso correspondientes. Esto le permitirá administrar los permisos de los clientes IA, las conexiones al MCP y las funciones específicas del PBX a las que tiene acceso la IA.

Configuración de Aprobación de la Herramienta de Cliente IA

Estas configuraciones definen cómo el cliente IA accede a las herramientas individuales y actúan como primer filtro antes de que cualquier solicitud llegue al PBX.

  • Siempre permitir: El cliente ejecuta la herramienta de inmediato sin necesidad de intervención.
  • Requiere aprobación: El cliente solicita la confirmación del usuario antes de ejecutar cada solicitud.
  • Denegar: El cliente impide por completo que la herramienta se ejecute.

Configuración de la Herramienta de Cliente IA

Estas configuraciones del lado del cliente no otorgan derechos adicionales en 3CX, sino que determinan cómo (y si) se envía una solicitud a 3CX. El Servidor MCP de 3CX sigue evaluando cada solicitud como si fuera el usuario autenticado de 3CX.

Integración de Permisos de 3CX

Las capacidades de la IA se limitan estrictamente a los permisos del usuario de 3CX que autorizó la conexión. El Servidor MCP asocia la solicitud de la IA a esta cuenta específica, heredando todos los controles de acceso basados en roles y las capacidades asociadas.

  • Las restricciones a nivel de cuenta, como el acceso por departamento, la administración de colas o la configuración de DID, se respetan en todo momento.
  • Si un usuario específico de 3CX no tiene permisos para modificar datos, la IA no podrá realizar esas acciones, independientemente de la configuración del lado del cliente.
  • La herramienta de Consulta está estrictamente limitada a operaciones de solo lectura para garantizar la integridad de la base de datos.

Roles de Usuario y Acceso a las Herramientas

La siguiente lista muestra las herramientas disponibles a través del Servidor 3CX MCP. Lo que un usuario puede ver o hacer con ellas depende de los permisos de la cuenta de 3CX utilizada para la conexión.

Herramientas de Solo Lectura

Estas herramientas permiten que la IA acceda a la información del PBX. No modifican la configuración del PBX ni afectan las llamadas.

Usuario, contactos y directorio

  • Buscar por correo electrónico - Busca un contacto por su dirección de correo electrónico.
  • Buscar extensión - Busca un contacto por su número de extensión exacto.
  • Mostrar contactos del CRM - Busca contactos desde un CRM integrado.
  • Mostrar agenda telefónica - Busca en las agendas telefónicas disponibles de 3CX.
  • Mostrar usuarios - Muestra la lista de usuarios y extensiones del PBX.

Llamadas, grabaciones y buzón de voz

  • Mostrar llamadas activas - Muestra las llamadas que están activas en este momento.
  • Mostrar grabaciones - Muestra la lista de grabaciones disponibles para el usuario autenticado.
  • Mostrar buzones de voz - Muestra los buzones de voz disponibles para el usuario autenticado.

Colas, departamentos y perfiles

  • Mostrar los miembros del departamento - Muestra los miembros de un departamento.
  • Mostrar departamentos - Muestra los departamentos a los que tiene acceso el usuario autenticado.
  • Mostrar perfiles - Muestra los perfiles de reenvío o de presencia disponibles para el usuario actual.
  • Mostrar agentes de la cola - Muestra a los agentes que están en la cola.
  • Mostrar colas - Muestra las colas a las que el usuario actual tiene acceso o que puede administrar.

Sistema y diagnóstico

  • Obtener la hora del servidor - Muestra la hora actual del servidor PBX.
  • Mostrar registro de eventos - Busca o muestra información estructurada sobre eventos del PBX.
  • Mostrar servicios - Enumera los servicios del PBX y su estado actual.
  • Buscar registros - Busca en los registros de la aplicación utilizando los filtros disponibles.

Inventario y base de datos del PBX

  • Describir tabla - Devuelve el esquema de una tabla de base de datos accesible.
  • Mostrar DIDs - Enumera los DIDs disponibles en el PBX.
  • Mostrar lista de IPs bloqueadas - Muestra las entradas de la lista de IPs bloqueadas.
  • Mostrar pares - Muestra la lista de pares del PBX configurados.
  • Mostrar números bloqueados - Muestra las entradas de los números telefónicos bloqueados.
  • Mostrar tablas - Muestra las tablas de la base de datos a las que tiene acceso el usuario actual.
  • Mostrar troncales - Muestra la lista de troncales SIP configurados.
  • Consulta - Ejecuta una consulta SQL SELECT de solo lectura sobre los datos accesibles.

Herramientas de flujo de llamadas

  • Obtener la aplicación de flujo de llamadas - Recupera detalles de una aplicación de flujo de llamadas.
  • Obtener los archivos de la aplicación de flujo de llamadas - Recupera los archivos asociados a una aplicación de flujo de llamadas.
  • Obtener URL de edición - Devuelve una URL de edición para un objeto PBX compatible.
  • Mostrar las aplicaciones de flujo de llamadas - Enumera las aplicaciones de flujo de llamadas disponibles en el PBX.

Herramientas de Escritura o Eliminación

Las herramientas de escritura o eliminación pueden modificar el estado de las llamadas, el estado del usuario, los datos de enrutamiento, las listas de bloqueo o el flujo de llamadas. Se recomienda encarecidamente mantener estas herramientas configuradas en Requiere aprobación (‘Needs approval’) o Bloqueado (‘Blocked’), a menos que se haya revisado el flujo de trabajo y se le haya autorizado al usuario autenticado a realizar la acción.

Acciones de llamada, cola y perfil

  • Cortar llamada - Finalizar una llamada activa seleccionada.
  • Seleccionar perfil - Activa un perfil de reenvío o de presencia.
  • Establecer mensaje de perfil - Establece o elimina el mensaje del perfil activo.
  • Establecer sustitución de perfil - Aplica una sustitución temporal del perfil.
  • Establecer estado del agente en la cola - Registra la entrada o salida de un agente de la fila cuando el usuario cuente con los derechos necesarios.
  • Establecer el estado de la cola - Registra el inicio o el fin de la sesión del usuario actual en las colas.

Acciones de configuración del PBX

  • Agregar una entrada a la lista negra de IPs - Agrega una dirección IP a la lista de direcciones IP bloqueadas del PBX.
  • Agregar un número a la lista negra - Agrega un número a la lista negra.
  • Asignar DID - Asigna un DID utilizando los permisos de los que dispone el usuario autenticado.
  • Eliminar una entrada de la lista de direcciones IP bloqueadas - Elimina una dirección IP de la lista de direcciones IPs bloqueadas del PBX.
  • Eliminar un número de la lista negra - Elimina un número de la lista negra.
  • Actualizar el script de la aplicación de flujo de llamadas - Actualiza el script que utiliza una aplicación de flujo de llamadas.

Ver También

Última Actualización

Este documento se actualizó por última vez el 28 de Julio de 2026
https://www.3cx.es/docs/mcp-tools-permissions/