Skip to content

Connect Claude Desktop ​

Connect the Claude Desktop app to your WHMCS through Relyagent's self-hosted MCP server, 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 connectors: go to Claude Desktop → Settings → Connectors and click Add custom connector.
  2. Name and URL: enter a name (e.g. WHMCS — Relyagent) and paste the Endpoint URL.
  3. Credentials: expand Advanced, enter the Client ID and Client Secret, and click Add.

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.

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

Documentation for the Relyweb app catalogue.