Serveur MCP Slide

Une implémentation de serveur MCP qui s'intègre à l'API Slide, fournissant des capacités complètes de gestion des appareils et de l'infrastructure par le biais d'une architecture de méta-outils rationalisée.

🚀 Mise en œuvre de Go Binary ⚡

• Un seul binaire: Pas de dépendances, il suffit de télécharger et d'exécuter
• Démarrage rapide: temps de démarrage de ~50 ms avec chargement initial du contexte
• Faible utilisation de la mémoire: empreinte mémoire de 10 à 20 Mo
• Multiplateforme: Linux, macOS, binaires Windows
• Aucune difficulté d'installation: Téléchargement et configuration simples
• Interface simplifiée: 13 méta-outils au lieu de 52+ outils individuels pour une meilleure interaction avec LLM
• Performance améliorée: Le chargement initial du contexte élimine les délais du premier appel à l'API

Pour des instructions d'installation rapide avec Claude Desktop, voir la section d'installation ci-dessous.

🎯 Amélioration majeure de l'architecture

Conception des méta-outils: Ce serveur MCP utilise une architecture innovante de méta-outils qui consolide 52+ opérations API individuelles en seulement 13 méta-outils ciblés. Cette conception réduit considérablement la complexité pour les MCP tout en maintenant une fonctionnalité complète.

Chaque méta-outil accepte un paramètre d'opération qui spécifie l'action à effectuer, ainsi que les paramètres pertinents pour cette opération.

Exemple de schéma d'utilisation

{"name" : "slide_devices", "arguments" : { "operation" : "list", "limit" : 10, "client_id" : "client-123" } }

Méta-outils disponibles

🔧 Infrastructure de base

1. slide_devices - Gestion des périphériques physiques

   • Opérations : liste, obtention, mise à jour, mise hors tension, redémarrage
   • Contrôle de l'alimentation, mise à jour du nom de l'hôte/de l'affichage, affectation du client

2. slide_agents - Gestion des agents de sauvegarde

   • Opérations : liste, obtention, création, couplage, mise à jour
   • Création d'agents, couplage avec des appareils, gestion des noms d'affichage

3. slide_networks - Infrastructure du réseau

   • Opérations : lister, obtenir, créer, mettre à jour, supprimer
   • Création de réseaux avec DHCP, support VPN, isolation des clients
   • IPSec: create_ipsec, update_ipsec, delete_ipsec
   • Transfert de port: create_port_forward, update_port_forward, delete_port_forward
   • WireGuard VPN: create_wg_peer, update_wg_peer, delete_wg_peer

💾 Gestion des données

4. slide_backups - Opérations de sauvegarde

   • Opérations : liste, obtention, démarrage
   • Lancer et surveiller les travaux de sauvegarde

5. slide_snapshots - Gestion des instantanés

   • Opérations : lister, obtenir
   • Parcourir et accéder à des instantanés ponctuels avec un filtrage avancé

6. slide_restores - Restauration de fichiers et d'images

   • Restauration de fichiers: list_files, get_file, create_file, delete_file, browse_file
   • Exportation d'images: list_images, get_image, create_image, delete_image, browse_image
   • Prise en charge des formats de disque VHD, VHDX (dynamique/fixe) et Raw
   • Modifications de démarrage optionnelles (utilisateur admin sans mot de passe)

☁️ Infrastructure virtuelle

7. slide_vms - Gestion des machines virtuelles
   • Opérations : énumérer, obtenir, créer, mettre à jour, supprimer, obtenir un signet_rdp
   • Accès à la console VNC par navigateur et signets RDP téléchargeables
   • CPU (1-16 cœurs) et RAM (1-12GB) configurables
   • Plusieurs modes de réseau et types de bus de disque

administration

8. slide_user_management - Gestion des utilisateurs et des comptes

   • Utilisateurs: list_users, get_user - Informations sur les comptes d'utilisateurs et leurs autorisations
   • Comptes: list_accounts, get_account, update_account - Paramètres des comptes et configuration des courriels d'alerte
   • Clients: list_clients, get_client, create_client, update_client, delete_client - Organisation des clients et gestion des ressources

9. slide_alerts - Surveillance des alertes

   • Opérations : list, get, update (resolve)
   • Gestion et résolution des alertes système

📊 Présentation des données et rapports

