Discord MCP: три сервера и подключение к Claude Code, Codex и Cursor

SaseQ/discord-mcp· Проверено 12.11.2026· 603на GitHub

Подключает агента к Discord через вашего бота: читать и отправлять сообщения, вести каналы, ветки и форумы, раздавать роли, модерировать участников и собирать сервер с нуля.

3 реализации:

Сервер на Java (JDA) в Docker: один контейнер на HTTP localhost:8085 для всех клиентов, 81 инструмент от сообщений до событий, вебхуков и эмодзи.

Как подключить

Что сделать до подключения

Docker и бот Discord с токеном

Запустить контейнер: docker run -d -i --name discord-mcp --restart unless-stopped -p 8085:8085 -e SPRING_PROFILES_ACTIVE=http -e DISCORD_TOKEN -e DISCORD_GUILD_ID saseq/discord-mcp:latest

DISCORD_TOKEN

Токен бота из Discord Developer Portal; задаётся контейнеру при запуске

DISCORD_GUILD_ID

Необязательно: ID сервера по умолчанию, тогда guildId в инструментах можно не передавать

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http discord http://localhost:8085/mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.discord]
url = "http://localhost:8085/mcp"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "discord": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "discord": {
      "type": "http",
      "url": "http://localhost:8085/mcp"
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "discord": {
      "httpUrl": "http://localhost:8085/mcp"
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "discord": {
      "httpUrl": "http://localhost:8085/mcp"
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "discord": {
        "type": "remote",
        "url": "http://localhost:8085/mcp"
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://localhost:8085/mcp

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "discord": {
      "url": "http://localhost:8085/mcp"
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

get_server_infoчитает сведения о сервере

read_messagesчитает историю канала

search_messagesищет текст в последних сообщениях

send_messageотправляет сообщение в канал

edit_messageправит сообщение

send_private_messageпишет в личку

add_reactionставит реакцию

create_text_channelсоздаёт текстовый канал

list_channelsвыводит каналы

create_categoryсоздаёт категорию

create_roleсоздаёт роль

assign_roleвыдаёт роль участнику

timeout_memberвыдаёт тайм-аут

ban_memberбанит участника

create_guild_scheduled_eventсоздаёт событие сервера

upsert_role_channel_permissionsзадаёт права роли в канале

create_inviteсоздаёт приглашение

create_forum_postсоздаёт пост в форуме

create_webhookсоздаёт вебхук

create_emojiзагружает эмодзи

Показано 20 из 81.

Пакет npm на Node.js: запускается через npx по stdio, умеет и HTTP; 45 инструментов, упор на сообщения, форумы и роли.

Как подключить

Что сделать до подключения

Node.js 18 или новее

Бот в Discord Developer Portal с включёнными Message Content Intent, Server Members Intent и Presence Intent, добавленный на ваш сервер

DISCORD_TOKEN

Discord Developer Portal → ваше приложение → бот → токен

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'DISCORD_TOKEN=<токен бота>' --transport stdio mcp-discord \
  -- npx mcp-discord

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-discord]
command = "npx"
args = ["mcp-discord"]

[mcp_servers.mcp-discord.env]
DISCORD_TOKEN = "<токен бота>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-discord": {
      "command": "npx",
      "args": ["mcp-discord"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-discord": {
      "type": "stdio",
      "command": "npx",
      "args": ["mcp-discord"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-discord": {
      "command": "npx",
      "args": ["mcp-discord"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-discord": {
      "command": "npx",
      "args": ["mcp-discord"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-discord": {
        "type": "local",
        "command": ["npx", "mcp-discord"],
        "environment": {
          "DISCORD_TOKEN": "<токен бота>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-discord": {
      "command": "npx",
      "args": ["mcp-discord"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-discord": {
      "command": "npx",
      "args": ["mcp-discord"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Инструменты сервера

discord_list_serversвыводит серверы бота

discord_read_messagesчитает сообщения канала

discord_search_messagesищет сообщения на сервере

discord_sendотправляет сообщение

discord_create_forum_postсоздаёт пост в форуме

discord_reply_to_forumотвечает в посте форума

discord_pin_messageзакрепляет сообщение

discord_create_roleсоздаёт роль

discord_list_membersвыводит участников с ролями

discord_set_channel_permissionsзадаёт права в канале

Показано 10 из 45.

222 инструмента за поиском и диспетчером, сборка сервера по плану с вашим одобрением и проверкой; мастер setup включает режим превью без записи.

Как подключить

Что сделать до подключения

Node.js 22.12 или новее: npm install -g @discord-mcp/cli

Свой бот на сервере, которым вы управляете

Выполнить discord-mcp setup --profile <имя> --client <клиент> и вставить выданный фрагмент в конфиг клиента: setup его сам не правит

DISCORD_TOKEN

Токен бота из Discord Developer Portal; держите его в окружении, из которого запускается клиент, а в конфиг не пишите

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'DISCORD_TOKEN=<токен бота>' --transport stdio discord-mcp \
  -- discord-mcp serve --profile '<имя профиля>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.discord-mcp]
command = "discord-mcp"
args = ["serve", "--profile", "<имя профиля>"]

[mcp_servers.discord-mcp.env]
DISCORD_TOKEN = "<токен бота>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "discord-mcp": {
      "command": "discord-mcp",
      "args": ["serve", "--profile", "<имя профиля>"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "discord-mcp": {
      "type": "stdio",
      "command": "discord-mcp",
      "args": ["serve", "--profile", "<имя профиля>"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "discord-mcp": {
      "command": "discord-mcp",
      "args": ["serve", "--profile", "<имя профиля>"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "discord-mcp": {
      "command": "discord-mcp",
      "args": ["serve", "--profile", "<имя профиля>"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "discord-mcp": {
        "type": "local",
        "command": ["discord-mcp", "serve", "--profile", "<имя профиля>"],
        "environment": {
          "DISCORD_TOKEN": "<токен бота>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "discord-mcp": {
      "command": "discord-mcp",
      "args": ["serve", "--profile", "<имя профиля>"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "discord-mcp": {
      "command": "discord-mcp",
      "args": ["serve", "--profile", "<имя профиля>"],
      "env": {
        "DISCORD_TOKEN": "<токен бота>"
      }
    }
  }
}

Инструменты сервера

mcp_tools_searchищет нужный инструмент

mcp_tools_readвызывает инструмент чтения

mcp_tools_writeвызывает инструмент записи

mcp_tools_destructiveвызывает опасный инструмент

build_discord_serverстроит план сервера

guild_blueprint_applyприменяет одобренный план

guild_blueprint_evidenceпроверяет результат сборки

Показано 7 из 222.

Что попросить агента

«Перескажи, что обсуждали в канале #<канал> за последние сутки»Агент найдёт канал через list_channels и прочитает историю через read_messages

«Создай категорию «Ивенты» с текстовым и голосовым каналом и закрой её для роли <роль>»SaseQ вызовет create_category, create_text_channel, create_voice_channel и upsert_role_channel_permissions

«Дай участнику <ник> тайм-аут на час за спам»SaseQ найдёт ID через get_user_id_by_name и вызовет timeout_member

«Собери сервер для игрового сообщества: каналы, роли, онбординг и AutoMod»cappyeo построит план через build_discord_server, после вашего одобрения применит его через guild_blueprint_apply и проверит через guild_blueprint_evidence

Для каких задач

Прочитать обсуждение в канале или ветке и пересказать его

Отправить, поправить или закрепить сообщение от имени бота

Создать каналы, категории, форумы и права доступа для ролей

Выдать или снять роли, тайм-аут, кик и бан

Запланировать событие сервера и собрать список заинтересованных

Собрать сервер сообщества по одному запросу: каналы, роли, онбординг, AutoMod

Ограничения

Все три сервера работают от имени бота: он видит только серверы, куда его добавили, и делает только то, что разрешают его роли

Обычные записи вроде отправки сообщения выполняются без подтверждения; удаления и баны требуют внимания: дайте боту минимум прав и начните с тестового сервера

SaseQ на HTTP доступен только с вашей машины по localhost:8085; удалённым коннектором Claude Desktop его можно подключить только через публичный HTTPS: туннель или обратный прокси

Discord MCP от cappyeo ещё до версии 1.0, и мастер setup по умолчанию ставит MCP_WRITE_MODE=preview: запись закрыта, пока вы её не включите

Если не работает

Инструмент отвечает 403 Missing Permissions

Бот вошёл, но его роли не хватает прав в этом канале: проверьте права роли на сервере и переопределения канала, выдайте минимально нужное право.

Инструмент отвечает 404 или «Unknown Channel»

Инструменты ждут числовые ID, имена вида #канал не подходят: скопируйте ID в режиме разработчика или возьмите его из списка каналов.

Клиент не видит discord-mcp после смены токена или профиля (cappyeo)

Сервер читает окружение только при запуске: сделайте DISCORD_TOKEN доступным клиенту, полностью закройте и откройте его. Проверка: discord-mcp doctor --profile <имя> --online.

DRY_RUN_PREVIEW так и не превращается в реальное действие (cappyeo)

Для инструментов с подтверждением нужны оба условия: MCP_DRY_RUN=false в окружении сервера и __confirm: true в вызове.

n8n в Docker не подключается к SaseQ по localhost

Внутри контейнера n8n localhost указывает на сам контейнер: используйте имя сервиса, например http://discord-mcp:8085/mcp.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Discord MCP (SaseQ)	SaseQ	603	HTTP	не нужен	81	23 октября 2026
MCP-Discord	barryyip0625	111	локально	токен	45	5 ноября 2026
Discord MCP (cappyeo)	cappyeo	188	локально	токен	222	12 ноября 2026

Частые вопросы

Какой сервер выбрать?

Проще всего запустить MCP-Discord через npx с токеном бота. SaseQ — один Docker-контейнер на HTTP для нескольких клиентов и 81 инструмент. cappyeo — самый широкий набор из 222 инструментов и сборка сервера по плану с проверкой, но требует мастера setup.

Как создать бота и получить токен?

В Discord Developer Portal создайте приложение и бота, скопируйте токен. Для MCP-Discord включите Message Content Intent, Server Members Intent и Presence Intent и добавьте бота на сервер ссылкой приглашения с нужными правами или с правами администратора.

Можно ли не передавать ID сервера в каждом вызове?

Да, у SaseQ задайте DISCORD_GUILD_ID: тогда параметр guildId во всех инструментах становится необязательным.

Почему агент не видит канал по имени?

Инструменты Discord работают с числовыми ID. Включите режим разработчика в Discord и скопируйте ID сервера или канала либо попросите агента сначала вывести список каналов.

Работает ли сервер из России?

Серверы работают на вашем компьютере или в своём Docker-контейнере и ходят в Discord API от имени вашего бота.

Discord MCP: три сервера и подключение к Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы