Connect Grok Bot for Yourself
Add your Dtwo gateway to Grok Bot just for yourself.
On this page
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.
Step 1: Add the gateway to Grok Bot
If your admin gave you a gateway URL, use it as your <GatewayURL>.
-
In the Grok Bot app, open Connect apps from the sidebar and choose Add a custom connector at the bottom.
-
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 withhttps://.
- Name:
-
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.
Step 2: Verify the connection
- Open Connect apps and confirm your gateway is listed as connected.
- 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.
Step 1: Get Grok Bot's client ID and secret from Microsoft Entra ID
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, then come back here.
Step 2: Add the gateway to Grok Bot
-
In the Grok Bot app, open Connect apps from the sidebar and choose Add a custom connector at the bottom.
-
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 withhttps://.<ClientId>and<ClientSecret>: the client ID and secret created when Grok Bot was registered in your identity provider.
- Name:
-
Choose Add plugin, then sign in with your work account when the Bot asks.
Step 3: Verify the connection
- Open Connect apps and confirm your gateway is listed as connected.
- 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.
Step 1: Get Grok Bot's client ID and secret from Okta
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, then come back here.
Step 2: Add the gateway to Grok Bot
-
In the Grok Bot app, open Connect apps from the sidebar and choose Add a custom connector at the bottom.
-
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 withhttps://.<ClientId>and<ClientSecret>: the client ID and secret created when Grok Bot was registered in your identity provider.
- Name:
-
Choose Add plugin, then sign in with your work account when the Bot asks.
Step 3: Verify the connection
- Open Connect apps and confirm your gateway is listed as connected.
- 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.