10. slide_presentation - Formatage professionnel des données et documentation

    • Opérations: get_card, get_runbook_template, get_daily_report_template, get_monthly_report_template
    • Types de cartes: Cartes d'éléments individuels (agent, client, appareil, instantané) et cartes de table (table_agents, table_clients, etc.)
    • Modèles de rapport: Procédures du manuel d'exécution, résumés des activités quotidiennes, rapports d'analyse mensuels
    • Formats: Support HTML, Markdown, HAML pour des besoins de sortie multiples
    • Parfait pour les affichages d'état, les tableaux de bord, la documentation et les rapports professionnels
    • ⚠️DISABLED BY DEFAULT: Must be explicitly enabled with --enable-presentation flag or SLIDE_ENABLE_PRESENTATION=true⚠️ IMPORTANT: Si vous développez votre propre logique de présentation ou un formatage personnalisé, vous pouvez désactiver l'outil slide_presentation pour éviter les conflits avec votre implémentation personnalisée. Pour désactiver uniquement l'outil slide_presentation, ajoutez-le à la variable d'environnement DISABLED_TOOLS ou dans la partie --disabled-tools du CLI

11. slide_meta - Outils de méta pour les rapports et les vues de données agrégées

    • Opérations: list_all_clients_devices_and_agents, get_snapshot_changes, get_reporting_data
    • list_all_clients_devices_and_agents: Vue hiérarchique complète de l'infrastructure
    • get_snapshot_changes: Suivi des nouveaux instantanés et des instantanés supprimés sur des périodes de temps (jour, semaine, mois)
    • get_reporting_data: Données préformatées pour alimenter les modèles de rapport
    • Parfait pour générer des rapports avec des mesures précises et précalculées

