Servidor MCP de Slide

Una implementación de servidor MCP que se integra con la API de Slide, proporcionando capacidades integrales de gestión de dispositivos e infraestructuras a través de una arquitectura de metaherramientas optimizada.

🚀 Implementación binaria Go ⚡

• Un único binario: Sin dependencias, solo descargar y ejecutar
• Arranque rápido: tiempo de arranque de ~50ms con carga de contexto inicial
• Bajo uso de memoria: 10-20 MB de memoria
• Multiplataforma: Binarios para Linux, macOS y Windows
• Instalación sencilla: Descarga y configuración sencillas
• Interfaz simplificada: 13 metaherramientas en lugar de más de 52 herramientas individuales para una mejor interacción con LLM
• Rendimiento mejorado: La carga inicial del contexto elimina los retrasos de la primera llamada a la API

Para obtener instrucciones de configuración rápida con Claude Desktop, consulte la sección de instalación a continuación.

importante mejora de la arquitectura

Diseño Meta-Tools: Este servidor MCP utiliza una innovadora arquitectura de metaherramientas que consolida más de 52 operaciones de API individuales en solo 13 metaherramientas enfocadas. Este diseño reduce significativamente la complejidad para los LLM, manteniendo al mismo tiempo una funcionalidad completa.

Cada metaherramienta acepta un parámetro de operación que especifica la acción a realizar, junto con los parámetros relevantes para esa operación.

Ejemplo de patrón de uso

{ "nombre": "slide_devices", "arguments": { "operación": "list", "limit": 10, "client_id": "client-123" } }

Metaherramientas disponibles

infraestructura básica

1. slide_devices - Gestión de dispositivos físicos

   • Operaciones: listar, obtener, actualizar, apagar, reiniciar
   • Control de energía, actualizaciones de nombre de host/nombre de pantalla, asignación de clientes

2. slide_agents - Gestión de agentes de copia de seguridad

   • Operaciones: listar, obtener, crear, emparejar, actualizar
   • Creación de agentes, emparejamiento con dispositivos, gestión de nombres de pantalla

3. slide_networks - Infraestructura de red

   • Operaciones: listar, obtener, crear, actualizar, eliminar
   • Creación de redes con DHCP, soporte VPN, aislamiento de clientes
   • IPSec: create_ipsec, update_ipsec, delete_ipsec
   • Reenvío de puertos: create_port_forward, update_port_forward, delete_port_forward
   • WireGuard VPN: crear_wg_peer, actualizar_wg_peer, eliminar_wg_peer

💾 Gestión de datos

4. slide_backups - Operaciones de copia de seguridad

   • Operaciones: listar, obtener, iniciar
   • Iniciar y supervisar trabajos de copia de seguridad

5. slide_snapshots - Gestión de instantáneas

   • Operaciones: listar, obtener
   • Examinar y acceder a instantáneas puntuales con filtrado avanzado

6. slide_restores - Restauración de archivos e imágenes

   • Restauración de archivos: list_files, get_file, create_file, delete_file, browse_file
   • Exportación de imágenes: list_images, get_image, create_image, delete_image, browse_image
   • Compatibilidad con formatos de disco VHD, VHDX (dinámico/fijo) y Raw
   • Modificaciones de arranque opcionales (usuario administrador sin contraseña)

☁️ Infraestructura virtual

7. slide_vms - Gestión de máquinas virtuales
   • Operaciones: listar, obtener, crear, actualizar, eliminar, get_rdp_bookmark
   • Acceso a consola VNC basado en navegador y marcadores RDP descargables
   • CPU (1-16 núcleos) y RAM (1-12 GB) configurables
   • Múltiples modos de red y tipos de bus de disco

👥 Administración

8. slide_user_management - Gestión de usuarios y cuentas

   • Usuarios: list_users, get_user - Información y permisos de cuentas de usuario
   • Cuentas: list_accounts, get_account, update_account - Configuración de cuentas y del correo electrónico de alerta
   • Clientes: list_clients, get_client, create_client, update_client, delete_client - Organización de clientes y gestión de recursos

