Discord MCP para Codex

Discord MCP es un plugin local de Codex que expone un bot de Discord como herramientas MCP. Codex inicia el puente cuando es necesario; no se requiere ningún servicio gateway siempre activo ni un servidor público.

[!IMPORTANT] Este proyecto no está afiliado ni respaldado por Discord. Discord es una marca comercial de Discord Inc. Usa el bot únicamente en servidores donde tengas autorización para administrarlo.

Requisitos

• Codex de escritorio con soporte para plugins locales

• Node.js 18 o más reciente

• Una aplicación de Discord con un usuario de bot

Related MCP server: Discord MCP Server

Qué puede hacer

• Comprobar la conectividad y generar una URL de invitación

• Listar servidores, canales y roles accesibles

• Crear, editar y eliminar canales

• Enviar mensajes

• Crear, editar y eliminar roles

• Añadir y quitar roles de miembros

• Llamar a cualquier endpoint JSON de Discord API v10 propio de etapa mediante herramientas de respaldo protegidas de lectura/escritura.

La capa de respaldo cubre moderación, baneos, timeouts, AutoMod, hilos, reacciones, emojis, stickers, eventos programados, onboarding, soundboard, permisos, webhooks gestionados por el bot y nuevos endpoints REST de servidor sin esperar una actualización del plugin.

Discord sigue imponiendo los permisos del bot, los intents habilitados y la jerarquía de roles. Las herramientas destructivas requieren un token de confirmación específico para el destino. Toda escritura genérica se previsualiza y necesita un token de confirmación vinculado a la petición antes de ejecutarse.

Preparación

1. En el Portal para desarrolladores de Discord, crea una aplicación y añade un bot.

2. Restablece o copia el token del bot. Nunca lo pegues en el chat ni lo guardes en esta carpeta de plugin.

3. Ejecuta PowerShell y luego ejecuta:

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

   El script solicita el token de forma segura y, opcionalmente, una lista de IDs de servidores permitidos separados por comas. Guarda los valores en tu entorno de usuario de Windows para que Codex pueda dirigirlos al proceso MCP.

4. Reinicia la aplicación de escritorio de Codex después de la configuración.

5. Instala o habilita Discord MCP desde el marketplace personal y comienza una nueva tarea.

6. Pregunta: «Comprueba el estado de mi bot de Discord y dame su URL de invitación de administrador».

7. Abre la URL de invitación de administrador y autoriza el bot para el servidor previsto. El resultado del estado también incluye una alternativa de privilegios mínimos.

Para obtener un ID de servidor, activa el Modo de desarrollador en Discord, haz clic derecho en el servidor y elige Copiar ID del servidor. Es muy recomendable proporcionar DISCORD_ALLOWED_GUILD_IDS; el sistema rechaza todos los servidores que no estén en esa lista.

Instalación desde el código fuente

1. Clona este repositorio en el directorio de plugins local de Codex como discord-mcp.

2. Añade el plugin a un marketplace local de Codex o usa el manifiesto de plugins del repositorio con tu flujo de trabajo habitual.

3. Configura las credenciales del bot como se describe más adelante.

4. Instala o habilita Discord MCP, reinicia Codex y comienza una nueva tarea.

El manifiesto del plugin se encuentra en .codex-plugin/plugin.json y el servidor MCP está definido en .mcp.json.

Descargas de lanzamiento

Cada push a main que supera el conjunto de pruebas crea un GitHub Release con:

• Un archivo plugin con versión discord-mcp-vX.Y.Z-build.N.zip

• Un archivo de suma de verificación SHA-256 asociado

• Notas de la versión generadas automáticamente

El archivo se extrae a un directorio discord-mcp y se puede colocar directamente en el directorio de plugins local de Codex. La versión semántica proviene de package.json; el número de ejecución de GitHub Actions hace que cada compilación de main sea descargable por separado.

Configuración

• DISCORD_BOT_TOKEN (obligatorio): token del bot de Discord.

• DISCORD_ALLOWED_GUILD_IDS (recomendado): IDs de servidor separados por comas.

Ejecuta scripts/configure.ps1 -Clear para eliminar las dos variables de entorno de usuario.

En macOS o Linux, define las mismas variables en el entorno con el que estás iniciando Codex. Por ejemplo:

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

No uses valores reales en un archivo o en una tarea de Codex.

Acceso de administrador

discord_status ahora devuelve:

• administrator_invite_url, que solicitan el permiso ADMINISTRATOR de Discord (8)

• least_privilege_invite_url, que solicita únicamente los permisos habituales de gestión del plugin

• invite_url, que apunta a la invitación de administrador mientras escribimos

Para un bot que ya esté en el servidor, vuelve a autorizarlo con administrator_invite_url o activa Administrador en su rol de bot dentro de Configuración del servidor → Roles. Coloca el rol del bot por encima de todos los roles que deba gestionar. El Admin elude dichas loas, pero no sobre la jerarquía de roles y no puede actuar sobre el dueño del servidor.

Arquitectura

Codex se comunica con un servidor MCP local de Node.js sin dependencias através de stdio. El servidor MCP llama a Discord API v10 usando HTTPS con el token del bot. No escucha un puerto de red, no recibe mensajes de Discord ni requiere intents de gateway privilegiados.

Cobertura y límites

Las herramientas de seguridad soportan endpoints REST JSON del ámbito del servidor con GET, POST, PUT, PATCH y DELETE. Resuelven el servidor propietario a partir de rutas de servidor, canal, stage, stage, invitación o webhook autenticado por el bot antes de realizar la solicitud.

Este mal procesador local bajo demanda no implementa listeners de eventos de Discord Gateway, presencia persistente, streaming de voz/audio, callbacks de interacción que demanden token tokens temporales, flujos de usuario de OAuth, rutas de ejecución con token de webhook ni cargas de archivos multipart. Esas funciones requieres un runtime de bot separado y de ejecución continua o un flujo de subida propio. Las rutas y campos JSON con credenciales están bloquedos deliberados.

Notas de seguridad

• El administrador es extremadamente poderoso. Úsalo solo en servidores que controlas, mantenie activada la lista de servidores permitidos y protege el token del bot como si fuese una contraseña.

• Mantén la lista de servidores permitidos activada.

• Discord recibe los motivos del audit-log en los cambios compatibles.

• Las escrituras del rest en bruto están ligadas a su método, ruta, query, body y motivo de auditoría; modificar alguno de ellos invalida el token de confirmación.

• Los campos con credenciales se bloquean en los bodies de petición y se redactan de forma recursiva en las respuestas raw de la API.

• Si el token se ha expuesto, reinícialo en el Portal para desarrolladores de Discord lo antes posible.

Consulta SECURITY.md para obtener la guía de informes de vulnerabilidades.

Desarrollo

El servidor MCP no tiene dependencias de tiempo de ejecución. Ejecuta las comprobaciones locales y la prueba de humo del protocolo con:

npm test

La prueba de humo usa un token de prueba y no llama a Discord. Las pull request también se revisan con Github. Consulta CONTRIBUTING.md para las guías de contribución y CHANGELOG.md para el historial de versiones.

Licencia

El código fuente está disponible bajo la Licencia MIT. Los nombres, logotipos y marcas de terceros siguen siendo propiedad de sus respectivos titular.