Setting Up a Bring Your Own Model (BYOM) AI Connector

Also known as “Bring Your Own Key” (BYOK).

This guide walks through connecting Uncountable to your own OpenAI or Anthropic account using your API key. This gives your team full control over usage, billing, and access.

Step 5 covers how to configure which connector is used: either disable other connectors to use your key exclusively, or set yours as the default while keeping multiple connectors active.

You will need: Platform administrator access in Uncountable (your user group must have “Admin Rights” enabled in User Admin > Groups), and an API key from OpenAI or Anthropic.

Step 1: Get Your API Key

OpenAI

1. Sign in at platform.openai.com.
2. Click your organization name in the top-left, then go to API keys.
3. Click Create new secret key, give it a name (e.g., “Uncountable”), and copy it immediately. The key starts with sk- and is shown only once.

Anthropic

1. Sign in at console.anthropic.com.
2. Go to Settings > API Keys.
3. Click Create Key, give it a name (e.g., “Uncountable”), and copy it immediately. The key starts with sk-ant- and is shown only once.

Step 2: Store Your API Key as a Secret in Uncountable

Uncountable stores API keys in a secure secrets store. You will not be able to view the key again after saving it, so have it ready before you start.

• In Uncountable, click your name or the settings icon in the top-right corner to open the admin menu, then click Company-Wide Settings.
• Find the Enable Generative AI Module section. Click the key icon beneath it to open Manage Secrets.

• In the “Manage Secrets” panel that opens:
  • Name: enter a human-readable label, e.g., My OpenAI Key or My Anthropic Key.
  • Ref Name: enter a machine-readable identifier with no spaces, e.g., my_openai_key or my_anthropic_key. Use only lowercase letters, numbers, and underscores.
  • Under Secret Values, click Add. The Key field will default to api_key; leave it as-is. Fill in Value with your API key.
• Click Create Secret.

Your secret now appears in the “Existing Secrets” list. Note down the Ref Name you used; you will need it in the next step.

Step 3: Create the AI Connector

• Click the gear icon beneath the Enable Generative AI Module section to open the connector panel.
• Click + External AI Connector.

• A form opens. Fill in the following fields: Field Value Name A display name, e.g., OpenAI Direct Type Direct OpenAI for OpenAI, or Direct Anthropic for Anthropic Scoped Secret Ref Name The Ref Name you created in Step 2, e.g., my_openai_key
• Select Create.

Step 4: Verify the Connection

After creating, you will be returned to the connector panel. Find your new connector and click the Test button in the Test Connection column.

The test sends a short “Reply with ‘ok'” prompt to your provider. A checkmark means the connection is working. If you see an error, double-check that the API key you stored in Step 2 is correct and has not been revoked.

Step 5: Configure Connector Priority

To ensure all AI features in your environment use your key exclusively, disable the default Uncountable-managed connectors. For each connector you are not using, click the edit icon in the Archived column. The checkbox will expand and become editable; check it to archive the connector. Archived connectors will not appear in the External AI Connectors listing the next time it is opened.

If you prefer to keep multiple connectors available and just set yours as the default, click the Move to top button (shown as a bold up arrow) in the Connector Selection column instead. The first-ranked connector is used when multiple are active.