9. slide_alerts - Supervisión de alertas

   • Operaciones: listar, obtener, actualizar (resolver)
   • Gestión y resolución de alertas del sistema

📊 Presentación de datos e informes

10. slide_presentation - Formateo y documentación profesional de los datos

    • Operaciones: get_card, get_runbook_template, get_daily_report_template, get_monthly_report_template
    • Tipos de tarjetas: Tarjetas de elementos individuales (agente, cliente, dispositivo, instantánea) y tarjetas de tabla (agents_table, clients_table, etc.)
    • Plantillas de informes: Procedimientos del libro de ejecución, resúmenes de actividad diaria, informes de análisis mensuales
    • Formatos: HTML, Markdown, soporte HAML para múltiples necesidades de salida
    • Perfecto para visualizaciones de estado, cuadros de mando, documentación e informes profesionales
    • ⚠️ DESHABILITADO POR DEFECTO: Debe habilitarse explícitamente con --enable-presentation flag o SLIDE_ENABLE_PRESENTATION=true⚠️ IMPORTANTE: Si está creando su propia lógica de presentación o formato personalizado, puede que desee deshabilitar la herramienta slide_presentation para evitar conflictos con su implementación personalizada. Para desactivar sólo la herramienta slide_presentation, añádala a la variable de entorno DISABLED_TOOLS o en la parte --disabled-tools de la CLI

11. slide_meta - Metaherramientas para informes y vistas de datos agregados

    • Operaciones: list_all_clients_devices_and_agents, get_snapshot_changes, get_reporting_data
    • list_all_clients_devices_and_agents: Vista jerárquica completa de la infraestructura
    • get_snapshot_changes: Seguimiento de instantáneas nuevas y eliminadas durante periodos de tiempo (día, semana, mes)
    • get_reporting_data: Datos preformateados para rellenar plantillas de informes
    • Perfecto para generar informes con métricas precisas y precalculadas

12. slide_reports: estadísticas e informes precalculados para el análisis de copias de seguridad/instantáneas

    • ⚠️ DESHABILITADO POR DEFECTO: Debe habilitarse explícitamente con --enable-reports flag o SLIDE_ENABLE_REPORTS=true
    • Operaciones: daily_backup_snapshot, weekly_backup_snapshot, monthly_backup_snapshot
    • Informes diarios: Estadísticas de un solo día con los porcentajes de éxito de las copias de seguridad y los motivos de los fallos
    • Informes semanales: desglose de 7 días con recuentos diarios de agentes y métricas de éxito
    • Informes mensuales: Análisis de todo el mes con vista de calendario visual (en formato markdown)
    • Filtrado: Por agent_id, device_id o client_id para informes específicos
    • Formatos: JSON (datos estructurados) o Markdown (legible por humanos)
    • Rendimiento: Utilice el modo detallado para realizar un seguimiento del progreso de los informes de gran tamaño

13. slide_docs - Acceso a la documentación oficial de Slide

    • Operaciones: list_sections, get_topics, search_docs, get_content, get_api_reference
    • Acceso a la documentación: Navegue y busque directamente en el contenido de docs.slide.tech
    • Ayuda contextual: Obtenga prácticas recomendadas, orientación para la resolución de problemas y explicaciones de funciones
    • Referencia API: Acceso rápido a la documentación de los extremos de la API
    • Integración: Complementa otras herramientas proporcionando contexto y orientación

herramientas especiales

• list_all_clients_devices_and_agents - Visión general jerárquica (ahora parte de slide_meta)
  • Obtenga una vista completa de todos los clientes, sus dispositivos y agentes en una sola llamada
  • Perfecto para responder a preguntas sobre la escala y la organización de la infraestructura
  • Se puede llamar directamente o a través de slide_meta con la operación list_all_clients_devices_and_agents

Características principales

gestión de infraestructuras

