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.

3CX MCP settings

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

Last Updated

This document was last updated on 11 November 2026

https://www.3cx.com/docs/github-copilot-mcp-server/