# claudeindd

Bot Discord auto-hébergé qui expose le contrôle complet d'un serveur Discord (salons, rôles, membres, permissions, messages) sous forme d'outils MCP, pour qu'un client IA (Claude Desktop, Claude Code, etc.) puisse piloter le serveur.

## Setup

1. Copier `.env.example` en `.env` et renseigner `DISCORD_TOKEN` (token du bot, depuis le [Discord Developer Portal](https://discord.com/developers/applications)).
2. Inviter le bot sur le serveur avec les permissions nécessaires (scope `bot`, permission `Administrator` recommandé vu l'étendue des actions).
3. Activer les **Privileged Gateway Intents** suivants dans le portail développeur : `SERVER MEMBERS INTENT` et `MESSAGE CONTENT INTENT`.
4. Double-cliquer **`start.bat`**. Il installe les dépendances si besoin, connecte le bot Discord, puis démarre le serveur MCP. Fermer la fenêtre arrête tout (bot + serveur MCP).

La fenêtre affiche l'URL du serveur MCP une fois prêt : `http://localhost:3939/mcp` (port configurable via la variable d'environnement `MCP_PORT`).

## Connecter un client MCP

Le serveur tourne en **Streamable HTTP** (pas en stdio) : lance `start.bat` d'abord, puis connecte ton client à l'URL affichée. Dans Claude Desktop (`claude_desktop_config.json`) :

```json
{
  "mcpServers": {
    "claudeindd": {
      "url": "http://localhost:3939/mcp"
    }
  }
}
```

Le serveur n'est pas exposé à l'extérieur de ta machine (localhost uniquement).

## Outils MCP disponibles (48)

- **Messages** : `discord_send_message`, `discord_send_file` (zip, images, documents — jusqu'à 10 fichiers, 25MB chacun, contenu en base64), `discord_read_messages`, `discord_edit_message`, `discord_delete_message`, `discord_bulk_delete_messages`, `discord_pin_message`, `discord_unpin_message`, `discord_list_pinned_messages`, `discord_add_reaction`, `discord_remove_reaction`
- **Salons** : `discord_list_channels`, `discord_create_channel`, `discord_delete_channel`, `discord_edit_channel` (nom, topic, catégorie/déplacement, position, NSFW, slowmode, bitrate, limite d'utilisateurs vocaux)
- **Threads** : `discord_create_thread`, `discord_list_active_threads`, `discord_archive_thread`
- **Membres** : `discord_list_members`, `discord_kick_member`, `discord_ban_member`, `discord_unban_member`, `discord_timeout_member`, `discord_edit_member` (surnom, mute/deaf vocal, déplacement vocal)
- **Rôles** : `discord_list_roles`, `discord_create_role` (nom, couleur, permissions, icône/emoji), `discord_delete_role`, `discord_edit_role` (idem création), `discord_set_role_position` (hiérarchie), `discord_add_role_to_member`, `discord_remove_role_from_member`
- **Permissions** : `discord_set_channel_permission_overwrite`, `discord_remove_channel_permission_overwrite`, `discord_get_channel_permissions`
- **Emojis** : `discord_list_emojis`, `discord_create_emoji`, `discord_delete_emoji`
- **Invitations** : `discord_create_invite`, `discord_list_invites`, `discord_delete_invite`
- **Webhooks** : `discord_create_webhook`, `discord_list_webhooks`, `discord_delete_webhook`, `discord_send_webhook_message`
- **Serveur** : `discord_get_guild_info`, `discord_edit_guild` (nom, description, icône, niveau de vérification), `discord_get_audit_log`, `discord_set_bot_presence` (statut/activité du bot)

## Scripts de maintenance

`scripts/backup-guild.js` sauvegarde la structure d'un serveur (rôles, salons, permissions, emojis — pas les messages) vers un second serveur, en y recréant/mettant à jour tout (chaque salon reçoit l'ID d'origine dans sa description). Ré-exécutable sans dupliquer (garde une correspondance locale dans `scripts/.backup-maps/`, non commitée).

```
node scripts/backup-guild.js <realGuildId> <backupGuildId>              # exporter/rafraîchir la backup
node scripts/backup-guild.js <realGuildId> <backupGuildId> --restore    # restaurer depuis la backup
```

Le bot doit être présent sur les deux serveurs, avec son propre rôle placé au-dessus des rôles synchronisés (sinon le tri des rôles échoue silencieusement). `--restore` ne recrée jamais un rôle/salon supprimé depuis la backup — il ne fait que mettre à jour ce qui existe encore sur le serveur réel, pour rester une opération sans risque.

## Sécurité

Ce bot donne un accès total et sans confirmation au serveur Discord connecté (bannissement, suppression de salons, modification de permissions...). Le token dans `.env` ne doit jamais être commité ni partagé. Le degré de confiance accordé au client IA connecté doit être équivalent à celui d'un administrateur du serveur.