Servidor MCP Digital Samba Embedded API

Utilice su asistente AI para interactuar con la API Digital Samba Embedded

Instalación - Inicio rápido - Características - Referencia API

Descripción general

El servidor MCP de la API embebida de Samba Digital es un completo servidor de protocolo de contexto de modelo que permite a los asistentes de inteligencia artificial como Claude interactuar con la API embebida de Samba Digital. Con soporte para 102 herramientas y 38 recursos que cubren más de 100 puntos finales de API, proporciona un control completo sobre salas, sesiones, grabaciones, análisis y mucho más.

Características

gestión de salas

• Crear, actualizar y eliminar salas
• Generar tokens de acceso seguro
• Gestionar la configuración predeterminada de las salas

📊 Análisis e informes

• Estadísticas de uso de todo el equipo
• Análisis de salas y sesiones
• Análisis y seguimiento de los participantes
• Informes personalizados por periodos

🎥 Gestión de grabaciones

• Enumerar y gestionar las grabaciones
• Archivar y desarchivar grabaciones
• Descarga de enlaces de grabación
• Operaciones de grabación masiva

👥 Control de sesiones en directo

• Supervisar las salas con participantes activos
• Ver listas de participantes en tiempo real
• Comprobar el recuento de participantes y la duración de la sesión
• Iniciar/detener sesiones de grabación
• Iniciar/detener la transcripción
• Finalizar sesiones activas
• Supervisión de sesiones en tiempo real
• Integración de participantes por teléfono

herramientas de comunicación

• Creación y gestión de sondeos
• Eliminación de datos de la sesión (chat, preguntas y respuestas, transcripciones, resúmenes)

biblioteca de contenidos

• Creación y gestión de bibliotecas
• Subir archivos y documentos
• Organizar con carpetas
• Crear aplicaciones web y pizarras
• Operaciones masivas con archivos
• Operaciones de mover y copiar

🔐 Gestión de roles y permisos

• Crear roles personalizados
• Actualizar los permisos de los roles
• Eliminar roles
• Listar los permisos disponibles

🔔 Gestión de webhooks

• Listar los eventos webhook disponibles
• Crear y configurar webhooks
• Actualizar la configuración de los webhooks
• Eliminar webhooks
• Ver los detalles de los webhooks

📤 Capacidades de exportación

• Exportar el historial de chat
• Exportar sesiones de preguntas y respuestas
• Exportar transcripciones
• Exportar resultados de encuestas

Instalación

# Instalar globalmente npm install -g @digitalsamba/embedded-api-mcp-server # O usar directamente con npx (recomendado) npx @digitalsamba/embedded-api-mcp-server@latest --developer-key YOUR_DEVELOPER_KEY

Inicio rápido

1. Obtenga su clave de desarrollador

Regístrese en Digital Samba y obtenga su clave de desarrollador desde el panel de control.

2. Configurar Claude Desktop

Añada a su configuración Claude Desktop(~/Library/Application Support/Claude/claude_desktop_config.json en Mac):

