Connect Claude Code

This guide connects Claude Code to your WHMCS through Relyagent. Relyagent turns WHMCS into a self-hosted MCP server — an open standard that lets AI assistants call external tools — 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 a custom MCP connector in its connector settings.
2. Provide the Endpoint URL above as the connector's server URL.
3. When prompted for credentials, enter the connection's Client ID and Client Secret.

Addons → Relyagent → Setup (Claude Code accordion)

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