Connect Claude Terminal to the 3CX MCP Server

Introduction

This guide explains how to connect Claude Code in a terminal to the 3CX MCP Server. After authorization, Claude can use the 3CX MCP tools available to the 3CX user who approved the connection.

Requirements

  • Your 3CX PBX must be publicly reachable.
  • A 3CX user who is allowed to authenticate the application and use the required tools.
  • Claude Code installed and signed in.
  • A terminal opened in the project folder where the connection will be used.

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 Claude Terminal

Add the MCP Server

Run the following command from the project folder. Replace the example FQDN with the MCP Server URL copied from 3CX.

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

Start Claude in the same folder.

claude

Claude detects the new project MCP server and asks how you want to continue.

Authenticate from /mcp

  • Enter /mcp to open the MCP server manager.

  • Select the 3CX server with the arrow keys and press Enter.

  • Choose Authenticate.

  • Claude opens the authorization page in your browser. If it does not open automatically, copy the URL shown in the terminal and open it yourself.

  • Sign in to 3CX, review the requested access and select Allow.

  • Claude confirms when authentication succeeds.

  • The connection also appears in Admin > Integrations > MCP Clients in the 3CX Admin Console.

Test the Connection

  • Ask "How many extensions does my PBX have?" Claude shows the 3CX tool it wants to use and asks for approval.

  • Approve the request to receive the result.

Permissions and Limits

Claude uses the permissions of the 3CX user who approved the connection. It can access only the data and actions that this user is already allowed to use in 3CX.

If a request is refused or returns limited data, 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-claude-terminal/