MCP Relay

Um servidor de retransmissão do Discord para enviar mensagens e prompts para um canal e receber respostas.

Documentação

MCP Relay

Este servidor MCP permite que o Claude envie mensagens e prompts para um canal do Discord e receba respostas.

Instruções de Configuração

1. Criar um Aplicativo e Bot no Discord

  1. Acesse o Portal de Desenvolvedores do Discord
  2. Clique em "New Application" e dê um nome a ele
  3. Vá para a seção "Bot" na barra lateral esquerda
  4. Na seção do token do bot, clique em "Reset Token" e copie o novo token
    • Mantenha este token seguro! Não o compartilhe publicamente
  5. Em "Privileged Gateway Intents", habilite:
    • Message Content Intent
    • Server Members Intent
    • Presence Intent

2. Convidar o Bot para o Seu Servidor

  1. Vá para a seção "OAuth2" na barra lateral esquerda
  2. Selecione "URL Generator"
  3. Em "Scopes", selecione:
    • bot
    • applications.commands
  4. Em "Bot Permissions", selecione:
    • Send Messages
    • Embed Links
    • Read Message History
  5. Copie a URL gerada e abra-a no seu navegador
  6. Selecione o seu servidor e autorize o bot

3. Obter o ID do Canal

  1. No Discord, ative o Modo de Desenvolvedor:
    • Vá para Configurações do Usuário > Configurações do Aplicativo > Avançado
    • Ative o "Modo de Desenvolvedor"
  2. Clique com o botão direito no canal que deseja usar
  3. Clique em "Copiar ID do Canal"

4. Configurar as Configurações do MCP

O servidor requer configuração no seu arquivo de configurações do MCP. Adicione o seguinte ao seu arquivo de configuração:

{
    "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"
            }
        }
    }
}

Substitua:

  • /ABSOLUTE/PATH/TO/MCP Relay pelo caminho real para o seu projeto MCP Relay
  • your_bot_token_here pelo token do seu bot do Discord
  • your_channel_id_here pelo ID do seu canal do Discord

Observação: Certifique-se de usar caminhos absolutos na configuração.

Uso

O servidor fornece uma ferramenta chamada send-message que aceita os seguintes 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 Mensagem

  1. Notificação: Mensagem simples que não espera uma resposta

    {
      "type": "notification",
      "title": "Hello",
      "content": "This is a notification"
    }
    
  2. Prompt: Mensagem que aguarda uma resposta

    {
      "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
    }
    

Observações:

  • Os prompts podem ser respondidos clicando nos botões de ação ou enviando uma mensagem de texto
  • Apenas uma resposta é aceita por prompt
  • Se um tempo limite for especificado, o prompt falhará após o período de tempo limite
  • As notificações não aguardam respostas e retornam imediatamente