Connect Claude.ai

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

Add Relyagent as a custom connector

1. In Claude.ai, open 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.ai accordion)

Authorize and consent

Claude.ai 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