Connect Claude Desktop

This guide connects the Claude Desktop app 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 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 Desktop accordion with the Endpoint URL pre-filled and copy-paste steps.

Add Relyagent as a custom connector

1. Open Claude Desktop → Settings → Connectors.
2. Add a custom connector and paste 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 Desktop accordion)

Authorize and consent

Claude 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 what WHMCS tools it has. It should list 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 pasted 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