discord-mcp MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

44+ MCP tools for comprehensive Discord server management
Full moderation suite: kick, ban, timeout, manage bans
Channel management: create, edit, delete text/voice/stage channels
Webhook support: create, delete, send messages via webhooks
Scheduled events management with attendee tracking

ライブデモ

実際の動作

discord-mcp-2.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "discord-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "discord-mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/SaseQ/discord-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "discord-mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/SaseQ/discord-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add discord-mcp-2 -- TODO 'See README: https://github.com/SaseQ/discord-mcp'

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： discord-mcp

How to automate Discord server moderation with discord-mcp

👤 Discord server moderators and community managers ⏱ ~10 min beginner

使うタイミング： You want to perform bulk moderation actions or set up automated responses.

前提条件

Discord bot token — Create a bot at discord.com/developers and invite it to your server with appropriate permissions

フロー

Review recent activity

Show me the last 50 messages in #general. Flag any that contain spam links or rule violations.✓ コピーしました

→ Message list with flagged items highlighted
Take moderation action

Delete the flagged messages and timeout the users who posted them for 24 hours.✓ コピーしました

→ Confirmation of deletions and timeouts applied

結果： Spam cleaned up and violators timed out in one operation.

注意点

Bot lacks required permissions — Ensure the bot role has Manage Messages, Moderate Members, and other needed permissions

Set up event channels and scheduled events for your community

👤 Community organizers running Discord-based events ⏱ ~15 min intermediate

使うタイミング： You need to create channels, roles, and scheduled events for a community meetup or tournament.

前提条件

Discord bot with Manage Channels and Manage Events permissions — Set up via discord.com/developers

フロー

Create event infrastructure

Create a new category called 'Game Night March 2025' with text channels #announcements, #general-chat, and #voice-lobby. Also create a voice channel.✓ コピーしました

→ Channels created with confirmations
Schedule the event

Create a scheduled event for 'Game Night' this Saturday at 8pm EST in the voice-lobby channel. Description: 'Weekly game night! Join us for Among Us and Jackbox.'✓ コピーしました

→ Scheduled event created with link
Create a role for participants

Create a 'Game Night Crew' role with a green color and assign it to @user1, @user2, and @user3.✓ コピーしました

→ Role created and assigned

結果： Complete event setup with channels, scheduled event, and participant roles.

注意点

Channel permission overwrites are complex — Set permissions at the category level and let channels inherit them

組み合わせ

他のMCPと組み合わせて10倍の力を

discord-mcp-2 + github

Post GitHub PR notifications to a Discord channel automatically

Check for new merged PRs in our repo since yesterday and post a summary to #dev-updates on Discord.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
send_message	channel_id: str, content: str	Send a message to a Discord channel	1 Discord API call
read_messages	channel_id: str, limit?: int	Read message history from a channel	1 Discord API call
create_text_channel	name: str, category_id?: str	Create a new text channel	1 Discord API call
kick_member	user_id: str, reason?: str	Kick a member from the server	1 Discord API call
create_scheduled_event	name, start_time, channel_id, description?	Schedule a server event	1 Discord API call
create_role	name: str, color?: str, permissions?: int	Create a new role on the server	1 Discord API call

コストと制限

運用コスト

APIクォータ: Discord bot rate limits apply (varies by endpoint, typically 5-50 req/s)
呼び出しあたりのトークン: 200–800 tokens per tool call
金額: Free — Discord bot API is free
ヒント: Batch read operations when possible. Use server_id env var to restrict to one server.

セキュリティ

権限、シークレット、影響範囲

最小スコープ： Bot token with required permissions

認証情報の保管： Bot token in environment variable. Never commit bot tokens to repos.

データ送信先： All calls go to Discord API (discord.com)

絶対に付与しない： Administrator permission to the bot unless absolutely necessary

Grant only the minimum permissions your bot needs. Avoid the Administrator permission.
Write operations (send, delete, kick, ban) are irreversible — review before executing.

トラブルシューティング

よくあるエラーと対処法

403 Missing Permissions

The bot lacks the required permission for this action. Check the bot's role permissions in Server Settings → Roles.

確認： Review the bot's role permissions in Discord server settings

Unknown Channel / 404

The channel ID is incorrect or the bot doesn't have access to that channel. Verify the channel exists and the bot can see it.

確認： List channels with channels_list tool first

Docker container can't connect

Ensure the DISCORD_TOKEN environment variable is set correctly in your docker-compose.yml or docker run command.

確認： docker logs <container-name>

代替案

discord-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
slack-mcp-server	Your team uses Slack instead of Discord	Different platform, similar feature coverage

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る