Discord MCP for Codex

Discord MCP — это локальный плагин для Codex, который предоставляет Discord-бота в виде MCP-инструментов. Codex запускает мост по требованию; постоянно работающий шлюз-сервис или публичный сервер не требуется.

[!IMPORTANT] Этот проект ни связан с Discord и не одобрен компанией Discord. Discord является товарным знаком Discord Inc. Используйте бота только на тех серверах, где вы уполномочены выполнять администрирование.

Требования

• Codex desktop с поддержкой локальных плагинов

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

• Discord-приложение с ботом

Related MCP server: Discord MCP Server

Возможности

• Проверка подключения бота и создание ссылки-приглашения

• Получение списка доступных серверов, каналов и ролей

• Создание, изменение и удаление каналов

• Отправка сообщений

• Создание, изменение и удаление ролей

• Добавление и удаление ролей у участников

• Вызов любого JSON-эндпоинта Discord API v10 в рамках гильдии через защищённые универсальные инструменты чтения/записи

Запасной уровень поддерживает модерацию, баны, тайм-ауты, AutoMod, ветки, реакции, эмодзи, стикеры, запланированные события, онбординг, звуковую панель, разрешения, управляемые ботом вебхуки и новые REST-эндпоинты в рамках гильдии — без ожидания обновления плагина.

Discord по-прежнему применяет разрешения бота, включённые интенты и иерархию ролей. Деструктивные инструменты требуют токен подтверждения, привязанный к конкретной цели. Любая универсальная запись предварительно просматривается и требует токен подтверждения, привязанный к конкретному запросу, до своего выполнения.

Установка

1. На портале разработчиков Discord создайте приложение и добавьте Discord-бот.

2. Сбросьте или скопируйте токен Discord-бота. Никогда не вставляйте его в чат и не сохраняйте в папке этого плагина.

3. Запустите PowerShell и выполните:

   & "$HOME\plugins\discord-mcp\scripts\configure.ps1"

   Скрипт безопасно запросит токен и, при желании, разделённый запятыми список разрешённых ID гильдий. Он сохранит значения в вашем окружении пользователя Windows, чтобы Codex мог передать их MCP-процессу.

4. После настройки перезапустите приложение Codex desktop.

5. Установите или включите Discord MCP из личного маркетплейса, затем начните новую задачу.

6. Спросите: «Проверь статус моего Discord-бота и дай мне его ссылку-приглашение администратора».

7. Откройте ссылку-приглашение администратора и авторизуйте бота на нужном сервере. В результате проверки статуса также есть и наименее привилегированная альтернатива.

Чтобы найти ID гильдии, включите в Discord режим разработчика, щёлкните правой кнопкой по значку сервера и выберите Copy Server ID. Настоятельно рекомендуется указывать DISCORD_ALLOWED_GUILD_IDS; мост отклоняет все гильдии вне этого списка.

Установка из исходников

1. Склонируйте этот репозиторий в ваш локальный каталог плагинов Codex как discord-mcp.

2. Добавьте плагин в локальный маркетплейс Codex или используйте манифест плагина из репозитория в вашем существующим рабочем процессе локальных плагинов.

3. Настройте учётные данные бота, как описано ниже.

4. Установите или включите Discord MCP, перезапустите Codex и начните новую задачу.

Манифест плагина находится в .codex-plugin/plugin.json, а описание MCP-сервера — в .mcp.json.

Загрузки релизов

Каждый push в ветку main, прошедший набор тестов, создаёт GitHub Release, содержащее:

• Версионированный ZIP-архив плагина discord-mcp-vX.Y.Z-build.N.zip

• Соответствующий файл контрольной суммы SHA-256

• Автоматически создаваемые примечания к выпуску

Архив распаковывается в каталог discord-mcp и может быть размещён напрямую в локальном каталоге плагинов Codex. Семантическая версия берётся из package.json; номер исполнения GitHub Actions делает каждую сборку из ветки main уникально загружаемой.

Конфигурация

• DISCORD_BOT_TOKEN (обязательно): токен Discord-бота.

• DISCORD_ALLOWED_GUILD_IDS (рекомендуется): id гильдии Discord через запятую.

Выполните scripts/configure.ps1 -Clear, чтобы удалить обе переменные окружения пользователя.

На macOS или Linux задайте те же переменные в окружении, используемом для запуска Codex. Например:

export DISCORD_BOT_TOKEN='your-token'
export DISCORD_ALLOWED_GUILD_IDS='123456789012345678'

Не помещайте реальные значения в отслеживаемый файл и не вставляйте их в задачу Codex.

Административный доступ

discord_status теперь возвращает:

• administrator_invite_url — ссылку, которая запрашивает бит разрешения Discord ADMINISTRATOR (8);

• least_privilege_invite_url — ссылку, которая запрашивает только обычные права управления плагином;

• invite_url — ссылку-приглашение администратора для удобства.

Если бот уже находится на сервере, авторизуйте его заново через administrator_invite_url или включите право Администратор для его роли бота в Настройки сервера → Роли. Переместите роль бота выше всех ролей, которыми ему нужно управлять. Право администратора обходит переопределения прав каналов, но не обходит иерархию ролей и не может действовать на владельца сервера.

Архитектура

Codex общается с локальным Node.js MCP-сервером без внешних зависимостим по stdio. MCP-сервер вызывает Discord API v10 через HTTPS с помощью токена бота. Он не прослушивает сетевой порт, не принимает сообщения Discord и не требует привилегированных интентов шлюза.

Ограничения и покрытие

Защищённые универсальные инструменты поддерживают JSON REST-эндпоинты в рамках гильдии с методами GET, POST, PUT, PATCH и DELETE. Перед выполнением запроса они определяют владельца гильдии по маршрутам гильдии, канала, сцены, при Я или авторизации вебхука ботом.

Этот локальный мост по требованию не реализует обработчики событий шлюза Discord, постоянное присутствие, потоковую передачу голоса/аудио, callback-вызовы взаимодействий с временными токенами, пользовательские потоки OAuth, маршруты выполнения вебхуков с токеном и потоковые загрузки multipart. Эти функции требуют отдельного и постоянно работающего процесса бота или отдельного сценария загрузки. Маршруты, содержащие учётные данные, и поля JSON намеренно заблокированы.

Замечания по безопасности

• Административный доступ очень мощный. Используйте его только на серверах, которыми вы контролируете, держите список разрешённых ди гильд включённым и защищайте токен бота, как пароль.

• Оставляйте список разрешённых гильдий включённым.

• Для поддерживаемых административных изменений отправляются причины журнала аудита Discord.

• Прямые записи привязаны к методу, пути, запросу, телу и причине аудита; изменение любого из них аннулирует токен подтверждение.

• Поля, похожие на учётные данные, блокируются в телах запросов и рекурсивно удаляются из необработанных ответов API.

• Если токен бота когда-либо был раскрыт, немедленно пересоздайте его во портале разработчика.

Полные рекомендации по приватному уведомлению об уязвимостях см. в SECURITY.md.

Разработка

MCP-сервер не имеет зависимостей во время выполнения. Запустите локальные проверки и смоук-тест протокола командой:

npm test

Смоук-тест использует токен-заглушку и не вызывает Discord. Запросы на слияние также проверяются GitHub Actions. См. CONTRIBUTING.md с правилами участия и CHANGELOG.md с историей версий.

Лицензия

Исходный код доступен по MIT License. Названия, логотипы и товарные знаки третьих сторон остаются собственностью их владельцев.