Discord (`discord`)¶

The discord connector indexes messages from the text channels of one Discord server (guild), including its active threads.

How MFS sees it¶

Top-level channels expose a message stream; active thread channels nest under their parent:

discord://community/
└── channels/
    ├── general__987654321/messages.jsonl
    └── eng__111222333/
        ├── messages.jsonl
        └── threads/
            └── incident-42__444555666/messages.jsonl

Unlike Slack, Discord has no per-message thread field — a thread is a separate child channel. So the discord.messages preset indexes one chunk per message, keyed by id, rendered with the author (alice: deploy failed). No [[objects]] config is needed.

Credentials¶

You need a Bot token and the Guild ID (the server's numeric ID).

Bot token — https://discord.com/developers/applications → New Application:

Bot → Add Bot → Reset Token → copy it.
On the same page, enable Message Content Intent under Privileged Gateway Intents. Without it the bot connects but every message has empty content.
OAuth2 → URL Generator → scope bot, permissions View Channels + Read Message History. Open the generated URL and add the bot to your server (you need Manage Server permission).

Discord applications page

Discord create app dialog

Discord bot token settings

Discord message content intent

Discord OAuth2 URL generator scopes

Discord bot permissions

Guild ID — enable Settings → Advanced → Developer Mode, then right-click the server name → Copy Server ID.

Configuration¶

token = "env:DISCORD_BOT_TOKEN"
guild_id = "987654321098765432"
max_read_rows = 50000

Sync and freshness¶

The connector tracks the latest message_id per channel as its cursor; re-syncs fetch only newer messages. Deletion detection is never.

Search and browse¶

mfs add discord://community --config ./discord.toml

mfs search "deploy failed" discord://community
mfs ls discord://community/channels/general__987654321
mfs cat discord://community/channels/general__987654321/messages.jsonl --locator '{"id":"1234567890123456789"}'

Pitfalls¶

Without Message Content Intent, message content comes back empty.
Only text and announcement channels are enumerated.
Only active threads are listed; archived threads aren't included.
Each message is its own chunk — there's no thread-aggregate like Slack's.

Discord (discord)¶