Referencia del calendario de WORK IQ (versión preliminar)

Importante

• Esta es una característica en vista previa.
• Las características en versión preliminar no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a condiciones de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Panorama

Id. de servidor	Nombre para mostrar	Description
mcp_CalendarTools	Calendario de Trabajo IQ	Servidor MCP para herramientas de calendario. Use este servidor MCP para operaciones de calendario, como crear, actualizar, recuperar eventos, administrar invitaciones y comprobar la disponibilidad.

Nota:

• Las conexiones existentes que usan versiones anteriores de servidores MCP de Microsoft, como el servidor MCP de Microsoft Teams, siguen siendo compatibles.
• Para todas las conexiones nuevas, use los servidores MCP de Work IQ más recientes, como Work IQ Teams.

Herramientas disponibles

mcp_CalendarTools_graph_acceptEvent

Acepte la invitación de eventos especificada en el calendario de un usuario.

Parámetros requeridos:

• eventId: el identificador del evento que se va a aceptar.

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• comentario: texto opcional incluido en la respuesta
• sendResponse: indica si se va a enviar respuesta al organizador

mcp_CalendarTools_graph_cancelEvent

Cancele un evento en el calendario de un usuario especificado y notifique a los asistentes.

Parámetros requeridos:

• eventId: identificador único del evento que se va a cancelar.

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• comentario: mensaje de cancelación opcional

mcp_CalendarTools_graph_createEvent

Cree un nuevo evento de calendario en el calendario de un usuario especificado. Admite eventos periódicos y reuniones en línea.

Parámetros requeridos:

• subject: Asunto o título del evento (no vacío)
• start: marca de tiempo de inicio con dateTime y timeZone
• end: marca de tiempo final con dateTime y timeZone
• attendees_addresses: matriz de direcciones de correo electrónico de asistentes

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• body: cuerpo del evento con contentType (Texto/HTML) y contenido
• location: Ubicación con displayName
• attendees_types: roles de asistente (obligatorio, opcional, recurso)
• attendees_names: nombres de muestra para los asistentes
• recurrencia: patrón y rango de recurrencia
• isOnlineMeeting: se establece en true para la reunión en línea
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
• allowNewTimeProposals: permitir propuestas de tiempo (valor predeterminado: true)
• transactionId: Idempotence identificador

mcp_HerramientasCalendario_gráfico_rechazarEvento

Rechace la invitación de eventos especificada en el calendario de un usuario.

Parámetros requeridos:

• eventId: identificador del evento que se va a rechazar

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName

• comentario: texto opcional en respuesta

• sendResponse: indica si se va a enviar la respuesta

mcp_CalendarTools_graph_deleteEvent

Elimine un evento del calendario de un usuario especificado.

Parámetros requeridos:

• eventId: identificador único del evento que se va a eliminar.

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugerir horas y ubicaciones de reunión en función de la disponibilidad del organizador y del asistente.

Parámetros requeridos:

• meetingDuration: duración de la reunión (por ejemplo, "PT1H")

Parámetros opcionales:

• userId: id. de organizador o userPrincipalName
• attendees_addresses: direcciones de correo electrónico de asistentes
• attendees_types: tipos de asistentes
• attendees_names: nombres de muestra para los asistentes
• timeConstraint: disponibilidad horaria con timeslots y activityDomain
• locationConstraint: Opciones de ubicación
• maxCandidates: Sugerencias máximas
• isOrganizerOptional: marca de organizador opcional
• returnSuggestionReasons: incluir razones
• minimumAttendeePercentage: umbral mínimo de asistencia

mcp_CalendarTools_graph_getEvent

Obtiene un único evento de calendario del calendario de un usuario especificado.

Parámetros requeridos:

• eventId: identificador único del evento

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• select: parámetro de consulta de OData \$select
• expand: OData para propiedades de navegación \$expand

mcp_CalendarTools_graph_getSchedule

Obtenga la agenda de disponibilidad de un usuario, lista de distribución o recurso.

Parámetros requeridos:

• listas: direcciones SMTP de usuarios o recursos
• startTime: hora de inicio con dateTime y timeZone
• endTime: hora de finalización con dateTime y timeZone

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• availabilityViewInterval: duración del espacio de tiempo en minutos

mcp_CalendarTools_grafico_listaVistaCalendario

Recupere las apariciones del calendario dentro de un intervalo de tiempo especificado para un usuario.

Parámetros requeridos:

• startDateTime: inicio del intervalo de tiempo (ISO 8601)
• endDateTime: fin del intervalo de tiempo (ISO 8601)

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• top: número máximo de eventos
• orderby: cláusula de ordenamiento

mcp_HerramientasCalendario_grafico_listarEventos

Recupere una lista de eventos del calendario de un usuario especificado.

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• startDateTime: inicio del intervalo de tiempo (ISO 8601)
• endDateTime: fin del intervalo de tiempo (ISO 8601)
• top: número máximo de eventos
• filter: consulta de filtro de OData
• orderby: ordenar por consulta de OData

mcp_HerramientasDelCalendario_grafico_actualizarEvento

Actualice un evento de calendario existente en el calendario de un usuario especificado.

Parámetros requeridos:

• eventId: identificador único del evento

Parámetros opcionales:

• userId: id. de usuario o userPrincipalName
• asunto: asunto actualizado
• body: contenido del cuerpo actualizado
• start: hora de inicio actualizada
• end: hora de finalización actualizada
• ubicación: ubicación actualizada
• attendees_addresses: mensajes de correo electrónico de asistentes actualizados
• attendees_types: tipos de asistentes actualizados
• attendees_names: nombres de asistentes actualizados
• isCancelled: se establece en true para cancelar
• recurrencia: patrón de recurrencia actualizado

Funciones principales

Administración de eventos

• Crear, leer, actualizar y eliminar eventos
• Aceptar, rechazar y cancelar invitaciones
• Compatibilidad con eventos periódicos
• Integración con reuniones en línea (Teams, Skype)

Disponibilidad y programación

• Obtener horarios de disponibilidad
• Buscar horas de reunión con comprobación de disponibilidad
• Vista de calendario con filtrado de intervalo de tiempo
• Análisis de disponibilidad de asistentes

Administración de asistentes

• Administrar asistentes obligatorios, opcionales y de recursos
• Soporte para propuestas de horarios
• Seguir respuestas
• Compatibilidad con listas de distribución

Patrones de periodicidad

• Patrones diario, semanal, mensual y anual
• Periodicidad absoluta y relativa
• Fecha de finalización o número de ocurrencias
• Especificaciones de día de semana y mes

Reuniones de Internet

• Integración con Teams para empresas
• Compatibilidad con Skype Empresarial
• Compatibilidad con Skype (para uso personal)
• Generación automática de vínculos de reunión

Notes

• Todas las marcas de tiempo utilizan el formato UTC/ISO 8601 con zona horaria
• Calendar MCP se basa en UserprofileMCP para encontrar usuarios en la organización.
• Las direcciones de correo electrónico deben estar en formato válido
• Las matrices de asistentes (direcciones, tipos, nombres) deben estar en el mismo orden
• Las reuniones online requieren isOnlineMeeting=true y onlineMeetingProvider
• La periodicidad requiere objetos de patrón y rango
• Las zonas horarias deben ser coherentes en las horas de inicio y finalización
• TransactionId Permite idempotent la creación de eventos