Connect Antigravity CLI to the 3CX MCP Server
Introduction
Connect Antigravity 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.
- Antigravity CLI installed and signed in, with a terminal open in the project folder.
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 it exactly as displayed, including any HTTPS port. Other users must obtain this URL from their administrator.
Connect Antigravity CLI
Add the MCP Server
In PowerShell or a terminal, run the following command, replacing the example URL with the MCP Server URL copied from 3CX:
agy mcp add --type http 3cx https://your-pbx.example/mcp
This saves the server in your user-level MCP configuration.
From the project folder, start Antigravity CLI:
agy
Enter /mcp to open the MCP manager and inspect the 3cx server. Reload its configuration if needed.
Authorize 3CX Access
- In the MCP manager, select 3cx. Use the left and right arrow keys to select Authenticate, then press Enter.
- The CLI opens the authorization page in your browser. If it does not open, use the link displayed in the terminal.
- Sign in with the intended 3CX account, review the permissions and select Allow.
The optional "Persistent client" setting keeps the client registered after its sessions expire. "Override console restrictions" allows access outside the console IP restrictions.
- On the Antigravity callback page, select Copy to Clipboard to copy the authorization code.
- Return to the terminal and paste the code at the authorization code prompt.
- When "Authentication successful!" appears, press Enter to return to the MCP panel. The server is listed as "[Authed]".
Test the Connection
- Confirm that the 3cx server is connected and its tools are available.
- Ask "Using the 3CX MCP tools, what is the PBX server time?" Approve the read-only tool request if prompted and check the returned result.
Permissions and Limits
Antigravity 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.
Existing Gemini CLI Users
Google is transitioning individual users from Gemini CLI to Antigravity CLI. Gemini CLI remains available for supported enterprise licenses and paid API-key use. For configuration changes, see Google's Gemini CLI migration guide.
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
