Connect GitHub Copilot CLI to the 3CX MCP Server
Introduction
Connect GitHub Copilot CLI to the 3CX MCP Server to query PBX information and use the tools available to your 3CX account.
Requirements
- A publicly reachable 3CX PBX.
- The MCP Server URL supplied by your System Owner or administrator.
- A 3CX user who can authorize the connection and use the required tools.
- GitHub Copilot CLI installed and signed in with an account that has access to Copilot.
By default, only the System Owner can approve a new OAuth application. To allow other users to approve new apps, the System Owner can enable "All Users Can Approve New Apps" in Admin > Integrations > MCP Clients > Settings.
Copy the MCP Server URL From 3CX
As the System Owner, open Admin > Integrations > MCP Clients > Add MCP Client and copy the MCP Server URL. Use this URL exactly as displayed, including any HTTPS port. Other users must obtain this URL from their administrator.
Connect GitHub Copilot CLI
Add the MCP Server
Start an interactive Copilot CLI session:
copilot
- Enter /mcp add to open the server configuration form. Use Tab to move between fields.
- In Name, enter 3CX.
- In Type, select HTTP.
- In URL, paste the MCP Server URL copied from 3CX.
- Leave HTTP Headers empty. Authorization is completed in the browser after saving.
- In Tools, enter * to include all tools available to your 3CX account. To include only specific tools, enter their names separated by commas.
- Press Ctrl+S to save the server.
HTTP selects the Streamable HTTP transport; an https:// MCP Server URL uses an encrypted HTTPS connection.
Authorize 3CX Access
- After saving, Copilot displays "OAuth authentication is required for 3CX". Press Enter to authenticate. To authorize again later, enter /mcp auth 3CX.
- In the browser, sign in with the intended 3CX user if prompted. Review the requested permissions and click Allow. Return to Copilot CLI; when "Authentication Successful" appears, press Enter to continue.
Copilot reconnects the server after authorization. GitHub sign-in and 3CX authorization are separate steps.
Verify the Connection
- Enter /mcp, select 3CX, press Enter and choose Details. Confirm that the server is enabled and its tools are listed. You can also use /mcp show 3CX to display the server details.
Permissions and Limits
GitHub Copilot CLI uses the rights of the 3CX account that authorized the connection. Available tools also depend on the client's tool settings. See 3CX MCP Tools and Permission Levels for details.
If your organization manages the CLI client, its MCP policy must allow the 3CX server.
See Also
- 3CX MCP Tools and Permission Levels
- Connect ChatGPT Codex CLI to 3CX MCP Server
- Connect Claude Terminal to 3CX MCP Server
Last Updated
This document was last updated on 11 November 2026