12. slide_reports - Statistiques et rapports précalculés pour l'analyse des sauvegardes et des instantanés

    • ⚠️ DISABLED BY DEFAULT: Doit être explicitement activé avec l'option --enable-reports ou SLIDE_ENABLE_REPORTS=true
    • Opérations: daily_backup_snapshot, weekly_backup_snapshot, monthly_backup_snapshot
    • Rapports quotidiens: Statistiques d'une journée avec les taux de réussite des sauvegardes et les raisons des échecs
    • Rapports hebdomadaires: ventilation sur 7 jours avec le nombre d'agents par jour et les mesures de réussite
    • Rapports mensuels: Analyse d'un mois complet avec calendrier visuel (au format markdown)
    • Filtrage: Par identifiant d'agent, identifiant d'appareil ou identifiant de client pour des rapports ciblés
    • Formats: JSON (données structurées) ou Markdown (lisible par l'homme)
    • Performances: Utilisez le mode verbeux pour suivre la progression des rapports volumineux

13. slide_docs - Accès à la documentation officielle de Slide

    • Opérations: list_sections, get_topics, search_docs, get_content, get_api_reference
    • Accès à la documentation: Parcourir et rechercher directement le contenu de docs.slide.tech
    • Aide contextuelle: Obtenez les meilleures pratiques, des conseils de dépannage et des explications sur les fonctionnalités
    • Référence API: Accès rapide à la documentation sur les points de terminaison de l'API
    • Intégration: Complète d'autres outils en fournissant un contexte et des conseils

🔍 Outils spéciaux

• list_all_clients_devices_and_agents - Aperçu hiérarchique (fait désormais partie de slide_meta)
  • Obtenir une vue complète de tous les clients, de leurs appareils et de leurs agents en un seul appel
  • Parfait pour répondre aux questions sur l'échelle et l'organisation de l'infrastructure
  • Peut être appelé directement ou via slide_meta avec l'opération list_all_clients_devices_and_agents

Caractéristiques principales

gestion de l'infrastructure

• Contrôle des appareils: Opérations d'alimentation à distance, gestion des noms d'hôtes, affectation des clients
• Déploiement d'agents: Appariement automatisé, gestion des noms d'affichage
• Isolation du réseau: Réseaux spécifiques aux clients avec accès VPN
• Mise en réseau avancée: Tunnels IPSec, transfert de port, pairs WireGuard

protection et récupération des données

• Sauvegardes automatisées: Initiation et surveillance des sauvegardes basées sur des agents
• Récupération ponctuelle: Navigation dans les instantanés avec filtrage de l'emplacement
• Restaurations flexibles: Exportation d'images de fichiers et de disques complets
• Formats multiples: VHD, VHDX (dynamique/fixe), images disques brutes
• Modifications au démarrage: Création optionnelle d'un compte administrateur sans mot de passe

☁️ Virtualisation

• Création de VM: Création de VM à partir de n'importe quel snapshot
• Contrôle des ressources: Allocation configurable de CPU/RAM
• Intégration réseau: Connexion des machines virtuelles à des réseaux isolés
• Accès à la console: VNC basé sur un navigateur pour une interaction directe avec les machines virtuelles
• Signets RDP: Générer des fichiers .rdp téléchargeables pour faciliter l'accès au bureau à distance de Windows

📊 Surveillance et organisation

• Gestion des alertes: Surveillance et résolution centralisées des alertes
• Organisation des clients: Regroupement des ressources par client pour une meilleure gestion
• Gestion des utilisateurs: Accès aux comptes et autorisations
• Filtrage complet: Pagination et tri avancés dans toutes les ressources

📋 Présentation professionnelle des données

• Cartes à puce: Cartes individuelles et sous forme de tableau pour les agents, les clients, les appareils et les instantanés
• Modèles de rapports: Procédures d'exécution, résumés quotidiens et rapports d'analyse mensuels
• Formats multiples: Sortie HTML, Markdown et HAML pour différents cas d'utilisation
• Prêt pour le tableau de bord: Cartes préformatées parfaites pour l'affichage de l'état et le suivi
• Support de documentation: Modèles professionnels pour les procédures opérationnelles et le dépannage

Tous les méta-outils prennent en charge la pagination(limite, décalage) et les options de tri, le cas échéant.

guide de l'outil de présentation des données

L'outil de présentation des diapositives est votre principale ressource pour le formatage et la documentation professionnels des données. Il fournit des modèles préconstruits et des cartes à puce qui transforment les données brutes en formats polis et lisibles.

quand utiliser l'outil de présentation ?

Pensez toujours à cet outil en premier lieu lorsque vous devez :

• Afficher l'état du système ou les données de surveillance aux utilisateurs
• Afficher des listes d'éléments (agents, clients, périphériques, instantanés)
• Présenter les détails d'un élément individuel dans un format structuré
• Créer des rapports ou des résumés
• Générer de la documentation ou des procédures
• Mettre en forme toutes les données qui pourraient bénéficier d'une présentation professionnelle

📋 Modèles de rapport

Parfaits pour une documentation et une analyse complètes :

Modèles de Runbook(get_runbook_template)

• Objectif: Procédures opérationnelles, guides de dépannage, instructions étape par étape
• Cas d'utilisation: Réponse aux incidents, procédures de maintenance, guides de dépannage
• Formats: HTML, Markdown, HAML

Modèles de rapports quotidiens(get_daily_report_template)

• Objectif: Résumés d'activité, mises à jour d'état, rapports de fin de journée
• Cas d'utilisation: Résumés opérationnels quotidiens, briefings d'état, suivi des activités
• Formats: HTML (par défaut), Markdown, HAML

Modèles de rapports mensuels(get_monthly_report_template)

• Objectif: Analyse complète, tendances, résumés mensuels
• Cas d'utilisation: Résumés exécutifs, analyse des tendances, examens des performances
• Formats: HTML (par défaut), Markdown, HAML

📊 Cartes à puce

Parfaites pour les affichages d'état, les tableaux de bord et la visualisation de données :

Cartes à élément unique - Vues détaillées

• agent: Agent de sauvegarde individuel avec nom d'hôte, système d'exploitation, état, sauvegardes récentes
• client: Client individuel avec nom, nombre d'agents, affectations de périphériques, statistiques
• dispositif: Périphérique de sauvegarde individuel avec capacité, affectations, informations de stockage
• snapshot: Instantané de sauvegarde individuel avec date, taille, état, rétention

Cartes de tableaux - Tableaux de bord généraux

• agents_table: Comparaison de plusieurs agents avec vue d'ensemble de l'état et des affectations
• clients_table: Résumé de plusieurs clients avec le nombre d'agents et leur statut
• devices_table: Aperçu de plusieurs appareils avec capacité et utilisation
• snapshots_table: Historique chronologique des sauvegardes avec les tailles et l'état

guide de décision

Choisissez le bon format de présentation en fonction de vos besoins :

🚀 Meilleures pratiques

1. Commencez par la présentation: Pensez toujours à utiliser l'outil de présentation avant d'afficher les données brutes
2. Choisissez la bonne carte: Utilisez des cartes simples pour les détails, des cartes tableaux pour les vues d'ensemble
3. Formater en fonction de l'objectif: utiliser HTML pour les affichages sur le web, Markdown pour la documentation
4. Un résultat professionnel: Laissez l'outil gérer le formatage au lieu de le faire manuellement
5. Expérience cohérente: Utiliser des cartes pour une présentation cohérente dans tous les affichages de données

📦 Installation et configuration

Obtenir une clé API

1. Connectez-vous à votre compte Slide
2. Accédez aux paramètres de votre compte
3. Générez votre clé API à partir de la section API

🎯 Installation rapide avec Claude Desktop

🖥️ GUI Installer (recommandé)

Pour l'expérience d'installation la plus facile, utilisez notre installateur GUI multiplateforme avec intégration bureautique native :

macOS

1. Télécharger le programme d'installation: A partir de la dernière version

   • Apple Silicon (M1/M2/M3/M4): slide-mcp-installer-v2.3.2-darwin-arm64-signed.tar.gz
   • Intel Mac: slide-mcp-installer-v2.3.2-darwin-amd64-signed.tar.gz

2. Extrayez et exécutez:

   tar -xzf slide-mcp-installer-v2.3.2-darwin-[arch]-signed.tar.gz ouvrir slide-mcp-installer.app

3. Entrez votre cléAPI: entrez votre clé API Slide lorsque vous y êtes invité

4. Installez: Cliquez sur "Installer le serveur Slide MCP"

5. Redémarrez Claude Desktop: Le programme d'installation configurera tout automatiquement

Fenêtres

1. Télécharger le programme d'installation: A partir de la dernière version

   • 64-bit: slide-mcp-installer-v2.3.2-windows-amd64.zip

2. Extraire et exécuter:

   • Extraire le fichier ZIP
   • Exécutez slide-mcp-installer.exe

3. Saisissez votre clé API : Saisissez votre clé API Slide lorsque vous y êtes invité

4. Installez: Cliquez sur "Installer le serveur Slide MCP"

5. Redémarrez Claude Desktop: Le programme d'installation configurera tout automatiquement

Le programme d'installation de l'interface graphique fournit :

• ✅ Détection intelligente: Détecte automatiquement l'installation de Claude Desktop et les configurations existantes
• ✅ Intégration native: Un bundle .app approprié sur macOS avec prise en charge des icônes, pas de fenêtre de terminal
• téléchargement automatique: Récupère le dernier binaire slide-mcp-server pour votre plateforme
• installation intelligente: Installe au bon endroit avec les permissions adéquates
• gestion de la configuration: Met à jour la configuration de Claude Desktop de manière transparente
• ✅ Gestion des clés API: Affiche l'état actuel de la clé API et permet des mises à jour faciles
• ✅ S uivi de la progression: Barre de progression visuelle et mises à jour de l'état pendant l'installation
• désinstallation propre: Suppression complète du serveur et de la configuration si nécessaire
• multiplateforme: Disponible pour Windows, macOS (Intel & Apple Silicon) et Linux

Installation manuelle

Télécharger le binaire préconstruit (v2.3.2)

Pour macOS ARM64 (Apple Silicon) :

curl -L -o slide-mcp-server-v2.3.2-macos-arm64.tar.gz https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-macos-arm64.tar.gz tar -xzf slide-mcp-server-v2.3.2-macos-arm64.tar.gz chmod +x slide-mcp-server-v2.3.2-macos-arm64 mv slide-mcp-server-v2.3.2-macos-arm64 slide-mcp-server

Pour macOS x64:

curl -L -o slide-mcp-server-v2.3.2-macos-x64.tar.gz https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-macos-x64.tar.gz tar -xzf slide-mcp-server-v2.3.2-macos-x64.tar.gz chmod +x slide-mcp-server-v2.3.2-macos-x64 mv slide-mcp-server-v2.3.2-macos-x64 slide-mcp-server

Pour Linux x64:

curl -L -o slide-mcp-server-v2.3.2-linux-x64.tar.gz https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-linux-x64.tar.gz tar -xzf slide-mcp-server-v2.3.2-linux-x64.tar.gz chmod +x slide-mcp-server-v2.3.2-linux-x64 mv slide-mcp-server-v2.3.2-linux-x64 slide-mcp-server

Pour Linux ARM64:

curl -L -o slide-mcp-server-v2.3.2-linux-arm64.tar.gz https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-linux-arm64.tar.gz tar -xzf slide-mcp-server-v2.3.2-linux-arm64.tar.gz chmod +x slide-mcp-server-v2.3.2-linux-arm64 mv slide-mcp-server-v2.3.2-linux-arm64 slide-mcp-server

Pour Windows x64:

curl -L -o slide-mcp-server-v2.3.2-windows-x64.zip https://github.com/amcchord/slideMCP/releases/latest/download/slide-mcp-server-v2.3.2-windows-x64.zip unzip slide-mcp-server-v2.3.2-windows-x64.zip mv slide-mcp-server-v2.3.2-windows-x64.exe slide-mcp-server.exe

Construire à partir des sources

git clone https://github.com/austinmcchord/slide-mcp-server.git cd slide-mcp-server make build # Le binaire sera dans build/slide-mcp-server

Configuration du bureau Claude

Ajoutez ceci à votre fichier claude_desktop_config.json:

{ "mcpServers" : { "slide" : { "command" : "/path/to/slide-mcp-server", "env" : { "SLIDE_API_KEY" : "YOUR_API_KEY_HERE" } } } }

S'il est installé sur l'ensemble du système :

{ "mcpServers" : { "slide" : { "command" : "slide-mcp-server", "env" : { "SLIDE_API_KEY" : "YOUR_API_KEY_HERE" } } } }

Avec un mode de permission personnalisé et des outils désactivés :

{ "mcpServers" : { "slide" : { "command" : "/path/to/slide-mcp-server", "env" : { "SLIDE_API_KEY" : "YOUR_API_KEY_HERE", "SLIDE_TOOLS" : "reporting", "SLIDE_DISABLED_TOOLS" : "slide_accounts,slide_users" } } } }

Ou en utilisant des arguments CLI :

{ "mcpServers" : { "slide" : { "command" : "/path/to/slide-mcp-server", "args" : ["--api-key", "YOUR_API_KEY_HERE", "--tools", "full-safe", "--disabled-tools", "slide_agents,slide_backups" ] } } }

Testez votre installation

# Définissez votre clé API export SLIDE_API_KEY="your-api-key-here" # Testez le serveur echo '{"jsonrpc" : "2.0", "id":1, "method" : "initialize", "params":{}}' | ./slide-mcp-server # Devrait répondre avec des informations sur le serveur et ses capacités

arguments et configuration de la CLI

Le serveur Slide MCP prend en charge plusieurs arguments de ligne de commande pour une configuration flexible :

Arguments de ligne de commande

# Utilisation de base avec la clé API ./slide-mcp-server --api-key YOUR_API_KEY # Tous les drapeaux disponibles ./slide-mcp-server [OPTIONS]

Priorité: Les indicateurs CLI sont prioritaires sur les variables d'environnement.

Exemples

# ./slide-mcp-server --api-key sk_test_123 --base-url https://custom.api.endpoint --tools reporting # Utilisation des variables d'environnement export SLIDE_API_KEY="sk_test_123" export SLIDE_BASE_URL="https://custom.api.endpoint" 
export SLIDE_TOOLS="reporting" ./slide-mcp-server # Utilisation mixte (la CLI prévaut sur l'environnement) export SLIDE_TOOLS="full" ./slide-mcp-server --api-key sk_test_123 --tools reporting # Utilise le mode reporting # Désactive des outils spécifiques ./slide-mcp-server --api-key sk_test_123 --disabled-tools "slide_agents,slide_backups" # Active les outils de présentation et de rapports (désactivés par défaut) ./slide-mcp-server --api-key sk_test_123 --enable-presentation --enable-reports # Activer uniquement l'outil de présentation ./slide-mcp-server --api-key sk_test_123 --enable-presentation # Afficher la version ./slide-mcp-server --version # Sortie : slide-mcp-server version 2.3.2

🚫 Désactivation d'outils spécifiques

En plus des modes de permission, vous pouvez désactiver entièrement certains outils en utilisant l'option --disabled-tools ou la variable d'environnement SLIDE_DISABLED_TOOLS. Cela permet de contrôler finement les outils disponibles.

Exemples d'utilisation

# Désactiver des outils spécifiques via l'indicateur CLI ./slide-mcp-server --api-key YOUR_KEY --disabled-tools "slide_agents,slide_backups" # Désactiver des outils via la variable d'environnement export SLIDE_DISABLED_TOOLS="slide_devices,slide_users" ./slide-mcp-server --api-key YOUR_KEY # Combiné avec les modes de permission ./slide-mcp-server --api-key YOUR_KEY --tools reporting --disabled-tools "slide_snapshots" # L'espace blanc est géré de manière élégante ./slide-mcp-server --api-key YOUR_KEY --disabled-tools " slide_agents , slide_backups , slide_devices "

Noms des outils disponibles

• slide_agents - Gestion des agents
• slide_backups - Opérations de sauvegarde
• slide_snapshots - Gestion des instantanés
• slide_restores - Restauration de fichiers et d'images
• slide_networks - Gestion des réseaux
• slide_user_management - Gestion des utilisateurs et des comptes
• slide_alerts - Surveillance des alertes
• slide_devices - Gestion des périphériques
• slide_vms - Gestion des machines virtuelles
• slide_presentation - Présentation des données et rapports
• slide_meta - Méta-outils pour les rapports et les vues de données agrégées
• slide_reports - Statistiques et rapports précalculés sur les sauvegardes et les instantanés
• slide_docs - Accès à la documentation officielle de Slide
• list_all_clients_devices_and_agents - Aperçu hiérarchique (ancien, utiliser slide_meta à la place)

Caractéristiques principales

• Priorité: Les drapeaux de l'interface de programmation sont prioritaires sur les variables d'environnement
• Gestion des espaces: Les espaces supplémentaires autour des noms d'outils sont automatiquement supprimés
• Messages d'erreur: Effacement des messages d'erreur lors de l'utilisation d'outils désactivés
• Filtrage combiné: Fonctionne avec les modes d'autorisation pour un contrôle d'accès en couches
• Transparence: Consigne les outils désactivés au démarrage du serveur

Cas d'utilisation

# Créer un serveur en lecture seule qui ne peut pas accéder aux données sensibles ./slide-mcp-server --tools reporting --disabled-tools "slide_accounts,slide_users" # Autoriser les restaurations mais empêcher les changements de réseau ./slide-mcp-server --tools restores --disabled-tools "slide_networks" # Configuration de surveillance qui exclut la gestion des VM ./slide-mcp-server --tools reporting --disabled-tools "slide_vms,slide_networks"

Lorsqu'un outil désactivé est appelé, le serveur renvoie :

{"error" : {"code" : -32601, "message" : "Tool 'slide_agents' is disabled" } }

🎯 Activation des outils de présentation et de rapport

Les outils slide_presentation et slide_reports sont désactivés par défaut et doivent être explicitement activés à l'aide de drapeaux CLI ou de variables d'environnement. Cette conception permet d'éviter l'exposition accidentelle de fonctionnalités de reporting potentiellement sensibles.

Pourquoi ces outils sont-ils désactivés par défaut ?

• slide_presentation: Fournit des capacités avancées de formatage et de modélisation qui pourraient être utilisées à mauvais escient pour l'extraction de données ou la collecte d'informations sur le système
• slide_reports: Génère des rapports système complets qui peuvent contenir des données opérationnelles sensibles

Activation de ces outils

# Activer les deux outils via les drapeaux CLI ./slide-mcp-server --api-key YOUR_KEY --enable-presentation --enable-reports # Activer uniquement l'outil de présentation ./slide-mcp-server --api-key YOUR_KEY --enable-presentation # Activer uniquement l'outil de rapports ./slide-mcp-server --api-key YOUR_KEY --enable-reports # Activer via les variables d'environnement export SLIDE_ENABLE_PRESENTATION=true export SLIDE_ENABLE_REPORTS=true ./slide-mcp-server --api-key YOUR_KEY # Les drapeaux CLI ont la priorité sur les variables d'environnement export SLIDE_ENABLE_PRESENTATION=false ./slide-mcp-server --api-key YOUR_KEY --enable-presentation # L'outil de présentation sera activé

Combiné avec d'autres options

# Activer avec un mode d'outils spécifique ./slide-mcp-server --api-key YOUR_KEY --tools reporting --enable-presentation --enable-reports # Activer en désactivant d'autres outils ./slide-mcp-server --api-key YOUR_KEY --enable-reports --disabled-tools "slide_agents,slide_backups"

🔒 Modes de permission

Le serveur comprend un système de permission sophistiqué avec quatre niveaux d'accès distincts :

Niveaux de permission

reporting - Accès en lecture seule

Cas d'utilisation: Surveillance, rapports et intégrations de tableaux de bord

• autorisé: Toutes les opérations de lecture(liste, obtenir, parcourir)
• bloqué: Toutes les opérations de création, de mise à jour et de suppression
• bloqué: Opérations de contrôle de l'alimentation

./slide-mcp-server --api-key YOUR_KEY --tools reporting

restaurations - Récupération de données et gestion de VM

Cas d'utilisation: Équipes de support informatique effectuant la récupération des données et la gestion des machines virtuelles

• autorisé: Toutes les opérations de reporting
• ✅ Autorisé: Gestion des machines virtuelles (création, mise à jour, suppression)
• autorisé: Opérations de restauration de fichiers
• autorisé: Opérations d'exportation d'images
• ✅ Autorisé: Gestion du réseau
• autorisé: Gestion des appareils (mises à jour uniquement)
• autorisé: Gestion des agents (création, couplage, mise à jour)
• autorisé: Gestion des sauvegardes
• ❌ Bloqué: Contrôle de l'alimentation de l'appareil (arrêt, redémarrage)
• ❌ Bloqué: Gestion des comptes/clients
• bloqué: Résolution des alertes
• ❌ Bloqué: Suppression d'agents
• ❌ Bloqué: Suppression d'un instantané

./slide-mcp-server --api-key YOUR_KEY --tools restaurations

full-safe - Accès complet (par défaut)

Cas d'utilisation: Administration générale avec garde-fous de sécurité

• autorisé: Toutes les opérations sauf celles qui sont dangereuses
• bloqué: Suppression de l'agent (empêche l'interruption accidentelle des sauvegardes)
• ❌ Bloqué: Suppression d'un instantané (évite la perte de données)
• bloqué: Contrôle de l'alimentation de l'appareil (empêche les arrêts accidentels)

