Conectar la Terminal Claude al Servidor 3CX MCP

Introducción

Esta guía explica cómo conectar Claude Code en un terminal al Servidor 3CX MCP. Una vez autorizada la conexión, Claude podrá utilizar las herramientas de 3CX MCP disponibles para el usuario de 3CX que haya aprobado la conexión.

Requisitos

  • Su PBX 3CX debe ser accesible públicamente.
  • Un usuario de 3CX con permiso para autenticarse en la aplicación y utilizar las herramientas necesarias.
  • Claude Code instalado y con sesión iniciada.
  • Una terminal abierta en la carpeta del proyecto donde se utilizará la conexión.

Copie la URL del Servidor MCP de 3CX

Cliente MCP

Inicie sesión en la Consola de Administración de 3CX y abra Admin > Integraciones > Clientes MCP > Agregar Cliente MCP. Copie la URL del servidor MCP que muestra 3CX y utilícela tal como aparece.

Conectar la Terminal de Claude

Agregar el Servidor MCP

Ejecute el siguiente comando desde la carpeta del proyecto. Reemplace el FQDN de ejemplo por la URL del servidor MCP que copió de 3CX.

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

Inicie Claude en la misma carpeta.

claude

Servidor MCP encontrado

Claude detecta el nuevo servidor MCP del proyecto y le pregunta cómo desea continuar.

Autenticar desde /mcp

Acceso al servidor MCP

  • Introduzca /mcp para abrir el administrador del servidor MCP.

Selección del servidor 3CX

  • Seleccione el servidor 3CX con las teclas de flecha y presione Enter.

Autenticación del servidor

  • Seleccione Autenticar.

Autorización desde el navegador

  • Claude abre la página de autorización en su navegador. Si no se abre automáticamente, copie la URL que aparece en la terminal y ábrala usted mismo.

Permisos requeridos

  • Inicie sesión en 3CX, revise el acceso solicitado y seleccione Permitir.

Autenticación exitosa

  • Claude confirma cuando la autenticación se realiza con éxito.

Clientes MCP

  • La conexión también aparece en Admin > Integraciones > Clientes MCP en la Consola de Administración de 3CX.

Probar la Conexión

Prueba de conexión

  • Pregunte: "¿Cuántas extensiones tiene mi PBX?". Claude muestra la herramienta 3CX que quiere usar y pide autorización.

Resultado de la prueba

  • Apruebe la solicitud para recibir el resultado.

Permisos y Límites

Claude utiliza los permisos del usuario de 3CX que aprobó la conexión. Solo puede acceder a los datos y acciones que ese usuario ya tiene permiso para utilizar en 3CX.

Si una solicitud es rechazada o devuelve datos limitados, verifique el rol y los derechos del usuario en 3CX. Consulte la Referencia de herramientas y permisos de 3CX MCP para obtener más detalles.

Ver También

Última Actualización

Este documento se actualizó por última vez el 6 de Agosto de 2026

https://www.3cx.es/docs/connect-claude-terminal/