• Control de dispositivos: Operaciones remotas de alimentación, gestión de nombres de host, asignación de clientes
• Despliegue de agentes: Emparejamiento automatizado, gestión de nombres de pantalla
• Aislamiento de redes: Redes específicas de cliente con acceso VPN
• Redes avanzadas: Túneles IPSec, reenvío de puertos, pares WireGuard

protección y recuperación de datos

• Copias de seguridad automatizadas: Iniciación y supervisión de copias de seguridad basadas en agentes
• Recuperación puntual: Exploración de instantáneas con filtrado de ubicaciones
• Restauraciones flexibles: Exportación de imágenes de disco completas y a nivel de archivo
• Múltiples formatos: VHD, VHDX (dinámico/fijo), imágenes de disco Raw
• Modificaciones de arranque: Creación opcional de cuenta de administrador sin contraseña

☁️ Virtualización

• Creación de máquinas virtuales: Creación de máquinas virtuales a partir de cualquier instantánea
• Control de recursos: Asignación configurable de CPU/RAM
• Integración en red: Conexión de máquinas virtuales a redes aisladas
• Acceso a la consola: VNC basado en navegador para la interacción directa con las máquinas virtuales
• Marcadores RDP: Genere archivos .rdp descargables para facilitar el acceso a Escritorio remoto de Windows

supervisión y organización

• Gestión de alertas: Supervisión y resolución de alertas centralizadas
• Organización de clientes: Agrupación de recursos por cliente para una mejor gestión
• Gestión de usuarios: Acceso a cuentas y permisos
• Filtrado exhaustivo: Paginación y ordenación avanzadas en todos los recursos

📋 Presentación profesional de datos

• Tarjetas inteligentes: Tarjetas individuales y basadas en tablas para agentes, clientes, dispositivos e instantáneas
• Plantillas de informes: Procedimientos de Runbook, resúmenes diarios e informes de análisis mensuales
• Múltiples formatos: Salida HTML, Markdown y HAML para diferentes casos de uso
• Preparado para panel de control: Tarjetas preformateadas perfectas para la visualización de estados y la supervisión
• Soporte de documentación: Plantillas profesionales para procedimientos operativos y resolución de problemas

Todas las metaherramientas admiten opciones de paginación(límite, desplazamiento) y ordenación cuando corresponda.

📊 Guía de herramientas de presentación de datos

La herramienta slide_presentation es su principal recurso para el formateo profesional de datos y documentación. Proporciona plantillas preconstruidas y tarjetas inteligentes que transforman los datos sin procesar en formatos pulidos y legibles.

cuándo utilizar la herramienta de presentación

Considere siempre esta herramienta en primer lugar cuando necesite:

• Mostrar el estado del sistema o datos de supervisión a los usuarios
• Mostrar listas de elementos (agentes, clientes, dispositivos, instantáneas)
• Presentar detalles de elementos individuales en un formato estructurado
• Crear informes o resúmenes
• Generar documentación o procedimientos
• Dar formato a cualquier dato que pueda beneficiarse de una presentación profesional

plantillas de informes

Perfectas para documentación y análisis exhaustivos:

Plantillas de Runbook(get_runbook_template)

• Propósito: Procedimientos operativos, guías de solución de problemas, instrucciones paso a paso
• Casos prácticos: Respuesta a incidentes, procedimientos de mantenimiento, guías de solución de problemas
• Formatos: HTML, Markdown, HAML

Plantillas de informes diarios(get_daily_report_template)

• Propósito: Resúmenes de actividades, actualizaciones de estado, informes al final del día
• Casos prácticos: Resúmenes operativos diarios, informes de estado, seguimiento de actividades
• Formatos: HTML (por defecto), Markdown, HAML

Plantillas de informes mensuales(get_monthly_report_template)

• Finalidad: Análisis exhaustivos, tendencias, resúmenes mensuales
• Casos prácticos: Resúmenes ejecutivos, análisis de tendencias, revisiones de rendimiento
• Formatos: HTML (por defecto), Markdown, HAML