./slide-mcp-server --api-key YOUR_KEY --tools full-safe # OU simplement (mode par défaut) ./slide-mcp-server --api-key YOUR_KEY

full - Accès complet

Cas d'utilisation: Administrateurs avancés qui ont besoin d'un accès illimité

• autorisé: Toutes les opérations, y compris les opérations dangereuses
• ⚠️ Avertissement: Inclut la suppression d'agents et d'instantanés

./slide-mcp-server --api-key YOUR_KEY --tools full

Matrice des permissions

Recommandations en matière de sécurité

• Surveillance de la production: Utiliser le mode rapport pour les tableaux de bord et les systèmes de surveillance en lecture seule
• Équipes d'assistance: Utiliser le mode de restauration pour le personnel d'assistance informatique chargé de la récupération des données
• Administration générale: Utiliser le mode "full-safe" (par défaut) pour la plupart des tâches administratives
• Utilisateurs avancés uniquement: Utiliser le mode complet uniquement lorsque la suppression d'un agent ou d'un instantané est spécifiquement requise

Utilisation avec VS Code

Pour l'intégration dans VS Code, ajoutez le bloc JSON suivant à votre fichier User Settings (JSON). Pour ce faire, appuyez sur Ctrl + Shift + P et tapez Preferences : Ouvrir les paramètres de l'utilisateur (JSON).