{ "mcpServers": { "digital-samba": { "command": "npx", "args": ["@digitalsamba/embedded-api-mcp-server@latest", "--developer-key", "YOUR_DEVELOPER_KEY"] } }

3. Empezar a usar

Reinicie Claude Desktop y ya puede:

"Crear una sala de reuniones para nuestro standup de equipo" "Mostrarme los análisis de las reuniones de ayer"  
"Listar todas las grabaciones de la semana pasada" "Generar un enlace de unión para john@example.com" "Crear una encuesta preguntando por las preferencias de reunión" "Exportar la transcripción del chat de la sesión de hoy" "Subir nuestra presentación a la biblioteca de contenidos"

Recursos y herramientas MCP disponibles

El servidor MCP expone la funcionalidad de la API Digital Samba a través de dos tipos de interfaces: Los recursos proporcionan acceso de sólo lectura a los datos (como listar salas o ver análisis), mientras que las herramientas permiten acciones que modifican los datos (como crear salas o iniciar grabaciones). Se accede a ellas a través de los URI de MCP, no directamente desde los puntos finales de la API. Para obtener más información sobre los recursos y herramientas de MCP, consulte la documentación oficial de MCP.

Nota sobre la compatibilidad con AI Assistant: Aunque el protocolo MCP admite tanto recursos como herramientas, los asistentes de IA actuales (como Claude Desktop) sólo pueden acceder a herramientas, no a recursos. Para evitar esta limitación, hemos implementado un enfoque híbrido con las herramientas de lectura: todos los recursos de sólo lectura también tienen versiones equivalentes de herramientas que proporcionan los mismos datos. Por ejemplo, también se puede acceder al recurso digitalsamba://rooms a través de la herramienta list-rooms. Las herramientas de lectura están claramente marcadas con "mirrors digitalsamba://..." en sus descripciones. De este modo se garantiza la plena funcionalidad en los asistentes de IA, al tiempo que se mantiene la compatibilidad con futuras mejoras del cliente MCP.

Recursos (sólo lectura) - 32 disponibles

Recursos de sala

• digitalsamba://rooms - Lista de todas las salas
• digitalsamba://rooms/{id} - Obtener detalles de la habitación
• digitalsamba://rooms/live - Lista de salas con participantes activos
• digitalsamba://rooms/live/participants - Lista de salas con detalles de participantes
• digitalsamba://rooms/{id}/live - Obtener información de la sesión en directo de una sala
• digitalsamba://rooms/{id}/live/participants - Obtener la lista de participantes de una sala

Recursos de la sesión

• digitalsamba://sessions - Lista de todas las sesiones
• digitalsamba://sessions/{id} - Obtener el resumen de la sesión
• digitalsamba://sessions/{id}/participants - Lista de participantes en la sesión
• digitalsamba://sessions/{id}/statistics - Obtener estadísticas de la sesión
• digitalsamba://rooms/{id}/sessions - Lista de sesiones de una sala

Recursos de grabación

• digitalsamba://recordings - Listar todas las grabaciones
• digitalsamba://recordings/{id} - Obtener detalles de la grabación
• digitalsamba://recordings/archived - Lista de grabaciones archivadas
• digitalsamba://rooms/{id}/recordings - Lista de grabaciones de una sala

Recursos analíticos

• digitalsamba://analytics/team - Estadísticas de todo el equipo
• digitalsamba://analytics/rooms - Análisis de una sala
• digitalsamba://analytics/sessions/{id} - Análisis de sesiones
• digitalsamba://analytics/participants - Análisis de participantes
• digitalsamba://analytics/participants/{id} - Estadísticas específicas de participantes
• digitalsamba://analytics/usage - Estadísticas de uso
• digitalsamba://analytics/live - Análisis de sesiones en directo
• digitalsamba://analytics/live/{roomId} - Análisis en directo de una sala específica

Recursos de la biblioteca de contenidos

• digitalsamba://libraries - Lista de todas las bibliotecas
• digitalsamba://libraries/{id} - Detalles de la biblioteca
• digitalsamba://libraries/{id}/hierarchy - Estructura de carpetas de la biblioteca
• digitalsamba://libraries/{id}/folders - Lista de carpetas
• digitalsamba://libraries/{id}/folders/{folderId} - Detalles de la carpeta
• digitalsamba://libraries/{id}/files - Lista de archivos
• digitalsamba://libraries/{id}/files/{fileId} - Detalles del archivo

Exportar recursos

• digitalsamba://exports/communications/{roomId}/chat - Exportar chat
• digitalsamba://exports/communications/{roomId}/qa - Exportar preguntas y respuestas
• digitalsamba://exports/communications/{sessionId}/transcripts - Exportar transcripciones
• digitalsamba://exports/polls/{roomId} - Exportar encuestas
• digitalsamba://exports/recordings/{recordingId} - Exportar metadatos de grabación
• digitalsamba://exports/sessions/{sessionId}/summary - Exportar resumen de sesión
• digitalsamba://exports/sessions/{sessionId}/metadata - Exportar metadatos de sesión

Herramientas (Acciones) - 99 Disponibles

Gestión de salas

• create-room - Crear una nueva sala
• update-room - Actualizar la configuración de la sala
• delete-room - Eliminar una sala
• generate-token - Generar token de acceso
• get-default-room-settings - Obtener la configuración por defecto para nuevas salas
• update-default-room-settings - Actualizar la configuración por defecto de las nuevas salas
• list-rooms - Listar todas las salas (mirrors digitalsamba://rooms)
• get-room-details - Obtener detalles específicos de la habitación (mirrors digitalsamba://rooms/{id})
• list-live-rooms - Lista de salas con participantes activos
• list-live-participants - Lista todos los participantes activos en las salas

Gestión de sesiones

• end-session - Finalizar una sesión en directo
• get-session-summary - Obtener detalles de la sesión
• get-all-room-sessions - Lista todas las sesiones de una sala
• hard-delete-session-resources - Borrar permanentemente los datos de una sesión
• bulk-delete-session-data - Borrar múltiples tipos de datos de sesión
• get-session-statistics - Obtener estadísticas detalladas de la sesión
• list-sessions - Listar todas las sesiones (mirrors digitalsamba://sessions)
• get-session-details - Obtener detalles específicos de la sesión (mirrors digitalsamba://sessions/{id})
• list-session-participants - Lista los participantes de una sesión
• list-room-sessions - Lista las sesiones de una sala específica

Gestión de grabaciones

• get-recordings - Lista las grabaciones con filtros
• delete-recording - Eliminar una grabación
• get-recording - Obtener detalles de una grabación
• get-recording-download-link - Obtener la URL de descarga
• archive-recording - Archiva una grabación
• unarchive-recording - Desarchiva una grabación

Controles de sesión en directo

• start-recording - Iniciar la grabación de una sesión
• stop-recording - Detener la grabación
• start-transcription - Iniciar la transcripción en directo
• stop-transcription - Detener la transcripción
• phone-participants-joined - Registrar la entrada de participantes telefónicos
• phone-participants-left - Registrar la salida de participantes telefónicos

Herramientas de análisis

• get-participant-statistics - Análisis de participantes
• get-room-analytics - Análisis del uso de la sala
• get-usage-statistics - Métricas generales de uso
• get-usage-analytics - Análisis de uso (refleja digitalsamba://analytics/usage)
• get-live-analytics - Análisis de sesiones en directo (mirror digitalsamba://analytics/live)
• get-live-room-analytics - Análisis en tiempo real de una sala específica
• get-session-analytics - Análisis de sesiones (mirrors digitalsamba://analytics/sessions/{id})
• get-participant-analytics - Análisis de participantes específicos

Gestión de la comunicación

• delete-session-chats - Eliminar los mensajes de chat de una sesión
• delete-room-chats - Eliminar todos los chats de una sala
• delete-session-qa - Eliminar las preguntas y respuestas de una sesión
• delete-room-qa - Eliminar todas las preguntas y respuestas de una sala
• delete-session-transcripts - Eliminar transcripciones
• delete-room-transcripts - Eliminar todas las transcripciones de una sala
• delete-session-summaries - Eliminar los resúmenes de la IA
• delete-room-summaries - Eliminar todos los resúmenes de una sala

Gestión de sondeos

• create-poll - Crear una nueva encuesta
• update-poll - Actualizar la configuración del sondeo
• delete-poll - Borrar un sondeo
• delete-session-polls - Elimina todos los sondeos de una sesión
• delete-room-polls - Elimina todas las encuestas de una sala
• publish-poll-results - Publicar los resultados a los participantes

Gestión de la biblioteca de contenidos

• create-library - Crear una biblioteca de contenidos
• update-library - Actualizar los detalles de la biblioteca
• delete-library - Eliminar una biblioteca
• create-library-folder - Crear una carpeta
• update-library-folder - Actualizar carpeta
• delete-library-folder - Eliminar carpeta
• create-library-file - Subir archivo
• update-library-file - Actualizar detalles del archivo
• delete-library-file - Eliminar archivo
• get-file-links - Obtener enlaces de visualización de archivos
• create-webapp - Crear aplicación web
• create-whiteboard - Crear pizarra
• move-library-file - Mover archivo entre carpetas
• move-library-folder - Mover carpeta
• bulk-delete-library-files - Borrar múltiples archivos
• bulk-upload-library-files - Subir múltiples archivos
• copy-library-content - Copiar archivos/carpetas
• list-libraries - Listar todas las bibliotecas (mirrors digitalsamba://libraries)
• get-library-details - Obtener detalles de la biblioteca (mirrors digitalsamba://libraries/{id})
• get-library-hierarchy - Obtener la estructura de carpetas (mirrors digitalsamba://libraries/{id}/hierarchy)
• list-library-folders - Lista todas las carpetas (mirrors digitalsamba://libraries/{id}/folders)
• get-library-folder-details - Obtener detalles de la carpeta
• list-library-files - Lista todos los archivos (mirrors digitalsamba://libraries/{id}/files)
• get-library-file-details - Obtener detalles de archivos

Gestión de roles y permisos

• create-role - Crear un rol personalizado
• update-role - Actualiza la configuración de un rol
• delete-role - Elimina un rol
• get-roles - Lista todos los roles
• get-role - Obtener detalles del rol
• get-permissions - Lista de permisos disponibles

Gestión de Webhooks

• list-webhook-events - Lista los eventos disponibles a los que suscribirse
• list-webhooks - Lista todos los webhooks configurados
• create-webhook - Crea un nuevo webhook
• get-webhook - Obtener detalles del webhook
• update-webhook - Actualiza la configuración del webhook
• delete-webhook - Elimina un webhook

Herramientas de exportación

• export-chat-messages - Exportar mensajes de chat de una sala (espejos digitalsamba://exports/communications/{roomId}/chat)
• export-qa-data - Exportar datos de preguntas y respuestas de una sala (mirror digitalsamba://exports/communications/{roomId}/qa)
• export-session-transcripts - Exportar transcripciones de una sesión (mirror digitalsamba://exports/communications/{sessionId}/transcripts)
• export-poll-results - Exportar resultados de encuestas de una sala (mirror digitalsamba://exports/polls/{roomId})
• export-recording-metadata - Exportar metadatos de grabación (mirror digitalsamba://exports/recordings/{recordingId})
• export-session-summary - Exportar resumen de sesión (mirror digitalsamba://exports/sessions/{sessionId}/summary)
• export-session-metadata - Exportar metadatos de sesión (espejos digitalsamba://exports/sessions/{sessionId}/metadata)

Variables de entorno

• DIGITAL_SAMBA_DEVELOPER_KEY - Su clave de desarrollador de Digital Samba (opcional si usa --developer-key o -k flag)
• DIGITAL_SAMBA_API_URL - URL base de la API (opcional, por defecto en producción)
• DS_LOG_LEVEL - Nivel de registro (error, warn, info, debug)

Ejemplos

Creación de sala básica

"Crear una sala privada llamada 'Reunión Ejecutiva' con espacio para 10 personas"

Generar token de acceso

"Generar un token de moderador para que sarah@company.com pueda unirse a la reunión ejecutiva"

Gestionar biblioteca de contenidos

"Crear una biblioteca para nuestros materiales de formación y subir la presentación de onboarding"

Análisis e informes

"Mostrarme las estadísticas de participantes de las sesiones del último mes"

Desarrollo

# Clonar el repositorio git clone https://github.com/digitalsamba/embedded-api-mcp-server.git cd embedded-api-mcp-server # Instalar dependencias npm install # Ejecutar en modo desarrollo npm run dev -- --developer-key YOUR_DEVELOPER_KEY # o -k YOUR_DEVELOPER_KEY # Construir para producción npm run build # Ejecutar pruebas npm test # Ejecutar pruebas con cobertura npm run test:coverage

Arquitectura

El servidor sigue una arquitectura modular:

src/ ├── index.ts # Entrada principal del servidor MCP ├── digital-samba-api.ts # API client wrapper ├── resources/ # Read-only MCP resources │ ├── rooms/ # Room listings │ ├── sessions/ # Session data │ ├── analytics/ # Analytics data │ ├── recordings/      # Listados de grabaciones │ ├── contenido/ # Bibliotecas de contenido │ └── exportaciones/ # Funcionalidad de exportación └── herramientas/ # Herramientas MCP (acciones) ├── sala-management/ ├── session-management/ ├─ recording-management/ ├── analytics-tools/ ├── live-session-controles/ ├── gestión de la comunicación/ ├─ gestión de sondeos/ ├── gestión de bibliotecas/ └── gestión de roles/

Cómo contribuir

¡Damos la bienvenida a las contribuciones! Por favor, consulte nuestra Guía de Contribución para más detalles.

Licencia

Licencia MIT - vea LICENSE para más detalles.

Soporte

• 📧 Correo electrónico: support@digitalsamba.com
• 📚 Documentación de la API
• 🐛 S eguimiento de incidencias

Construido con ❤️ por el equipo de Digital Samba