tarjetas inteligentes

Perfectas para visualizaciones de estado, cuadros de mando y visualización de datos:

Tarjetas de un solo elemento - Vistas detalladas

• agente: Agente de copia de seguridad individual con nombre de host, SO, estado, copias de seguridad recientes
• cliente: Cliente individual con nombre, recuento de agentes, asignaciones de dispositivos, estadísticas
• dispositivo: Dispositivo de copia de seguridad individual con capacidad, asignaciones, información de almacenamiento
• instantánea: Instantánea de copia de seguridad individual con fecha, tamaño, estado, retención

Fichas de tablas - Tableros generales

• tabla_agentes: Comparación de varios agentes con resumen de estado y asignaciones
• tabla_clientes: Resumen de múltiples clientes con recuento de agentes y estado
• tabla_dispositivos: Resumen de múltiples dispositivos con capacidad y utilización
• snapshots_table: Historial cronológico de copias de seguridad con tamaños y estado

💡 Guía de decisiones

Elija el formato de presentación adecuado en función de sus necesidades:

🚀 Buenas prácticas

1. Comience con la presentación: Considera siempre el uso de la herramienta de presentación antes de mostrar los datos sin procesar
2. Elija la tarjeta adecuada: Utilice tarjetas individuales para detalles, tarjetas de tabla para vistas generales
3. Formato para el propósito: Utilice HTML para visualizaciones web, Markdown para documentación
4. Resultados profesionales: Deje que la herramienta se encargue del formato en lugar de hacerlo manualmente
5. Experiencia coherente: Utilice tarjetas para una apariencia consistente en todas las visualizaciones de datos

instalación y configuración

Obtención de una clave API

1. Inicie sesión en su cuenta de Slide
2. Navegue hasta la configuración de su cuenta
3. Genere su clave de API desde la sección de API

🎯 Instalación rápida con Claude Desktop

🖥️ Instalador GUI (Recomendado)

Para la experiencia de instalación más fácil, utilice nuestro instalador GUI multiplataforma con integración nativa de escritorio:

macOS

1. Descargue el instalador: Desde la última versión

   • 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. Extraer y ejecutar:

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

3. Introduzca su clave API: Introduzca su clave API de Slide cuando se le solicite

4. Instalar: Haga clic en "Instalar Slide MCP Server"

5. Reinicie Claude Desktop: El instalador configurará todo automáticamente

Windows

1. Descargue el instalador: Desde la última versión

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

2. Extraer y ejecutar:

   • Extraiga el archivo ZIP
   • Ejecute slide-mcp-installer.exe

3. Introduzca su claveAPI: Introduzca su clave API de Slide cuando se le solicite

4. Instalar: Haga clic en "Instalar Slide MCP Server"

5. Reinicie Claude Desktop: El instalador configurará todo automáticamente

El instalador GUI proporciona:

• ✅ Detección Inteligente: Detecta automáticamente la instalación de Claude Desktop y las configuraciones existentes
• ✅ Integración nativa: Paquete .app adecuado en macOS con soporte de iconos, sin ventanas de terminal
• ✅ Descarga automática: Obtiene el último binario slide-mcp-server para su plataforma
• instalación inteligente: Instala en la ubicación correcta con los permisos adecuados
• gestión de la configuración: Actualiza la configuración de Claude Desktop sin problemas
• ✅ Gestión de claves API: Muestra el estado actual de la clave API y permite actualizarla fácilmente
• ✅ S eguimiento del progreso: Barra de progreso visual y actualizaciones de estado durante la instalación
• ✅ Desinstalación limpia: Eliminación completa del servidor y la configuración cuando sea necesario
• ✅ Multiplataforma: Disponible para Windows, macOS (Intel y Apple Silicon) y Linux

Instalación manual

Descargar binario preconstruido (v2.3.2)

Para 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

Para 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

Para 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

Para 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

Para 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

Compilar desde el código fuente

