Discord

The Discord package uses the Discord REST API for tools and the Discord Gateway for the optional chat interface.

Create and install the bot

Create an application in the Discord Developer Portal, add a bot, and copy its bot token into the connector. Invite the bot to the intended server with only the required channel and message permissions.

When chat is enabled, turn on the privileged Message Content intent under the bot settings. Without it, the gateway cannot read message text and closes with code 4014.

Add channel IDs

Enable Developer Mode in Discord, copy the exact channel IDs, and add them to the connector allowlist. ID matching is authoritative. Do not rely on a channel name unless that literal value was deliberately allowlisted.

Read tools list channels, read recent messages, and draft replies. Write tools send messages or add reactions and require connector writes.

Configure chat admission

Choose whether DMs are disabled, limited to immutable Discord user IDs, or open. Open DMs are rate limited. In server channels, optionally require a structured bot mention.

The gateway removes only the bot’s own mention from the assistant prompt. Bot-authored messages are ignored to prevent loops.

The chat interface can reply to a triggering message without granting proactive Discord tools. Add those tools only when the assistant must inspect or act outside the current reply.

Verify

Test one allowed channel, a disallowed channel, a DM under the selected policy, and an explicit reaction or send approval. If the gateway is unhealthy, confirm the token, bot invitation, channel permissions, Message Content intent, and server policy.

A reconnect currently starts a fresh gateway session rather than resuming the previous one. Short interruptions can therefore appear as a clean reconnection rather than a resumed sequence.