Referência do Calendário do Work IQ (versão prévia)

Importante

  • Esta é uma versão preliminar do recurso.
  • As versões prévias do recurso não foram criadas para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos estão sujeitos a termos de uso complementares e estão disponíveis antes do lançamento oficial, de maneira que os clientes possam obter acesso antecipado e fazer comentários.

Visão geral

ID de servidor Nome de exibição Description
mcp_CalendarTools Calendário de IQ do Trabalho Servidor MCP para ferramentas de calendário. Use este servidor MCP para operações de calendário, como criar, atualizar, recuperar eventos, gerenciar convites e verificar a disponibilidade.

Note

  • As conexões existentes que usam versões anteriores de servidores MCP da Microsoft, como o servidor MCP do Microsoft Teams, permanecem com suporte.
  • Para todas as novas conexões, use os servidores MCP mais recentes do Work IQ, como o Work IQ Teams.

Ferramentas disponíveis

mcp_CalendarTools_graph_acceptEvent

Aceite o convite para o evento especificado no calendário do usuário.

Parâmetros requeridos:

  • eventId: A ID do evento a ser aceito

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • comentário: Texto opcional incluído em resposta
  • sendResponse: se deseja enviar resposta ao organizador

mcp_CalendarTools_graph_cancelEvent

Cancele um evento no calendário de um usuário específico e notifique os participantes.

Parâmetros requeridos:

  • eventId: o identificador exclusivo do evento a ser cancelado

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • comentário: Mensagem de cancelamento opcional

mcp_CalendarTools_graph_createEvent

Crie um novo evento no calendário de um usuário específico. Apoia eventos recorrentes e reuniões online.

Parâmetros requeridos:

  • subject: Assunto/título do evento (não vazio)
  • start: Carimbo de data e hora inicial com dateTime e timeZone
  • fim: Carimbo de data/hora de término com dateTime e timeZone
  • attendees_addresses: Matriz de endereços de email do participante

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • body: Corpo do evento com contentType (Texto/HTML) e conteúdo
  • localização: Localização com displayName
  • attendees_types: Funções de participante (obrigatório, opcional, recurso)
  • attendees_names: Nomes de exibição do participante
  • recorrência: padrão e intervalo de recorrência
  • isOnlineMeeting: Configure como 'true' para reunião online
  • onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals: Permitir novas propostas de horário (padrão: true)
  • transactionId: Idempotence identificador

mcp_CalendarTools_grafico_recusarEvento

Recuse o convite para evento especificado no calendário do usuário.

Parâmetros requeridos:

  • eventId: O ID do evento a ser recusado

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName

  • comentário: Texto opcional em resposta

  • sendResponse: se a resposta deve ser enviada

mcp_CalendarTools_graph_deleteEvent

Exclua um evento do calendário de um usuário específico.

Parâmetros requeridos:

  • eventId: o identificador exclusivo do evento a ser excluído

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugera horários e locais de reunião com base na disponibilidade do organizador e dos participantes.

Parâmetros requeridos:

  • meetingDuration: duração da reunião (por exemplo, 'PT1H')

Parâmetros opcionais:

  • userId: ID do organizador ou userPrincipalName
  • attendees_addresses: Endereços de email do participante
  • attendees_types: Tipos de participante
  • attendees_names: Nomes de exibição do participante
  • restrição de tempo: disponibilidade de tempo com timeslots e activityDomain
  • locationConstraint: opções de localização
  • maxCandidates: Sugestões máximas
  • isOrganizerOptional: Sinalizador opcional do organizador
  • returnSuggestionReasons: incluir motivos
  • minimumAttendeePercentage: limite mínimo de atendimento

mcp_CalendarTools_graph_getEvent

Obtenha um único evento do calendário de um usuário específico.

Parâmetros requeridos:

  • eventId: o identificador exclusivo do evento

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • select: parâmetro de consulta OData \$select
  • expand: OData \$expand para propriedades de navegação

mcp_CalendarTools_graph_getSchedule

Obtenha a agenda livre/movimentada para um usuário, lista de distribuição ou recurso.

Parâmetros requeridos:

  • agendas: endereços SMTP de usuários ou recursos
  • startTime: hora de início com dateTime e timeZone
  • endTime: Hora de término com dateTime e timeZone

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • availabilityViewInterval: tempo de intervalo em minutos

mcp_CalendarTools_graph_listCalendarView

Recupere ocorrências do calendário dentro de um intervalo de tempo especificado para o usuário.

Parâmetros requeridos:

  • startDateTime: início do intervalo de tempo (ISO 8601)
  • endDateTime: intervalo de tempo de término (ISO 8601)

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • top: número máximo de eventos
  • orderby: Cláusula Order by

mcp_CalendarTools_grafico_listarEventos

Recupere uma lista de eventos do calendário de um usuário especificado.

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • startDateTime: início do intervalo de tempo (ISO 8601)
  • endDateTime: intervalo de tempo de término (ISO 8601)
  • top: número máximo de eventos
  • filtro: consulta de filtro OData
  • orderby: Ordem por consulta OData

mcp_CalendarTools_graph_updateEvent

Atualize um evento de calendário existente no calendário de um usuário específico.

Parâmetros requeridos:

  • eventId: o identificador exclusivo do evento

Parâmetros opcionais:

  • userId: ID do usuário ou userPrincipalName
  • assunto: Assunto atualizado
  • body: Conteúdo do corpo atualizado
  • start: Hora de início atualizada
  • fim: Hora de término atualizada
  • local: Local atualizado
  • attendees_addresses: Emails de participantes atualizados
  • attendees_types: Tipos de participantes atualizados
  • attendees_names: Nomes de participantes atualizados
  • isCancelled: Definido como true para cancelar
  • recorrência: padrão de recorrência atualizado

Recursos principais

Gerenciamento de eventos

  • Criar, ler, atualizar e excluir eventos
  • Aceite, recuse e cancele convites
  • Suporte a eventos recorrentes
  • Integração com reuniões online (Teams, Skype)

Disponibilidade e agendamento

  • Tenha horários livres/ocupados
  • Encontre horários de encontros com verificação de disponibilidade
  • Visualização de calendário com filtragem por intervalo de tempo
  • Análise da disponibilidade dos participantes

Gestão dos participantes

  • Gerencie participantes obrigatórios, opcionais e de recursos
  • Apoio a propostas de agendamento
  • Rastrear resposta
  • Suporte para listas de distribuição

Padrão de recorrência

  • Padrões diários, semanais, mensais e anuais.
  • Recorrência absoluta e relativa
  • Data de término ou contagem de ocorrências
  • Especificações do dia da semana e do mês

Reuniões online

  • Integração com o Teams for Business
  • Suporte para Skype for Business
  • Suporte para Skype (para uso pessoal)
  • Geração automática de links de encontro

Notes

  • Os timestamps utilizam o formato UTC/ISO 8601, incluindo informações de fuso horário.
  • Calendar MCP se baseia em UserprofileMCP para localizar usuários na organização.
  • O email precisa ter um formato válido.
  • Os arrays dos participantes (endereços, tipos, nomes) devem estar na mesma ordem
  • Reuniões online exigem isOnlineMeeting=true e onlineMeetingProvider
  • A recorrência requer tanto objetos de padrão quanto de intervalo
  • Os fusos horários devem ser consistentes entre os horários de início e fim
  • TransactionId Possibilita idempotent a criação de eventos
  • Last updated on