git clone https://github.com/austinmcchord/slide-mcp-server.git cd slide-mcp-server make build # El binario estará en build/slide-mcp-server

Configuración de Claude Desktop

Añade esto a tu claude_desktop_config.json:

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

Si se instala en todo el sistema:

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

Con modo de permiso personalizado y herramientas deshabilitadas:

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

O utilizando argumentos 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" ] } }

Pruebe su instalación

# Establece tu clave API export SLIDE_API_KEY="your-api-key-here" # Prueba el servidor echo '{"jsonrpc": "2.0", "id":1, "method": "initialize", "params":{}}' | ./slide-mcp-server # Debería responder con la información del servidor y sus capacidades

🔧 Argumentos CLI y Configuración

El Slide MCP Server soporta varios argumentos de línea de comandos para una configuración flexible:

Argumentos de línea de comandos

# Uso básico con clave API ./slide-mcp-server --api-key YOUR_API_KEY # Todas las banderas disponibles ./slide-mcp-server [OPTIONS]

Prioridad: Los indicadores de la CLI tienen prioridad sobre las variables de entorno.

Ejemplos

# Usando los indicadores de la CLI ./slide-mcp-server --api-key sk_test_123 --base-url https://custom.api.endpoint --tools reporting Usando variables de entorno export SLIDE_API_KEY="sk_test_123" export SLIDE_BASE_URL="https://custom.api.endpoint" 
export SLIDE_TOOLS="reporting" ./slide-mcp-server # Uso mixto (la CLI anula el entorno) export SLIDE_TOOLS="full" ./slide-mcp-server --api-key sk_test_123 --tools reporting # Utiliza el modo reporting # Deshabilita herramientas específicas ./slide-mcp-server --api-key sk_test_123 --disabled-tools "slide_agents,slide_backups" # Habilita las herramientas de presentación e informes (deshabilitadas por defecto) ./slide-mcp-server --api-key sk_test_123 --enable-presentation --enable-reports # Habilitar sólo la herramienta de presentación ./slide-mcp-server --api-key sk_test_123 --enable-presentation # Mostrar versión ./slide-mcp-server --version # Salida: slide-mcp-server versión 2.3.2

🚫 Desactivación de herramientas específicas

Además de los modos de permiso, puede desactivar herramientas específicas por completo utilizando el indicador --disabled-tools o la variable de entorno SLIDE_DISABLED_TOOLS. Esto proporciona un control preciso sobre qué herramientas están disponibles.

Ejemplos de uso

# Deshabilitar herramientas específicas mediante el indicador CLI ./slide-mcp-server --api-key YOUR_KEY --disabled-tools "slide_agents,slide_backups" # Deshabilitar herramientas mediante la variable de entorno export SLIDE_DISABLED_TOOLS="slide_devices,slide_users" ./slide-mcp-server --api-key YOUR_KEY # Combinado con modos de permiso ./slide-mcp-server --api-key YOUR_KEY --tools reporting --disabled-tools "slide_snapshots" # Los espacios en blanco se gestionan con elegancia ./slide-mcp-server --api-key YOUR_KEY --disabled-tools " slide_agents , slide_backups , slide_devices "

Nombres de herramientas disponibles

• slide_agents - Gestión de agentes
• slide_backups - Operaciones de copia de seguridad
• slide_snapshots - Gestión de instantáneas
• slide_restores - Restauración de archivos e imágenes
• slide_networks - Gestión de redes
• slide_user_management - Gestión de usuarios y cuentas
• slide_alerts - Supervisión de alertas
• slide_devices - Gestión de dispositivos
• slide_vms - Gestión de máquinas virtuales
• slide_presentation - Presentación de datos e informes
• slide_meta - Metaherramientas para informes y vistas de datos agregados
• slide_reports - Estadísticas e informes precalculados de copias de seguridad e instantáneas
• slide_docs - Acceso a la documentación oficial de Slide
• list_all_clients_devices_and_agents - Resumen jerárquico (heredado, utilice slide_meta en su lugar)

