MCP Relay

Un servidor de retransmisión de Discord para enviar mensajes y avisos a un canal y recibir respuestas.

Documentación

MCP Relay

Este servidor MCP permite que Claude envíe mensajes y prompts a un canal de Discord y reciba respuestas.

Instrucciones de configuración

1. Crear una aplicación y un bot de Discord

  1. Ve al Portal de desarrolladores de Discord
  2. Haz clic en "New Application" y asígnale un nombre
  3. Ve a la sección "Bot" en la barra lateral izquierda
  4. En la sección del token del bot, haz clic en "Reset Token" y copia el nuevo token
    • ¡Mantén este token seguro! No lo compartas públicamente
  5. En "Privileged Gateway Intents", habilita:
    • Message Content Intent
    • Server Members Intent
    • Presence Intent

2. Invita el bot a tu servidor

  1. Ve a la sección "OAuth2" en la barra lateral izquierda
  2. Selecciona "URL Generator"
  3. En "Scopes", selecciona:
    • bot
    • applications.commands
  4. En "Bot Permissions", selecciona:
    • Send Messages
    • Embed Links
    • Read Message History
  5. Copia la URL generada y ábrela en tu navegador
  6. Selecciona tu servidor y autoriza el bot

3. Obtener el ID del canal

  1. En Discord, activa el Modo desarrollador:
    • Ve a Configuración de usuario > Configuración de la aplicación > Avanzado
    • Activa "Developer Mode"
  2. Haz clic derecho en el canal que quieras usar
  3. Haz clic en "Copy Channel ID"

4. Configurar los ajustes de MCP

El servidor requiere configuración en tu archivo de ajustes de MCP. Añade lo siguiente a tu archivo de configuración:

{
    "mcpServers": {
        "discord-relay": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/MCP Relay/build/index.js"
            ],
            "env": {
                "DISCORD_TOKEN": "your_bot_token_here",
                "DISCORD_CHANNEL_ID": "your_channel_id_here"
            }
        }
    }
}

Reemplaza:

  • /ABSOLUTE/PATH/TO/MCP Relay con la ruta real a tu proyecto MCP Relay
  • your_bot_token_here con el token de tu bot de Discord
  • your_channel_id_here con el ID de tu canal de Discord

Nota: Asegúrate de usar rutas absolutas en la configuración.

Uso

El servidor proporciona una herramienta llamada send-message que acepta los siguientes parámetros:

{
  type: 'prompt' | 'notification',  // Type of message
  title: string,                    // Message title
  content: string,                  // Message content
  actions?: Array<{                 // Optional action buttons
    label: string,                  // Button label
    value: string                   // Value returned when clicked
  }>,
  timeout?: number                  // Optional timeout in milliseconds
}

Tipos de mensaje

  1. Notification: Mensaje simple que no espera una respuesta

    {
      "type": "notification",
      "title": "Hello",
      "content": "This is a notification"
    }
    
  2. Prompt: Mensaje que espera una respuesta

    {
      "type": "prompt",
      "title": "Question",
      "content": "Do you want to proceed?",
      "actions": [
        { "label": "Yes", "value": "yes" },
        { "label": "No", "value": "no" }
      ],
      "timeout": 60000  // Optional: 1 minute timeout
    }
    

Notas:

  • Los prompts pueden responderse haciendo clic en los botones de acción o enviando un mensaje de texto
  • Solo se acepta una respuesta por prompt
  • Si se especifica un tiempo de espera, el prompt fallará después de ese período
  • Las notificaciones no esperan respuestas y regresan inmediatamente