Connect Claude Code

Connect Claude Code to your WHMCS through Relyagent's self-hosted MCP server, so Claude Code can list and call only the WHMCS tools you allow.

Prerequisites

• A connection created under Addons → Relyagent → MCP Clients — see Configuration.

• Its Client ID and Client Secret (the secret is shown only once at creation).

• The shared Endpoint URL:

  https://<your-whmcs>/modules/addons/relyagent/public/mcp/endpoint.php

Grab the exact values from WHMCS

The Setup tab (Addons → Relyagent → Setup) has a Claude Code accordion with the Endpoint URL pre-filled and copy-paste steps.

Add Relyagent as an MCP connector

1. In Claude Code, add the server (the Endpoint URL is the same for every connection):

   claude mcp add --transport http relyagent \
     https://<your-whmcs>/modules/addons/relyagent/public/mcp/endpoint.php

2. Supply the connection's Client ID and Client Secret via the OAuth flags — run claude mcp add --help for the exact option names in your Claude Code version, or use claude mcp add-json with an oauth block.

3. Inside Claude Code, run /mcp → Authenticate to start sign-in.

Authorize and consent

Claude Code auto-discovers Relyagent's OAuth endpoints and starts sign-in:

1. You're sent to your native WHMCS admin login — your existing 2FA, brute-force and IP rules apply, because Relyagent shows no login form of its own.
2. A consent screen lists this connection's tools. Approve it to finish.

Verify it works

Ask Claude Code to list its available WHMCS tools. It should show only the tools you ticked for this connection — nothing more. Any tool outside that set is rejected.

If it won't connect

Make sure you provided both the Client ID and Client Secret — the Endpoint URL alone isn't enough. Confirm you signed in at the WHMCS admin login and approved consent, and double-check the exact Endpoint URL. See the error reference.

Related

• Configuration — create and manage connections
• Setup tab: Addons → Relyagent → Setup
• MCP tools — what each tool group does