Slide MCP Server
Se integra con la API de Slide para la gestión de dispositivos e infraestructura.
Documentación
Slide MCP Server
slide-mcp-server conecta asistentes de IA a la API de Slide BCDR. Es un único binario de Go con herramientas orientadas a tareas para salud de respaldos, recuperación de archivos, instantáneas, alertas, VMs de recuperación, exportaciones de imágenes, redes de DR y administración de cuentas.
Es compatible con los dos principales ecosistemas locales de MCP:
- Anthropic: un paquete MCP de Claude Desktop de arrastrar y soltar, además del registro de Claude Code.
- OpenAI: registro de Codex de escritorio, CLI e IDE a través de su configuración MCP compartida.
El servidor usa stdio JSON-RPC, no tiene dependencias en tiempo de ejecución y nunca escribe el token de API de Slide en este repositorio.
Instalación
Claude Desktop: arrastrar y soltar
- Descarga slide-mcp-server.mcpb.
- Arrástralo a Claude Desktop → Configuración → Extensiones.
- Pega un token de API de Slide desde console.slide.tech en Mi configuración → Tokens de API.
El paquete contiene binarios universales para macOS, Linux amd64/arm64 y Windows amd64. Su binario de macOS está firmado con Developer ID y notarizado por Apple, por lo que una verificación normal de Gatekeeper en línea se ejecuta sin advertencias.
La URL de descarga estable siempre apunta a la versión más reciente de GitHub. El instalador retirado anterior a MCPB también sigue funcionando: las versiones publican sus nombres de activos históricos macos-x64, macos-arm64, linux-x64, linux-arm64 y windows-x64.
Los paquetes privados de Claude Desktop cargados lateralmente no se actualizan automáticamente actualmente. Reinstala el .mcpb estable para actualizar mientras la extensión sea privada. Anthropic habilita actualizaciones automáticas de extensiones para las distribuidas a través de su directorio oficial; el manifiesto está preparado para esa vía de envío. Consulta la guía de extensiones locales de Anthropic.
OpenAI Codex
Desde un clon:
make build
SLIDE_API_KEY=tk_... make install-codex
codex mcp get slide
O registra cualquier binario descargado directamente:
codex mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server
Las superficies de Codex de escritorio, CLI e IDE comparten la configuración de MCP. Volver a ejecutar make install-codex reemplaza de forma segura el registro existente de slide.
Claude Code
make build
SLIDE_API_KEY=tk_... make install-claude-code
claude mcp list
El registro directo también funciona:
claude mcp add slide --env SLIDE_API_KEY=tk_... -- /absolute/path/to/slide-mcp-server
Cursor y otros hosts MCP stdio
Descarga el binario para tu plataforma y configura el equivalente a:
{
"mcpServers": {
"slide": {
"command": "/absolute/path/to/slide-mcp-server",
"env": {
"SLIDE_API_KEY": "tk_...",
"SLIDE_TOOLS": "safe"
}
}
}
}
Qué preguntar
- "¿Están saludables todas mis cajas de Slide?"
- "¿Se ejecutaron los respaldos anoche para ACME?"
- "Encuentra Q4-budget.xlsx en la laptop de Bob y restaura la versión del martes."
- "¿Qué alertas sin resolver tengo? Ordénalas por gravedad."
- "Inicia una VM de recuperación para DC-01."
- "¿Qué cambió en las últimas 24 horas?"
- "No sé por dónde empezar: ¿qué puedes hacer?"
No necesitas memorizar los identificadores a_..., d_... o c_.... Las operaciones orientadas al usuario aceptan name_hint; la coincidencia determinista del lado del servidor resuelve nombres para mostrar y nombres de host, o devuelve candidatos cuando un nombre es ambiguo.
Superficie MCP
El servidor expone 12 herramientas orientadas a tareas más un alias de compatibilidad. Cada herramienta principal usa un parámetro operation en lugar de crear una herramienta de nivel superior separada para cada endpoint de API.
| Herramienta | Propósito |
|---|---|
slide_help | Incorporación integrada, ejemplos, glosario, solución de problemas y diagnósticos |
slide_overview | Inventario completo, salud y resúmenes de clientes/dispositivos |
slide_files | Buscar, explorar, restaurar y enviar archivos |
slide_recovery | VMs de recuperación, exportaciones de imágenes y redes de DR |
slide_audit | Consultas del registro de auditoría de la cuenta |
slide_clients | Gestión de clientes |
slide_admin | Gestión de usuarios y cuentas |
slide_devices | Detalles del dispositivo, redes y acciones del dispositivo |
slide_agents | Configuración del sistema protegido, servicios, horarios y retención |
slide_snapshots | Puntos de restauración y resultados de verificación |
slide_backups | Estado de respaldo e inicio de respaldo |
slide_alerts | Revisión, triaje y resolución de alertas |
list_all_clients_devices_and_agents | Alias de inventario compatible con versiones anteriores |
También sirve seis Prompts de MCP, incluidos slide.welcome, slide.daily-status y slide.restore-file, y Recursos de slide:// estáticos/dinámicos.
Seguridad y confiabilidad
El nivel de permiso predeterminado safe permite trabajo operativo de recuperación, pero bloquea eliminaciones, apagado y reinicio. Los modos disponibles son:
| Modo | Operaciones permitidas |
|---|---|
read-only | Operaciones de listar, obtener, buscar, explorar y diagnóstico |
safe | Operaciones de lectura más restauraciones, respaldos y configuraciones reversibles |
full | Todo, incluidas operaciones de eliminación y ciclo de energía |
Los nombres heredados reporting, restores y full-safe siguen siendo aceptados para que las configuraciones existentes continúen iniciándose.
Las protecciones de confiabilidad incluyen:
- validación de inicio que nunca bloquea el protocolo de inicio de MCP;
- plazos de operación de 45 segundos y cuerpos de respuesta ascendentes limitados;
- reintento/retroceso solo para lecturas idempotentes, evitando mutaciones duplicadas;
- paginación completa y segura contra bucles para inventario y salud de toda la cuenta;
- errores de API tipados y con token redactado con remediación accionable;
- validación de esquema JSON del lado del servidor para entradas y salidas estructuradas;
- diagnósticos de
--doctory--debugcon máscara de secretos.
Configuración
Las banderas de CLI anulan las variables de entorno.
| Banderas | Entorno | Predeterminado |
|---|---|---|
--api-key | SLIDE_API_KEY | requerido para operación normal |
--base-url | SLIDE_BASE_URL | https://api.slide.tech |
--tools | SLIDE_TOOLS | safe |
--disabled-tools | SLIDE_DISABLED_TOOLS | ninguno |
--doctor | — | ejecutar verificaciones y salir |
--debug | — | imprimir un paquete de diagnóstico enmascarado y salir |
--skip-startup-validation | — | omitir la sonda de cuenta en segundo plano |
--tool / --args | — | ejecutar una llamada de herramienta sin un host MCP |
--version | — | imprimir la versión y salir |
Las URL base de API que no sean de bucle local deben usar HTTPS. HTTP simple solo se acepta para servidores de prueba en localhost.
Banco de pruebas
El repositorio tiene tres capas de prueba:
# Deterministic offline suite: API failure injection, permissions, schemas,
# MCP protocol profiles, distribution contracts, and a real stdio subprocess.
make test
# Live, read-only demo/account smoke. Loads ignored .env when present and
# always rebuilds the repository binary before testing.
./smoke_test.sh
# Cross-platform binaries, MCPB structure, checksums, compatibility aliases.
make release
CI ejecuta pruebas de Go con detección de carreras, go vet, compilación cruzada, ShellCheck, verificación de activos de versión y el validador oficial de manifiesto MCPB de Anthropic. Los perfiles de protocolo cubren la ruta establecida de 2025-06-18 de Claude Desktop y la ruta de 2025-11-25 de Codex/MCP actual.
Para inspección interactiva:
SLIDE_API_KEY=tk_... npx @modelcontextprotocol/inspector ./build/slide-mcp-server
Desarrollo
git clone https://github.com/amcchord/slideMCP.git
cd slideMCP
make setup-dev
make test
make build
El cliente de API sigue la API de Slide v1.27.0; el documento OpenAPI en caché está en docs/openapi.json. Agrega nuevo comportamiento de endpoint como una operación en la meta-herramienta existente más cercana, a menos que el flujo de trabajo esté mejor representado por un Prompt o Recurso de MCP.
Diagnósticos útiles:
SLIDE_API_KEY=tk_... build/slide-mcp-server --doctor
build/slide-mcp-server --debug | jq .
Versión
Lee docs/SIGNING.md antes de tocar el pipeline de firma. Una versión de producción se corta intencionalmente de una rama main ya confirmada y limpia:
./scripts/setup-signing.sh # first machine only
make doctor-signing
./scripts/release-all-in-one.sh vX.Y.Z
El pipeline de versión:
- verifica que las versiones de
Makefile,config.goydxt/manifest.jsoncoincidan; - ejecuta pruebas de carreras y
go vet; - compila cada objetivo desde un directorio
build/limpio; - firma con Developer ID y notariza el ejecutable universal de macOS;
- empaqueta y verifica el
.mcpb; - compila nombres de activos de instalador actuales y heredados más sumas SHA-256;
- aplica firma/notarización nuevamente antes de etiquetar;
- envía
main, crea la etiqueta y publica la versión de GitHub.
Apple no puede grapar un ticket a un ejecutable Mach-O sin procesar. stapled: no es esperado; codesign --test-requirement="=notarized" realiza la verificación de notarización en línea correcta.