Características principales

• Precedencia: Los indicadores de la CLI tienen prioridad sobre las variables de entorno
• Manejo de espacios en blanco: Los espacios extra alrededor de los nombres de las herramientas se recortan automáticamente
• Mensajes de error: Borrar mensajes de error al intentar utilizar herramientas deshabilitadas
• Filtrado combinado: Funciona junto con los modos de permiso para un control de acceso por capas
• Transparencia: Registra qué herramientas están deshabilitadas al iniciar el servidor

Casos de uso

# Crear un servidor de sólo lectura que no pueda acceder a datos sensibles ./slide-mcp-server --tools reporting --disabled-tools "slide_accounts,slide_users" # Permitir restauraciones pero impedir cambios en la red ./slide-mcp-server --tools restorores --disabled-tools "slide_networks" # Configuración de monitorización que excluya la gestión de máquinas virtuales ./slide-mcp-server --tools reporting --disabled-tools "slide_vms,slide_networks"

Cuando se llama a una herramienta deshabilitada, el servidor devuelve:

{ "error": {"code": -32601, "message": "La herramienta 'slide_agents' está deshabilitada" } }

🎯 Habilitación de las herramientas de presentación e informes

Las herramientas slide_presentation y slide_reports están deshabilitadas por defecto y deben habilitarse explícitamente mediante flags CLI o variables de entorno. Este diseño evita la exposición accidental de capacidades de informes potencialmente sensibles.

Por qué estas herramientas están desactivadas por defecto

• slide_presentation: Proporciona funciones avanzadas de formato y plantillas que podrían utilizarse indebidamente para la extracción de datos o la recopilación de información del sistema
• slide_reports: Genera informes completos del sistema que pueden contener datos operativos confidenciales

Habilitación de estas herramientas

# Habilitar ambas herramientas mediante los indicadores de la CLI ./slide-mcp-server --api-key YOUR_KEY --enable-presentation --enable-reports Habilitar sólo la herramienta de presentación ./slide-mcp-server --api-key YOUR_KEY --enable-presentation Habilitar sólo la herramienta de informes ./slide-mcp-server --api-key YOUR_KEY --enable-reports # Habilitar a través de variables de entorno export SLIDE_ENABLE_PRESENTATION=true export SLIDE_ENABLE_REPORTS=true ./slide-mcp-server --api-key YOUR_KEY # Las opciones CLI tienen prioridad sobre las variables de entorno export SLIDE_ENABLE_PRESENTATION=false ./slide-mcp-server --api-key YOUR_KEY --enable-presentation # Se habilitará la herramienta de presentación

Combinado con otras opciones

# Habilitar con modo de herramientas específicas ./slide-mcp-server --api-key YOUR_KEY --tools reporting --enable-presentation --enable-reports # Habilitar mientras se deshabilitan otras herramientas ./slide-mcp-server --api-key YOUR_KEY --enable-reports --disabled-tools "slide_agents,slide_backups"

🔒 Modos de permisos

El servidor incluye un sofisticado sistema de permisos con cuatro niveles de acceso distintos:

Niveles de permiso

informes - Acceso de sólo lectura

Caso de uso: Supervisión, elaboración de informes e integraciones de cuadros de mando

• permitido: Todas las operaciones de lectura(listar, obtener, examinar)
• ❌ Bloqueado: Todas las operaciones de creación, actualización y supresión
• ❌ Bloqueado: Operaciones de control de potencia

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

restauraciones - Recuperación de datos y gestión de máquinas virtuales

Caso de uso: equipos de soporte de TI que realizan recuperación de datos y gestión de máquinas virtuales

