> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Discord to Cogno

> Connect a Discord server so Cogno reads its messages as workspace context and turns them into proposed tasks.

<img src="https://mintcdn.com/genaxis/oMT3YnoHFDqPiaPK/images/integrations/discord.svg?fit=max&auto=format&n=oMT3YnoHFDqPiaPK&q=85&s=235fc4f16c1ca9fa31bcb0efde97b067" alt="Discord" width="56" height="56" noZoom data-path="images/integrations/discord.svg" />

## At a glance

|                    |                                                                                              |
| ------------------ | -------------------------------------------------------------------------------------------- |
| **Direction**      | Receive-only — Cogno reads messages from one Discord server. It does not reply or post back. |
| **Connect with**   | Discord OAuth — one click.                                                                   |
| **Who can set up** | Any workspace member who can open **Settings**.                                              |
| **You'll need**    | A Discord server you can add the Cogno bot to.                                               |

Connect a Discord server and Cogno reads what your community is already discussing, using it as workspace context and turning actionable messages into **proposed tasks**. Cogno listens only — it never posts in your server.

## Before you start

* You can open **Settings** in the target workspace.
* The Cogno bot is (or can be) added to the Discord server you want to read from.

## Connect Discord in Cogno

<Steps>
  <Step title="Open the Discord integration">
    Open **Settings → Integrations** and select **Discord**.
  </Step>

  <Step title="Authorize Discord">
    Click **Connect Discord**. Cogno opens Discord's authorization screen in a new window; approve it and Discord returns you to Cogno.
  </Step>

  <Step title="Confirm the connection">
    The Discord page shows a **Connection** section for this workspace.
  </Step>
</Steps>

## Select a server

<Steps>
  <Step title="Open Discord server">
    In the **Discord server** section, review the servers where both you and the Cogno bot are present. If none appear, add the bot to your server and click **Refresh**.
  </Step>

  <Step title="Select the server">
    Click **Select** on the server this workspace should read from. Cogno shows **Selected: {server}** once chosen.
  </Step>
</Steps>

The **Channels** section lists the channels the Cogno bot can see in the selected server.

## Map Discord users to workspace members

Under **User Mappings**, click **Sync Users** to gather the Discord users Cogno has seen in messages, then map each to a Cogno **member** so authors and mentions resolve to the right person.

## Disconnect

Under **Disconnect**, click **Disconnect Discord** to remove Discord from this workspace.

## Common states

| State                              | Meaning                                                | Next action                                               |
| ---------------------------------- | ------------------------------------------------------ | --------------------------------------------------------- |
| **Discord server** list is empty   | The Cogno bot isn't in a shared server yet             | Add the bot to your server, then click **Refresh**        |
| "This server is already connected" | The server is connected to a different Cogno workspace | Connect from that workspace, or disconnect it there first |
| **User Mappings** is empty         | Cogno hasn't observed messages from users yet          | Send a message in the server, then click **Sync Users**   |

## Reference URLs

* [Discord: how to add a bot to your server](https://discord.com/developers/docs/quick-start/getting-started)

## Related docs

* [Troubleshooting](/docs/troubleshooting)