freispace MCP Server

freispace MCP Server

Un servidor de Model Context Protocol (MCP) que proporciona análisis e información para el software de planificación freispace. Este servidor permite a los asistentes de IA (p. ej., Copilot, Gemini) consultar datos dentro de freispace, como estadísticas de proyectos e información relacionada con la planificación.

Descripción general

El freispace MCP Server conecta cualquier LLM con capacidades de herramientas a freispace para consultar datos analíticos.

Los equipos de medios que utilizan freispace pueden aprovechar el servidor MCP para poner los datos de planificación a disposición de toda la empresa mediante la IA corporativa (p. ej., Copilot), sin que los usuarios tengan que estar en freispace o siquiera conocer freispace, así como ayudar a los equipos de postproducción a tomar decisiones basadas en datos durante la programación y planificación.

Nuestro MCP Server siempre respeta los permisos de usuario, garantizando que el LLM solo podrá acceder a los datos a nivel de usuario, asegurando la protección de datos.

Algunos ejemplos de consultas podrían ser "¿Quién ha trabajado con la Persona X en el pasado?" o "¿Cuántos días de vacaciones me quedan?"

Requisitos previos

1. Cuenta de freispace Flagship
2. Clave API MCP válida para freispace
   • Durante beta, contacta con tu equipo de soporte de freispace para obtener una clave API MCP

Herramientas disponibles

Todas las búsquedas se basan en nombres. Se admiten nombres parciales; se utiliza la primera coincidencia.

get_current_user

Quién es el usuario que realiza la llamada: nombre, correo electrónico y registro de personal vinculado. Sin argumentos. Úsalo para resolver "yo"/"me"/"mi" a un nombre de personal.

"¿Con qué usuario he iniciado sesión?"

get_staffs

Lista los miembros del personal con nombre, cargo y número de personal.

• status (opcional): active (predeterminado), inactive, all

"Listar todos los miembros del personal" · "¿Quiénes son los desarrolladores en la empresa?"

find_resources

Busca salas/estudios (suites), equipos/licencias (recursos) y personal por nombre en una sola llamada, agrupados por tipo.

• search (opcional): nombre o nombre parcial; omítelo para listar todo
• staff (opcional): internal o external
• site (opcional): solo suites en ubicaciones coincidentes
• status (opcional): active (predeterminado), inactive, all

"Buscar a Sammy" · "Listar freelancers externos"

get_availability

Comprueba cuándo está libre el personal, las suites o los recursos en una ventana de fechas (predeterminado 14 días, máx. 92), teniendo en cuenta reservas, días festivos y ausencias/horarios de trabajo del personal.

• type (obligatorio): staff, resource, suite o site
• search, staff, site, status (opcional): selección de entidad como en find_resources
• from, to, days, weeks (opcional): la ventana de fechas
• duration + duration_unit (opcional): duración libre requerida (minutes, hours o days)

"¿Está libre un estudio el próximo martes durante 3 horas?" · "¿Quién tiene 2 días completamente libres en las próximas dos semanas?"

get_my_schedule

Las propias reservas del usuario que realiza la llamada en una ventana de fechas (predeterminado: próximos 7 días).

• from, to, days, weeks (opcional): la ventana de fechas

"¿Qué hay en mi agenda esta semana?"

get_my_tasks

Tareas asignadas al usuario que realiza la llamada, con fecha de vencimiento, prioridad y referencia.

• include_done (opcional): incluir también las tareas completadas

"¿Cuáles son mis tareas pendientes?"

get_open_tasks

Todas las tareas pendientes del equipo, con asignados.

• reference (opcional): project, booking o user

"¿Qué tareas del proyecto siguen pendientes?"

get_staff_projects

Lista los proyectos en los que está reservado un miembro del personal, con rango de fechas y duración.

• staff_name (obligatorio)

"¿En qué proyectos está reservado Karl?"

get_staff_collaborators

Muestra con quién ha trabajado un miembro del personal, basándose en reservas compartidas.

• staff_name (obligatorio)

"¿Con quién ha trabajado Alexander?"

get_staff_next_holiday

Obtiene las próximas vacaciones de un miembro del personal (inicio, fin, duración, comentario).

• staff_name (opcional; omitir para el usuario que realiza la llamada)

"¿Cuándo son mis próximas vacaciones?" · "¿Cuándo está de vacaciones Hendrikje?"

get_staff_holiday_quota

Obtiene la cuota de vacaciones de un miembro del personal para un año: total, días disfrutados y restantes.

• staff_name (opcional; omitir para el usuario que realiza la llamada)
• year (opcional; predeterminado al año actual)

"¿Cuántos días de vacaciones me quedan?"

get_project_stats

Estadísticas de reservas para un proyecto: reservas pasadas vs. próximas con desglose por estado, más el lapso del proyecto (inicio de la primera reserva, fin de la última reserva y la duración en días entre ellas).

• project_name (obligatorio)

"Mostrar estadísticas de reservas para el Proyecto Alpha" · "¿Cuánto dura el Proyecto Alpha?"

get_project_team

Lista los miembros del personal que trabajaron en un proyecto, con su número de reservas en él.

• project_name (obligatorio)

"¿Quién trabajó en el rediseño del sitio web?"

get_project_tasks

Estado de las tareas de un proyecto: todas las tareas del proyecto y sus reservas, con un resumen de pendientes/completadas/vencidas.

• project_name (obligatorio)

"¿Hay tareas pendientes en el proyecto documental?"

get_invoices

Lista facturas con filtros y totales por moneda; paginado. Grupos de estado: draft, open, overdue, paid, partially-paid, canceled, locked.

• search (opcional): coincide con número, número de pedido, asunto, dirección del destinatario
• status, number, date_min/date_max, due_date_min/due_date_max, sum_min/sum_max, outstanding_min/outstanding_max, sort, order, page, per_page (opcional)

"¿Qué facturas están vencidas?" · "Facturas pendientes de Acme"

get_offers

Lista ofertas (presupuestos) con filtros y totales netos por moneda; paginado. Grupos de estado: draft, locked, open, accepted, declined.

• search, status, number, date_min/date_max, sum_min/sum_max, sort, order, page, per_page (opcional)

"Mostrar ofertas rechazadas de este año"

get_orders

Lista pedidos (trabajos) con sus ofertas y facturas conectadas en línea; paginado.

• search (opcional): coincide con número de pedido y nombre
• status, number, date_min/date_max, sort, order, page, per_page (opcional)

"¿Qué se presupuestó y facturó en el pedido 2026-014?"

search_docs

Busca en la documentación de freispace y devuelve los extractos más relevantes.

• query (obligatorio)
• limit (opcional): máx. extractos, predeterminado 5

"¿Cómo configuro la planificación de turnos en freispace?"

Manejo de errores

Los errores se devuelven al modelo solicitante como mensajes cortos y prácticos (p. ej., Not found (404): Staff member with name 'X' not found. Call get_staffs to list valid staff names.). Los diagnósticos se registran en stderr; stdout solo transporta el protocolo MCP.

⚠️ Aviso de Beta

Nuestro freispace MCP server se encuentra actualmente en fase beta. Todas las funciones son gratuitas durante este período. Agradecemos tus comentarios y paciencia mientras seguimos mejorando la plataforma.

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles.

Soporte

Para soporte y preguntas:

• Documentación: documentación de freispace
• Incidencias: Incidencias en GitHub
• Contacto: Soporte de freispace