Vous pouvez également l'ajouter à un fichier appelé .vscode/mcp.json dans votre espace de travail. Cela vous permettra de partager la configuration avec d'autres personnes.

Notez que la clé mcp n'est pas nécessaire dans le fichier .vscode/mcp.json.

{ "mcp" : {"inputs" : [ { "type" : "promptString", "id" : "slide_api_key", "description" : "Slide API Key", "password" : true } ], "servers" : { "slide" : { "command" : "/path/to/slide-mcp-server", "env" : { "SLIDE_API_KEY" : "${input:slide_api_key}" } } } } }

Avec une configuration personnalisée et des outils désactivés :

{ "mcp" : { "inputs" : [ { "type" : "promptString", "id" : "slide_api_key", "description" : "Slide API Key", "password" : true } ], "servers" : { "slide" : { "command" : "/path/to/slide-mcp-server", "env" : { "SLIDE_API_KEY" : "${input:slide_api_key}", "SLIDE_TOOLS" : "reporting", "SLIDE_DISABLED_TOOLS" : "slide_accounts,slide_users" } } } } }

💡 Exemples d'utilisation

Lister tous les appareils

{"name" : "slide_devices", "arguments" : {"operation" : "list", "limit" : 20, "client_id" : "client-123" } }

Créer un réseau avec VPN

