> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.pricelabs.co/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.pricelabs.co/_mcp/server.

# Custom Clients

Custom clients let you connect PriceLabs MCP to additional AI platforms beyond the built-in connectors. Create your own OAuth credentials and use them to integrate PriceLabs with supported third-party AI agents.

> **Supported platforms**
>
> Custom clients work with many AI platforms, including **ChatGPT**, **Gemini**, **Meta AI**, **Perplexity**, **Cursor**, **Notion**, **n8n**, **Make**, **ClickUp** and **Langdock**, as well as **local AI agents** (e.g. Claude Code or other CLI-based agents that use **localhost** callback URLs). Some platforms need to be enabled first: if your platform's callback URL is rejected, contact [support@pricelabs.co](mailto:support@pricelabs.co) to request it.

## Who can manage custom clients

Only the **account admin (superadmin)** can create, regenerate, or delete custom clients. Team members (sub-users) can *see* custom clients created by their admin and connect to them, but they cannot manage the credentials.

## Add a custom client

### 1. Open MCP settings

Sign in to PriceLabs as the account admin and navigate to **Account Settings → AI Connector (MCP)**.

### 2. Click Add Custom Connector

In the **Custom Connectors** section and click the **+ Add Custom Connector** button.

![PriceLabs MCP settings page with an arrow pointing to the Add Custom Connector button](/_fern-files/_img/a7dbd9ea0c0140efef25e06bbdf7d58d2325a967f2e939eb996ea8fa25cff027.webp)

### 3. Enter connector details

In the modal, fill in:

| Field            | Description                                                                        |
| ---------------- | ---------------------------------------------------------------------------------- |
| **Name**         | A label for the connector (e.g. `ChatGPT` or `n8n Production`).                    |
| **Callback URL** | The OAuth redirect/callback URL provided by the AI platform you are connecting to. |

![PriceLabs Add Custom Connector modal with Name and Callback URL fields filled in](/_fern-files/_img/17d8e300a6ac2237660346cdb87d7c8b0912514bcfe1aaec5944c836c67624d3.webp)

### 4. Save your credentials

After clicking **Add Custom Client**, PriceLabs will generate a **Client ID** and **Client Secret** and display them once.

> **Save your credentials now**
>
> The Client Secret is shown **only once** and cannot be retrieved again. Copy
> both the Client ID and Client Secret and store them in a secure location
> immediately.

![PriceLabs credentials modal showing the one-time Client ID and Client Secret](/_fern-files/_img/c1abbaee138560eb208afde3d0734827227e6e7aeb556a8e69284e9f54113fcd.webp)

### 5. Verify the connection

Once you complete the OAuth flow from the AI platform side, the custom client card will show a **Connected** status along with the granted scopes — one per permission you approved, such as Read, Write and Customization write.

![PriceLabs MCP settings showing a custom client with Connected status and read/write scopes](/_fern-files/_img/a381f8aaf99ac978f3ea792a55d478e9df81c6546fbde4ee004cb248c035451e.webp)

## Regenerate credentials

If you lose your Client Secret or need to rotate credentials, the account admin can regenerate them.

1. Navigate to **Account Settings → AI Connector (MCP)**.
2. Expand the custom client card.
3. Click **Regenerate**.
4. Confirm the action in the dialog.

> **All connections will be revoked**
>
> Regenerating credentials immediately **revokes all active connections** for
> every user connected through that custom client. All users will need to
> re-authorize with the new credentials.

A new Client ID and Client Secret will be displayed. Save them immediately — the secret will not be shown again.

## Disconnect a custom client

If you want to revoke your current connection to a custom client without deleting or regenerating it, you can disconnect directly from PriceLabs.

1. Navigate to **Account Settings → AI Connector (MCP)**.
2. Find the custom client card showing a **Connected** status.
3. Click the **Disconnect** button.

![PriceLabs MCP settings showing a connected custom client with an arrow pointing to the Disconnect button](/_fern-files/_img/b7e6c1e0d2ff95dda90ddfb2a37a4f2790dc3ebb59982d92a5854f401341e377.webp)

Disconnecting revokes the OAuth token for **your account only** — other team members who are connected through the same custom client will remain connected. The custom client itself is not removed, and you can reconnect at any time by completing the OAuth flow again from the AI platform side.

## Delete a custom client

1. Navigate to **Account Settings → AI Connector (MCP)**.
2. Expand the custom client card.
3. Click **Delete**.
4. Confirm the action in the dialog.

Deleting a custom client permanently removes it and revokes all active connections.

## Limits and restrictions

| Rule                          | Detail                                                                                                                                                                                                                                                                                         |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Maximum custom clients**    | Each account can have up to **3** custom clients.                                                                                                                                                                                                                                              |
| **Credential visibility**     | Client ID and Client Secret are displayed **only once** at creation (or regeneration) and cannot be fetched again.                                                                                                                                                                             |
| **Team Member access**        | Team members can see and connect to custom clients, but must obtain the Client ID and Client Secret from the account admin. Credentials are not displayed anywhere in the team member's dashboard.                                                                                             |
| **Regeneration side effects** | Regenerating credentials signs out **all** existing connections for that client and issues a new Client ID and Secret.                                                                                                                                                                         |
| **Supported platforms**       | Many AI platforms, including ChatGPT, Gemini, Meta AI, Perplexity, Cursor, Notion, n8n, Make, ClickUp and Langdock, plus **local AI agents**. Some platforms need to be enabled first: if a callback URL is rejected, email [support@pricelabs.co](mailto:support@pricelabs.co) to request it. |
| **Localhost callback URLs**   | Localhost (`http://localhost` or `http://127.0.0.1`) callback URLs are allowed for CLI-based agents such as Claude Code. See the security note below.                                                                                                                                          |

> **Security: localhost callback URLs**
>
> Allowing `localhost` as a callback URL enables local AI agents to connect to
> your PriceLabs account. Be cautious — any application running on the same
> machine could potentially intercept the OAuth callback. Only use localhost
> callbacks on trusted machines and ensure no untrusted software is running on
> the same port.

## Troubleshooting

### Using Cursor

Create a custom client with Cursor's callback URL, `https://www.cursor.com/agents/mcp/oauth/callback`, then enter that custom client's **Client ID** and **Client Secret** in Cursor.

### The redirect URI does not match

At sign in, the redirect URI sent by the AI platform must **exactly** match the Callback URL saved on the custom client, including the scheme, `www`, the full path and any trailing slash. If it differs, update the callback URL on the custom client or in the AI platform so both are identical.

### "The requested redirect uri is malformed or doesn't match client redirect URI"

This usually means the Client ID belongs to a different client. Always use the Client ID and Client Secret of your own custom client. The Client IDs of the built-in Claude and Grok connectors only accept their own callbacks and cannot be reused in other tools.

### I lost my Client Secret

The secret is shown only once at creation. Use **Regenerate** on the custom client to get a new Client ID and Client Secret. See [Regenerate credentials](#regenerate-credentials).

### The tool asks for dynamic client registration

Dynamic client registration is not supported. Add a custom client as described above and enter its Client ID and Client Secret in the tool instead.

### "Redirect URL is not allowed. Only whitelisted hosts and localhost are permitted."

This AI platform's callback URL has not been enabled yet. Callback URLs must use `https`, or `http` for `localhost` and `127.0.0.1` only. Contact [support@pricelabs.co](mailto:support@pricelabs.co) with the callback URL to request it.