Dashboard login
Click Sign In on the website. You are redirected to Discord OAuth with scopes: identify, email, and guilds. After approval, you return to the dashboard with a JWT session.
Invite the bot
From Dashboard → Servers, select a server you manage or use the invite link. The bot needs permissions to manage channels, roles, messages, and members for full agent coverage.
OAuth flow (self-hosted)
GET /api/v1/auth/discord → Discord authorize → GET /api/v1/auth/discord/callback → Redirect to /auth/callback?token=<jwt>
Verify connection
- Bot appears online in Discord
- Server listed under Dashboard → Servers
- GET /api/v1/health returns ok from your API
Troubleshooting
- Missing Manage Server — only owners/admins can connect a guild
- Bot offline — check token, intents (Members + Message Content), and bot process
- OAuth redirect mismatch — add exact callback URL in Discord Developer Portal