{ "name" : "slide_networks", "arguments" : { "operation" : "create", "name" : "Réseau de développement", "type" : "standard", "router_prefix" : "192.168.100.1/24", "dhcp" : true, "dhcp_range_start" : "192.168.100.10", "dhcp_range_end" : "192.168.100.200", "wg" : true, "wg_prefix" : "10.100.0.0/24", "client_id" : "client-123" } }

Créer une VM à partir d'un instantané

{ "name" : "slide_vms", "arguments" : { "operation" : "create", "snapshot_id" : "snapshot-456", "device_id" : "device-789", "cpu_count" : 4, "memory_in_mb" : 8192, "network_type" : "network-id", "network_source" : "network-123" } }

Générer un signet RDP pour la VM

{ "name" : "slide_vms", "arguments" : { "operation" : "get_rdp_bookmark", "virt_id" : "vm-123" } }

Recherche de documentation

{ "name" : "slide_docs", "arguments" : { "operation" : "search_docs", "query" : "backup retention policies" } }

🆕 Nouveautés de la version 2.3.2

🚀 Amélioration des performances

• Chargement initial du contexte: Le serveur MCP charge les données de hiérarchie client/dispositif/agent au démarrage, ce qui élimine les délais typiques du premier appel API et permet un accès immédiat à la vue d'ensemble de l'infrastructure
• Temps de réponse plus rapides: Le contexte initial fournit une disponibilité instantanée des données du système pour une meilleure expérience utilisateur

