---
title: "Grok web"
canonical: https://workspace.socra.com/docs/channels/integrations/grok
---

# Connect Channels to Grok web

Keep Grok and [Cloud Projects](https://platform.socra.com/projects) open in separate tabs. You need a Grok account with custom connectors and a Socra Project you can manage. For a Grok team, ask its administrator if custom connectors are unavailable.

## 1. Start in Grok

Open [Grok Connectors](https://grok.com/connectors), then choose **Plugins → Connectors → New Connector → Custom**.

![The Connectors and Skills tabs, with New Connector at the upper right.](/docs/channels/grok/new-connector.png)

Choose **New Connector**, shown here at a larger reading size:

![A close-up of the New Connector button from the same screen.](/docs/channels/grok/new-connector-detail.png)

Enter **Socra Channels** as the name and this **Server URL**:

```text
https://channels.socra.cloud/mcp
```

![The custom connector named Socra Channels with the Channels MCP server URL.](/docs/channels/grok/name-and-server-url.png)

Select **Add Connector**. Grok discovers the server and opens **OAuth Credentials Required**. Keep that form open while you prepare its client ID in Platform.

If Socra Channels is already connected to the Account you intend to use, open that connector and continue at [Check tools](#5-check-tools). If you deliberately add another connection, choose a distinct name. A duplicate name can keep **Add Connector** disabled.

## 2. Prepare the Project in Platform

In [Cloud Projects](https://platform.socra.com/projects), choose the Account for this connection. You can use a Project you manage or create one.

The page opens **Manage Cloud Projects**. Select **Switch Projects**, search for the Project by name or ID, then select its row. This switches the active Project and closes the manager. Confirm the Project name in the console’s **Switch Cloud Project** control before continuing.

If you opened a Project’s inspection details instead, use **Back to list → Switch Projects**, then select its row. If the details say **Active Cloud Project**, close the manager with its close button to return to the console. Keep that Project selected throughout the following steps.

Open **Enabled services → Enable service**, select **Channels**, and enable it. Check that Channels appears in the enabled list. An enabled service still needs the Grok authorization below.

Open **OAuth → Overview**. If the Project has no OAuth configuration, select **Set up OAuth**, enter **Channels for Grok** as the application name, complete the required consent information, and save it. If configuration already exists, preserve it and continue to **OAuth → Clients**.

If Platform shows **Access needed**, copy its access request for the Project owner. Keep the selected Project and use **Check access again** after the owner resolves it.

## 3. Register the public client

In **OAuth → Clients**, select **Create client** and enter:

| Field              | Value                                              |
| ------------------ | -------------------------------------------------- |
| Client name        | Channels for Grok                                  |
| Application type   | Single-page app                                    |
| Redirect URLs      | `https://grok.com/connectors-oauth-exchange-code/` |
| JavaScript origins | Leave empty                                        |

Keep the final slash in the redirect URL. Select **Create client** and copy its client ID from the client details. This public client uses PKCE; leave the client secret empty in Grok.

## 4. Authorize in Grok

Return to **OAuth Credentials Required** and enter the client ID you copied.

![The OAuth form with Client ID, optional Client Secret, discovered endpoints, Scopes and Token Auth Method.](/docs/channels/grok/oauth-required.png)

| Field                  | Value                                            |
| ---------------------- | ------------------------------------------------ |
| Client ID              | Your new client ID                               |
| Client Secret          | Leave empty                                      |
| Authorization Endpoint | Keep `https://account.socra.com/oauth/authorize` |
| Token Endpoint         | Keep `https://oauth.socra.cloud/oauth/token`     |
| Scopes                 | Leave empty                                      |
| Token Auth Method      | none (PKCE only, recommended)                    |

Scroll within the dialog to reach **Save & Connect**. You can also press Tab from **Token Auth Method** to reach the bottom actions.

![The bottom of the same Grok OAuth form, showing Cancel and Save and Connect. The fields are blank in this screenshot.](/docs/channels/grok/oauth-bottom.jpg)

Select **Save & Connect**. Allow the sign-in popup if your browser blocks it, sign in to Socra, choose the Account you use in Channels, and approve access. Return to Grok and confirm that your connector appears under **Connected** with the name you saved.

If you cancel or close authorization, return to the connector and connect again. If authorization fails, compare the client ID, Single-page app type and exact redirect URL with the client in your selected Project. Confirm that Channels is enabled in that same Project before retrying.

## 5. Check tools

Open your connector under **Plugins → Connectors** and check its tools. Enable **Channels List** if it is off. Selecting an enabled tool toggles it off, so check its current state first.

Review any approval Grok requests for a tool call. Connector authorization and tool availability are separate checks.

## 6. Verify with a read

Start a new Grok conversation and send:

```text
Use Socra Channels to make exactly one channels_list tool call with limit 1. Do not read messages or send, create, update or delete anything. Report whether the call succeeded. An empty list is valid.
```

Expand the tool record and confirm that **Channels List** ran with `limit: 1` and returned a result. A successful empty list confirms the read. A reply without a tool execution does not confirm the connection.

If the call reports an access or service error, preserve its text. Confirm your authorized Account, the enabled Channels service in the client's Project, and the tool toggle before retrying. Ask the relevant Account or Project owner to resolve a denied permission. Share the error and approximate time with [Socra support](https://support.socra.com), keeping credentials and private conversation content out of the report.

## See also

- [Ways to use Channels](/docs/channels/ways-to-use)
- [Conversations and access](/docs/channels/concepts/conversations-and-access)
- [Channels troubleshooting](/docs/channels/troubleshooting)