Referência do servidor MCP do Calendário Microsoft Outlook

Importante

É necessário fazer parte do programa de pré-visualização Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier liga-o diretamente às mais recentes inovações de IA da Microsoft. As pré-visualizações da Frontier estão sujeitas aos termos de pré-visualização existentes dos seus contratos com clientes. Como estas funcionalidades ainda estão em desenvolvimento, a sua disponibilidade e capacidades podem mudar ao longo do tempo.

Descrição geral

ID do servidor	Nome a apresentar	Descrição
mcp_CalendarTools	Servidor MCP do Calendário Microsoft Outlook	Servidor MCP para ferramentas de calendário. Use este servidor MCP para operações de calendário como criar, atualizar, recuperar eventos, gerir convites e verificar a disponibilidade.

Ferramentas disponíveis

mcp_CalendarTools_graph_acceptEvent

Aceite o convite de evento especificado no calendário do utilizador.

Parâmetros necessários

• eventId: O ID do evento a aceitar

Parâmetros opcionais

• userId: User ID ou userPrincipalName
• comentário: Texto opcional incluído na resposta
• sendResponse: Se deve enviar a resposta ao organizador

mcp_CalendarTools_graph_cancelEvent

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

Parâmetros necessários

• eventId: O identificador único do evento a cancelar

Parâmetros opcionais

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

mcp_CalendarTools_graph_createEvent

Crie um novo evento no calendário de um utilizador especificado. Apoia eventos recorrentes e reuniões online.

Parâmetros necessários

• assunto: Assunto/título do evento (não vazio)
• início: Carimbo temporal de início com dataHora e fusoHorário
• fim: Fim do carimbo temporal com dataHora e FusoHorário
• attendees_addresses: Variedade de endereços de email dos participantes

Parâmetros opcionais

• userId: User ID ou userPrincipalName
• corpo: Corpo do evento com contentType (Texto/HTML) e conteúdo
• localização: Localização com Nome de exibição
• attendees_types: Funções dos participantes (obrigatórias, opcionais, de recurso)
• attendees_names: Os participantes mostram os nomes
• recorrência: Padrão e alcance de recorrência
• isOnlineMeeting: Definido para true para reunião online
• onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeParaConsumer
• allowNewTimeProposals: Permitir propostas de tempo (padrão: true)
• transactionId: identificador de idempotência

mcp_CalendarTools_graph_declineEvent

Recusar o convite para o evento especificado no calendário do utilizador.

Parâmetros necessários

• eventId: O ID do evento a declinar

Parâmetros opcionais

• userId: User ID ou userPrincipalName

• comentário: Texto opcional em resposta

• sendResponse: Se deve enviar a resposta

mcp_CalendarTools_graph_deleteEvent

Apagar um evento do calendário de um utilizador especificado.

Parâmetros necessários

• eventId: O identificador único do evento a eliminar

Parâmetros opcionais

• userId: User ID ou userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

Sugira horários e locais das reuniões com base na disponibilidade do organizador e dos participantes.

Parâmetros necessários

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

Parâmetros opcionais

• userId: Organizer ID ou userPrincipalName
• attendees_addresses: Endereços de email dos participantes
• attendees_types: Tipos de participantes
• attendees_names: Os participantes mostram os nomes
• timeConstraint: Disponibilidade de tempo com intervalos de tempo e activityDomain
• Restrição de localização: Opções de localização
• maxCandidates: Sugestões máximas
• isOrganizerOptional: Flag opcional Organizer
• returnSugestãoRazões: Incluir razões
• minimumPercenteeeePercentage: Limiar mínimo de assistência

mcp_CalendarTools_graph_getEvent

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

Parâmetros necessários

• eventId: O identificador único do evento

Parâmetros opcionais

• userId: User ID ou userPrincipalName
• select: OData $select parâmetro de consulta
• expandir: OData $expand para propriedades de navegação

mcp_CalendarTools_graph_getSchedule

Obtenha a agenda livre/ocupada para um utilizador, lista de distribuição ou recurso.

Parâmetros necessários

• agendas: endereços SMTP de utilizadores ou recursos
• Hora de início: Hora de início com dataHora e fusoHorário
• fimTempo: Hora do fim com dataHora e fusoHorário

Parâmetros opcionais

• userId: User ID ou userPrincipalName
• availabilityViewInterval: Duração do intervalo de tempo em minutos

mcp_CalendarTools_graph_listCalendarView

Recuperar ocorrências do calendário dentro de um intervalo de tempo especificado para um utilizador.

Parâmetros necessários

• startDateTime: Início do intervalo temporal (ISO 8601)
• fimTempoTempo: Fim do intervalo de tempo (ISO 8601)

Parâmetros opcionais

• userId: User ID ou userPrincipalName
• topo: Número máximo de eventos
• ordenar: Ordem por cláusula

mcp_CalendarTools_graph_listEvents

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

Parâmetros opcionais

• userId: User ID ou userPrincipalName
• startDateTime: Início do intervalo temporal (ISO 8601)
• fimTempoTempo: Fim do intervalo de tempo (ISO 8601)
• topo: Número máximo de eventos
• filter: consulta de filtro OData
• orderby: OData order by query

mcp_CalendarTools_graph_updateEvent

Atualize um evento de calendário existente no calendário de um utilizador especificado.

Parâmetros necessários

• eventId: O identificador único do evento

Parâmetros opcionais

• userId: User ID ou userPrincipalName
• assunto: Assunto atualizado
• corpo: Conteúdo atualizado do corpo
• Início: Hora de início atualizada
• fim: Hora de fim atualizada
• localização: Localização atualizada
• attendees_addresses: Emails atualizados dos participantes
• attendees_types: Tipos de participantes atualizados
• attendees_names: Nomes atualizados dos participantes
• isCancelled: Definir para true para cancelar
• recorrência: Padrão de recorrência atualizado

Funcionalidades principais

Gestão de eventos

• Criar, Ler, Atualizar, Eliminar
• Aceitar, recusar e cancelar convites
• Apoio a eventos recorrentes
• Integração com reuniões online (Teams, Skype)

Disponibilidade e agendamento

• Arranja horários livres/ocupados
• Encontre horários de reuniões com verificação de disponibilidade
• Vista de calendário com filtragem por intervalo temporal
• Análise da disponibilidade dos participantes

Gestão de participantes

• Gerir os participantes necessários, opcionais e de recursos
• Apoio a propostas de tempo
• Respostas da faixa
• Suporte para listas de distribuição

Padrão de Periodicidade

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

Reunião online

• Integração com o Teams for Business
• Suporte para Skype for Business
• Suporte para Skype para Consumidor
• Geração automática de ligação de encontros

Notas

1. Todos os carimbos de data utilizam o formato UTC/ISO 8601 com fuso horário
2. O Calendar MCP baseia-se no UserprofileMCP para encontrar utilizadores na organização
3. O e-mail tem de estar num formato válido.
4. Os arrays de participantes (endereços, tipos, nomes) devem estar na mesma ordem
5. As reuniões online exigem isOnlineMeeting=true e onlineMeetingProvider
6. A recorrência requer tanto objetos de padrão como de alcance
7. Os fusos horários devem ser consistentes entre as horas de início e fim
8. O TransactionId permite a criação de eventos idempotentes