• permitido: Todas las operaciones de generación de informes
• permitidas: Gestión de máquinas virtuales (crear, actualizar, eliminar)
• ✅ Permitidas: Operaciones de restauración de archivos
• ✅ Permitidas: Operaciones de exportación de imágenes
• ✅ Permitidas: Gestión de redes
• ✅ Permitidas: Gestión de dispositivos (sólo actualizaciones)
• ✅ Permitido: Gestión de agentes (crear, emparejar, actualizar)
• ✅ Permitido: Gestión de copias de seguridad
• ❌ Bloqueado: Control de energía del dispositivo (apagado, reinicio)
• ❌ Bloqueado: Gestión de cuentas/clientes
• ❌ Bloqueado: Resolución de alertas
• ❌ Bloqueado: Eliminación de agentes
• ❌ Bloqueado: Eliminación de instantáneas

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

full-safe - Acceso completo (por defecto)

Caso de uso: Administración general con guardarraíles de seguridad

• ✅ Permitido: Todas las operaciones excepto las peligrosas
• ❌ Bloqueado: Eliminación de agentes (evita la interrupción accidental de copias de seguridad)
• ❌ Bloqueado: Eliminación de instantáneas (evita la pérdida de datos)
• ❌ Bloqueado: Control de alimentación del dispositivo (evita apagados accidentales)

./slide-mcp-server --api-key YOUR_KEY --tools full-safe # O simplemente (modo por defecto) ./slide-mcp-server --api-key YOUR_KEY

full - Acceso completo

Caso de uso: Administradores avanzados que necesitan acceso sin restricciones

• ✅ Permitido: Todas las operaciones incluidas las peligrosas
• ⚠️ Advertencia: Incluye el borrado de agentes e instantáneas

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

Matriz de permisos

Recomendaciones de seguridad

• Monitorización de la producción: Utilice el modo de generación de informes para cuadros de mando y sistemas de supervisión de sólo lectura
• Equipos de soporte: Utilice el modo de restauración para el personal de soporte de TI que realice recuperación de datos
• Administración general: Utilice el modo totalmente seguro (predeterminado) para la mayoría de las tareas administrativas
• Sólo usuarios avanzados: Utilice el modo completo sólo cuando se requiera específicamente la eliminación de agentes o instantáneas

Uso con VS Code

Para la integración con VS Code, añada el siguiente bloque JSON a su archivo de configuración de usuario (JSON). Puede hacerlo pulsando Ctrl + Mayús + P y escribiendo Preferencias: Abrir Configuración de Usuario (JSON).

Opcionalmente, puedes añadirlo a un archivo llamado .vscode/mcp.json en tu espacio de trabajo. Esto le permitirá compartir la configuración con otras personas.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .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}" } } } }

Con configuración personalizada y herramientas deshabilitadas:

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

💡 Ejemplos de uso

Listar todos los dispositivos

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

Crear una red con VPN

{ "name": "slide_networks", "arguments": { "operation": "create", "name": "Red de desarrollo", "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" } }

Crear máquina virtual a partir de instantánea

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

Generar marcador RDP para VM

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

Buscar documentación

{ "name": "slide_docs", "arguments": { "operation": "search_docs", "query": "políticas de retención de copias de seguridad" } }

🆕 Novedades de la versión 2.3.2

🚀 Mejoras en el rendimiento

• Carga inicial del contexto: El servidor MCP carga los datos de la jerarquía cliente/dispositivo/agente al iniciarse, lo que elimina los retrasos típicos de la primera llamada a la API y proporciona acceso inmediato a la visión general de la infraestructura
• Tiempos de respuesta más rápidos: El contexto inicial proporciona disponibilidad instantánea de los datos del sistema para una mejor experiencia del usuario

🖥️ Gestión de máquinas virtuales mejorada

• Generación de marcadores RDP: operación get_rdp_bookmark en la herramienta slide_vms
  • Generación de archivos descargables de Escritorio remoto de Windows (.rdp)
  • Acceso con un solo clic a máquinas virtuales a través de clientes RDP estándar
  • Compatible con Escritorio remoto de Windows, Escritorio remoto de macOS y otros clientes RDP
  • Incluye ajustes optimizados para compresión, audio, portapapeles y visualización
  • Validación automática de la disponibilidad del punto final RDP
  • Sugerencias de nombres de archivo fáciles de usar e instrucciones de uso claras

