# Connect Grok Bot for Yourself

Add your Dtwo gateway to Grok Bot just for yourself.

## Overview

This guide adds your Dtwo gateway to Grok Bot just for you. Your Bot runs in the cloud, so once the gateway is added it's available from the Grok Bot desktop and mobile apps.

## Set up Grok Bot

Select how your gateway signs people in.

<div class="doc-tabs" data-tabs>

<div class="doc-tablist doc-tablist-cards" role="tablist" aria-label="Sign-in type">
<button type="button" role="tab" class="doc-tab" data-tab="dtwo" aria-selected="true"><img src="/favicon.svg" alt="" width="36" height="36" data-no-lightbox>Dtwo authentication</button>
<button type="button" role="tab" class="doc-tab" data-tab="entra"><img src="/logos/azure.svg" alt="" width="36" height="36" data-no-lightbox>Microsoft Entra ID</button>
<button type="button" role="tab" class="doc-tab" data-tab="okta"><img src="/logos/okta.png" alt="" width="36" height="36" data-no-lightbox>Okta</button>
</div>

<div class="doc-tabpanel" data-panel="dtwo" role="tabpanel">

<p class="doc-step">Step 1: Add the gateway to Grok Bot</p>

If your admin gave you a gateway URL, use it as your `<GatewayURL>`.

1. In the Grok Bot app, open **Connect apps** from the sidebar and choose **Add a custom connector** at the bottom.
2. Fill in the connector:
   - **Name**: `<GatewayName>`
   - **Type**: **Remote HTTPS**
   - **Server URL**: `<GatewayURL>`

   Replace the placeholders:

   - `<GatewayName>`: the name you want to see for the gateway in Grok Bot.
   - `<GatewayURL>`: your gateway's MCP URL. Copy it from your gateway's **Overview** tab in the Dtwo UI. It must start with `https://`.

3. Choose **Add plugin**, then sign in with your Dtwo account when the Bot asks.

You can also paste the URL into a chat and ask the Bot to add it as a custom MCP server. Say "custom server", or the Bot may look for a catalog plugin instead.

<p class="doc-step">Step 2: Verify the connection</p>

1. Open **Connect apps** and confirm your gateway is listed as connected.
2. In a chat, type `@` and attach your gateway, then ask which tools it has. It should list the tools from the MCP servers behind your gateway.

</div>

<div class="doc-tabpanel" data-panel="entra" role="tabpanel">

<p class="doc-step">Step 1: Get Grok Bot's client ID and secret from Microsoft Entra ID</p>

If your admin gave you a client ID, a client secret, and a gateway URL, use them as your `<ClientId>`, `<ClientSecret>`, and `<GatewayURL>` and skip to Step 2.

If you've already registered Grok Bot as an app in Microsoft Entra ID, go to **App registrations** and open the Grok Bot app. Copy the **Application (client) ID** from its **Overview** page — this is your `<ClientId>`. You'll also need the client secret you created when you registered it — this is your `<ClientSecret>`. If you no longer have it, create a new one under **Certificates & secrets**.

If you haven't registered Grok Bot in Microsoft Entra ID yet, follow [Register Grok Bot in Microsoft Entra ID](/docs/register-grok-bot-entra), then come back here.

<p class="doc-step">Step 2: Add the gateway to Grok Bot</p>

1. In the Grok Bot app, open **Connect apps** from the sidebar and choose **Add a custom connector** at the bottom.
2. Fill in the connector:
   - **Name**: `<GatewayName>`
   - **Type**: **Remote HTTPS**
   - **Server URL**: `<GatewayURL>`
   - **OAuth Client ID**: `<ClientId>`
   - **Client Secret**: `<ClientSecret>`. This field appears after you enter the client ID.

   Replace the placeholders:

   - `<GatewayName>`: the name you want to see for the gateway in Grok Bot.
   - `<GatewayURL>`: your gateway's MCP URL. Copy it from your gateway's **Overview** tab in the Dtwo UI. It must start with `https://`.
   - `<ClientId>` and `<ClientSecret>`: the client ID and secret created when Grok Bot was registered in your identity provider.

3. Choose **Add plugin**, then sign in with your work account when the Bot asks.

<p class="doc-step">Step 3: Verify the connection</p>

1. Open **Connect apps** and confirm your gateway is listed as connected.
2. In a chat, type `@` and attach your gateway, then ask which tools it has. It should list the tools from the MCP servers behind your gateway.

</div>

<div class="doc-tabpanel" data-panel="okta" role="tabpanel">

<p class="doc-step">Step 1: Get Grok Bot's client ID and secret from Okta</p>

If your admin gave you a client ID, a client secret, and a gateway URL, use them as your `<ClientId>`, `<ClientSecret>`, and `<GatewayURL>` and skip to Step 2.

If you've already registered Grok Bot as an app in Okta, go to **Applications and Resources → Applications** and open the Grok Bot app integration. On its **General** tab, copy the **Client ID** — this is your `<ClientId>` — and the **Client secret** — this is your `<ClientSecret>`.

If you haven't registered Grok Bot in Okta yet, follow [Register Grok Bot in Okta](/docs/register-grok-bot-okta), then come back here.

<p class="doc-step">Step 2: Add the gateway to Grok Bot</p>

1. In the Grok Bot app, open **Connect apps** from the sidebar and choose **Add a custom connector** at the bottom.
2. Fill in the connector:
   - **Name**: `<GatewayName>`
   - **Type**: **Remote HTTPS**
   - **Server URL**: `<GatewayURL>`
   - **OAuth Client ID**: `<ClientId>`
   - **Client Secret**: `<ClientSecret>`. This field appears after you enter the client ID.

   Replace the placeholders:

   - `<GatewayName>`: the name you want to see for the gateway in Grok Bot.
   - `<GatewayURL>`: your gateway's MCP URL. Copy it from your gateway's **Overview** tab in the Dtwo UI. It must start with `https://`.
   - `<ClientId>` and `<ClientSecret>`: the client ID and secret created when Grok Bot was registered in your identity provider.

3. Choose **Add plugin**, then sign in with your work account when the Bot asks.

<p class="doc-step">Step 3: Verify the connection</p>

1. Open **Connect apps** and confirm your gateway is listed as connected.
2. In a chat, type `@` and attach your gateway, then ask which tools it has. It should list the tools from the MCP servers behind your gateway.

</div>

</div>

---

Having trouble? Email [support@dtwo.ai](mailto:support@dtwo.ai).