🖥️ Gestion améliorée des machines virtuelles

• Génération de signets RDP: opération get_rdp_bookmark dans l'outil slide_vms
  • Génération de fichiers Windows Remote Desktop (.rdp) téléchargeables
  • Accès en un clic aux machines virtuelles via les clients RDP standard
  • Compatible avec Windows Remote Desktop, macOS Remote Desktop et d'autres clients RDP
  • Inclut des paramètres optimisés pour la compression, l'audio, le presse-papiers et l'affichage
  • Validation automatique de la disponibilité des points d'extrémité RDP
  • Suggestions de noms de fichiers conviviales et instructions d'utilisation claires

📚 Intégration de la documentation

• Accès intégré à la documentation: L'outil slide_docs permet d'accéder directement à la documentation officielle de Slide
• Aide contextuelle: Obtenez les meilleures pratiques, des conseils de dépannage et des informations de référence sur les API
• Capacités de recherche: Trouvez la documentation pertinente sans quitter votre client MCP
• Contexte amélioré: Accès amélioré à la documentation grâce à de meilleures capacités de navigation et de recherche

🛠️ Installation de l'interface graphique

• Interface graphique multiplateforme: Installateur de bureau natif pour Windows, macOS et Linux
• Détection intelligente: Détection automatique de l'installation de Claude Desktop et des configurations existantes
• Installation en un seul clic: Téléchargement, installation et configuration en un seul clic
• Gestion des clés API: Mise à jour facile des clés API et gestion de la configuration
• Désinstallation propre: Suppression complète du serveur et de la configuration en cas de besoin