integración de documentación

• Acceso a la documentación integrado: La herramienta slide_docs proporciona acceso directo a la documentación oficial de Slide
• Ayuda contextual: Obtenga las mejores prácticas, orientación para la solución de problemas e información de referencia de la API
• Capacidades de búsqueda: Encuentre documentación relevante sin salir de su cliente MCP
• Contexto mejorado: Acceso mejorado a la documentación con mejores capacidades de navegación y búsqueda

🛠️ Instalador de GUI

• GUI multiplataforma: Instalador de escritorio nativo para Windows, macOS y Linux
• Detección inteligente: Detecta automáticamente la instalación de Claude Desktop y las configuraciones existentes
• Instalación con un solo clic: Descargue, instale y configure con un solo clic
• Gestión de claves API: Fácil actualización de la clave API y gestión de la configuración
• Desinstalación limpia: Eliminación completa del servidor y la configuración cuando sea necesario

Iniciar tarea de copia de seguridad

{ "name": "slide_backups", "arguments": { "operación": "start", "agent_id": "agent-456" } }

Exportar instantánea como imagen VHD

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

Mostrar tarjeta de estado del agente

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

Generar descripción general de varios dispositivos

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

Crear plantilla de Runbook

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

Generar plantilla de informe diario

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

Generar informes de copia de seguridad

{ "name": "slide_reports", "arguments": { "operación": "daily_backup_snapshot", "agent_id": "agent-123", "format": "markdown" } }

Buscar documentación

{ "name": "slide_docs", "arguments": { "operación": "buscar_documentos", "consulta": "políticas de retención de copias de seguridad" }

Sistema de documentación

El servidor MCP incluye un completo sistema de acceso a la documentación a través de la herramienta slide_docs. El sistema de documentación se ha mejorado con descripciones contextuales para ayudar a los LLM a tomar mejores decisiones cuando navegan entre secciones que parecen similares.

Funciones de contexto mejoradas

1. Descripciones de sección: Cada sección de la documentación incluye ahora una descripción detallada que explica su finalidad

   • Ejemplo: "Consola Slide > Redes" se aclara como "gestión de redes virtuales en dispositivos Slide/nube"
   • Ejemplo: "Producto > Redes" se aclara como "requisitos y prerrequisitos de infraestructura de red"

2. Descripciones de temas: Los nombres ambiguos de los temas incluyen descripciones contextuales

   • Temas como "Redes (gestión de redes)" frente a "Redes (requisitos)" están claramente diferenciados

3. Búsqueda contextual: Los resultados de la búsqueda incluyen descripciones de secciones y temas para ayudar a identificar la documentación correcta

4. Navegación mejorada: El LLM puede ahora distinguir mejor entre:

   • Documentación sobre configuración frente a documentación sobre requisitos
   • Funciones de la interfaz de usuario de la consola frente a Requisitos previos del sistema
   • Gestión de usuarios frente a Gestión de organizaciones cliente

Prueba del contexto de la documentación

Ejecute el script de prueba para verificar las mejoras del contexto:

./scripts_de_prueba/test_docs_context.sh

Compilación

# Build for current platform make build # Build for all platforms make build-all # Create release packages make release # View available commands make help

Ventajas de la arquitectura

Para los LLM

• Complejidad reducida: 14 metaherramientas frente a más de 52 herramientas individuales
• Agrupación lógica: Operaciones relacionadas organizadas juntas
• Interfaz coherente: Todas las metaherramientas siguen el mismo patrón de funcionamiento
• Mejor contexto: Menos cambios de herramienta, conversaciones más centradas

Para los desarrolladores

• Mantenible: Cada metaherramienta en su propio archivo
• Extensible: Fácil de añadir nuevas operaciones a las categorías existentes
• Compatible con versiones anteriores: Se conserva toda la funcionalidad original
• Validación de esquemas: Validación condicional de parámetros por operación

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que usted es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.