Connect ChatGPT CLI to the 3CX MCP Server

Introduction

This guide explains how to connect Codex CLI to the 3CX MCP Server. After setup, Codex can query PBX information and run supported actions according to the authenticated 3CX user's permissions.

Requirements

Before starting, make sure you have:

  • A 3CX PBX that is publicly reachable.
  • Administrator access to Admin > Integrations > MCP Clients.
  • A 3CX user who can authenticate the application and use the required tools.
  • Codex CLI installed and signed in.

Copy the MCP Server URL from 3CX

Sign in to the 3CX Admin Console and open Admin > Integrations > MCP Clients > Add MCP Client. Copy the MCP Server URL shown by 3CX and use it exactly as displayed.

Connect ChatGPT CLI to 3CX

Add the MCP Server

Open PowerShell (or a terminal) in the workspace (typically a project folder) where you want to use the connection, and run the following command, replacing the example FQDN with the MCP Server URL copied from 3CX.

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

Approve 3CX Access

When the command succeeds, Codex opens the 3CX authorization page in your browser. Sign in with the intended 3CX user, review the requested access and select Allow.

Start Codex

Return to PowerShell (or your terminal) and start the client from the same folder.

codex

Test the Connection

Ask a simple question such as "Using my 3CX MCP, tell me how many extensions I have on my PBX". A successful response confirms that Codex can reach the PBX and use the tools available to the authenticated user.

Permissions and Limits

MCP requests use the permissions of the 3CX user who approved the connection. Codex can only read information or perform actions that this user can access in 3CX.

If a request is refused or returns limited information, check the user's 3CX role and rights. See 3CX MCP Tools and Permissions Reference for details.

See Also

Last Updated

This document was last updated on 25 August 2026

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