📚 Documentation

⚡ Installation

SYNOLOGY_URL=https://nas.exemple.com:5001 \
SYNOLOGY_USERNAME=votre_user \
SYNOLOGY_PASSWORD=votre_pass \
npx @clawbow/synology-mcp-drive

# Installer un package spécifique
npm install -g @clawbow/synology-mcp-drive

# Ou tous les packages
npm install -g @clawbow/synology-mcp-drive @clawbow/synology-mcp-chat @clawbow/synology-mcp-photos

💜 Claude Desktop

Éditez votre fichier de configuration Claude Desktop :

# Mac
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Ajoutez la configuration MCP :

{
  "mcpServers": {
    "synology-drive": {
      "command": "npx",
      "args": ["-y", "@clawbow/synology-mcp-drive"],
      "env": {
        "SYNOLOGY_URL": "https://votre-nas.com:5001",
        "SYNOLOGY_USERNAME": "votre_user",
        "SYNOLOGY_PASSWORD": "votre_pass"
      }
    },
    "synology-chat": {
      "command": "npx",
      "args": ["-y", "@clawbow/synology-mcp-chat"],
      "env": {
        "SYNOLOGY_URL": "https://votre-nas.com:5001",
        "SYNOLOGY_USERNAME": "votre_user",
        "SYNOLOGY_PASSWORD": "votre_pass"
      }
    }
  }
}

💚 ChatGPT (Apps MCP)

🧡 Mistral Le Chat

Mistral Le Chat supporte les connecteurs MCP via HTTP/SSE. Déployez votre serveur et ajoutez-le dans Settings → Connectors → Add custom connector.

⚙️ Configuration

Variables d'environnement

🔐 Authentification

Les packages utilisent l'API d'authentification DSM standard (SYNO.API.Auth). La session est maintenue pendant toute la durée d'exécution.

Recommandations sécurité

• Créez un compte DSM dédié avec des droits limités
• N'utilisez pas le compte admin principal
• Activez le 2FA sur les comptes sensibles
• Utilisez un certificat SSL valide (ou Tailscale)
• Stockez les credentials dans des variables d'env, pas en dur