Skip to main content

Setting Up the Brightflag Connector for Claude (Administrators)

This article is for organisation administrators setting up the Brightflag MCP connector in Claude for the first time. Complete both steps below before standard users attempt to connect.

Before you start

You will need the MCP URL provided to you by your Brightflag account team. If you do not have it, contact your Brightflag account team before proceeding.

Step 1: Choose a connection method

Brightflag supports two ways to register the connector with Claude. Choose whichever fits your organization’s security requirements. Both use the same MCP URL and lead to the same experience for end users.

Dynamic registration. Most organisations can use this option. When you add the Brightflag connector, Claude and Brightflag exchange registration details automatically (using a Client ID Metadata Document, or CIMD), so no clientId is needed. This is the fastest path and needs nothing from your Brightflag account team beyond the MCP URL.

Pre-registered client. If your organization’s security policy requires every OAuth client to be explicitly pre-approved, contact your Brightflag account team for a dedicated clientId and secret. You will enter these in Advanced Settings in Step 2.

Step 2: Create a custom connector for your organization

This step registers Brightflag as a connector in your organization’s Claude settings, making it available for user enablement.

  1. Go to organization settings.

  2. Go to Connectors.

  3. Select Add, then Custom, then Web.

  4. Complete the Add Custom Connector form:

    • Name it Brightflag.

    • Use the MCP URL provided to you by Brightflag.

    • If you are using a pre-registered client (see Step 1), open Advanced Settings and add the clientId and secret provided to you by Brightflag. Otherwise, leave this blank.

  5. Select Add.

Done. Brightflag now appears as a connector option in your organization’s settings. Continue to Step 3 if your organisation uses custom roles, or skip it if it does not.

Step 3: Enable the connector for users (custom roles only)

If your organisation uses custom roles to manage feature access, you will need to explicitly allow the Brightflag connector on the relevant roles before users can connect to it. If your organisation does not use custom roles, you can skip this step.

  1. Edit an existing custom role, or create a new one.

  2. Go to the Connectors tab in the edit or create role modal.

  3. Find the Brightflag connector and set it to Always allow.

Repeat this for every role that should have access to Brightflag. Once complete, users assigned to those roles will be able to connect to Brightflag from their own account.


​The Connectors tab of the Edit role modal, with the Brightflag connector set to Always allow.

Repeat this for every role that should have access to Brightflag. Once complete, users assigned to those roles will be able to connect to Brightflag from their own account.

What happens next

Let your users know they can now connect their own accounts. Point them to Connecting to Brightflag in Claude for the steps.

Did this answer your question?