Démarrer la tâche de sauvegarde

{"name" : "slide_backups", "arguments" : {"operation" : "start", "agent_id" : "agent-456" } }

Exporter l'instantané en tant qu'image VHD

{ "name" : "slide_restores", "arguments" : { "operation" : "create_image", "snapshot_id" : "snapshot-789", "device_id" : "device-123", "image_type" : "vhd-dynamic", "boot_remove_passwords" : true } }

Carte d'état de l'agent d'affichage

{ "name" : "slide_presentation", "arguments" : { "operation" : "get_card", "card_type" : "agent" } }

Générer une vue d'ensemble de plusieurs appareils

{ "name" : "slide_presentation", "arguments" : { "operation" : "get_card", "card_type" : "devices_table" } }

Créer un modèle de Runbook

{ "name" : "slide_presentation", "arguments" : { "operation" : "get_runbook_template", "format" : "markdown" } }

Générer un modèle de rapport quotidien

{ "name" : "slide_presentation", "arguments" : { "operation" : "get_daily_report_template", "format" : "html" } }

Générer des rapports de sauvegarde

{ "name" : "slide_reports", "arguments" : { "operation" : "daily_backup_snapshot", "agent_id" : "agent-123", "format" : "markdown" } }

Recherche de documentation

{ "name" : "slide_docs", "arguments" : { "operation" : "search_docs", "query" : "backup retention policies" } }

Système de documentation

Le serveur MCP comprend un système complet d'accès à la documentation grâce à l'outil slide_docs. Le système de documentation a été amélioré avec des descriptions contextuelles pour aider les MCP à faire de meilleurs choix lorsqu'ils naviguent entre des sections à la consonance similaire.

Fonctionnalités contextuelles améliorées

1. Descriptions des sections: Chaque section de la documentation comprend désormais une description détaillée expliquant son objectif

   • Exemple : "Slide Console > Networks" est clarifié en tant que "gestion des réseaux virtuels sur les appareils Slide/cloud"
   • Exemple : "Product > Networking" est clarifié comme étant "network infrastructure requirements and prerequisites" (exigences et conditions préalables en matière d'infrastructure réseau)

2. Descriptions des sujets: Les noms de sujets ambigus incluent des descriptions contextuelles

   • Des sujets tels que "Réseaux (gestion des réseaux)" et "Réseaux (exigences)" sont clairement différenciés

3. Recherche contextuelle: Les résultats de la recherche incluent des descriptions de sections et de sujets pour aider à identifier la documentation correcte

4. Navigation améliorée: Le LLM peut désormais mieux faire la distinction entre :

   • La documentation relative à la configuration par rapport à celle relative aux exigences
   • Fonctionnalités de l'interface utilisateur de la console et prérequis du système
   • Gestion des utilisateurs vs gestion de l'organisation du client

Test du contexte de la documentation

Exécutez le script de test pour vérifier les améliorations du contexte :

./test_scripts/test_docs_context.sh

Construire

# Construire pour la plateforme actuelle make build # Construire pour toutes les plateformes make build-all # Créer des paquets release make release # Voir les commandes disponibles make help

Avantages de l'architecture

Pour les LLM

• Complexité réduite: 14 méta-outils contre 52+ outils individuels
• Regroupement logique: Opérations connexes organisées ensemble
• Interface cohérente: Tous les méta-outils suivent le même modèle d'opération
• Meilleur contexte: Moins de changement d'outil, des conversations plus ciblées

Pour les développeurs

• Maintenable: Chaque méta-outil dans son propre fichier
• Extensible: Facilité d'ajout de nouvelles opérations aux catégories existantes
• Rétrocompatible: Toutes les fonctionnalités d'origine sont préservées
• Validation du schéma: Validation conditionnelle des paramètres par opération

Licence

Ce serveur MCP est placé sous licence MIT. Cela signifie que vous êtes libre d'utiliser, de modifier et de distribuer le logiciel, sous réserve des termes et conditions de la licence MIT. Pour plus de détails, veuillez consulter le fichier LICENSE dans le référentiel du projet.