중요
Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.
개요
| 서버 ID입니다. | 표시 이름 | 설명 |
|---|---|---|
| mcp_CalendarTools | Microsoft Outlook 일정 MCP Server | 일정 도구용 MCP 서버입니다. 이 MCP 서버를 사용하여 이벤트 만들기, 업데이트, 검색, 초대 관리 및 가용성 확인과 같은 일정 작업을 수행할 수 있습니다. |
사용 가능한 도구
mcp_CalendarTools_graph_acceptEvent
사용자의 일정에서 지정된 이벤트 초대를 수락합니다.
필수 매개 변수:
- eventId: 수락할 이벤트의 ID입니다.
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- 주석: 응답에 포함된 선택적 텍스트
- sendResponse: 이끌이에게 응답을 보낼지 여부
mcp_CalendarTools_graph_cancelEvent
지정된 사용자의 일정에서 이벤트를 취소하고 참석자에게 알립니다.
필수 매개 변수:
- eventId: 취소할 이벤트의 고유 식별자입니다.
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- 주석: 선택적 취소 메시지
mcp_CalendarTools_graph_createEvent
지정된 사용자의 일정에 새 일정 이벤트를 만듭니다. 되풀이 이벤트 및 온라인 모임을 지원합니다.
필수 매개 변수:
- 제목: 이벤트 제목/제목(비어있지 않은 경우)
- start: dateTime 및 timeZone을 사용하여 타임스탬프 시작
- end: dateTime 및 timeZone을 사용하여 타임스탬프 종료
- attendees_addresses: 참석자 전자 메일 주소 배열
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- body: contentType(텍스트/HTML) 및 콘텐츠가 있는 이벤트 본문
- 위치: displayName이 있는 위치
- attendees_types: 참석자 역할(필수, 선택 사항, 리소스)
- attendees_names: 참석자 표시 이름
- 되풀이: 되풀이 패턴 및 범위
- isOnlineMeeting: 온라인 모임에 대해 true로 설정
- onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
- allowNewTimeProposals: 시간 제안 허용(기본값: true)
- transactionId: Idempotence 식별자
mcp_CalendarTools_graph_declineEvent
사용자의 일정에서 지정된 이벤트 초대를 거절합니다.
필수 매개 변수:
- eventId: 거절할 이벤트의 ID
선택적 매개 변수
userId: 사용자 ID 또는 userPrincipalName
주석: 응답의 선택적 텍스트
sendResponse: 응답을 보낼지 여부
mcp_CalendarTools_graph_deleteEvent
지정된 사용자의 일정에서 이벤트를 삭제합니다.
필수 매개 변수:
- eventId: 삭제할 이벤트의 고유 식별자입니다.
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
mcp_CalendarTools_graph_findMeetingTimes
이끌이 및 참석자 가용성에 따라 모임 시간 및 위치를 제안합니다.
필수 매개 변수:
- meetingDuration: 모임 기간(예: 'PT1H')
선택적 매개 변수
- userId: 이끌이 ID 또는 userPrincipalName
- attendees_addresses: 참석자 전자 메일 주소
- attendees_types: 참석자 유형
- attendees_names: 참석자 표시 이름
- timeConstraint: timeslots 및 activityDomain을 사용하는 시간 가용성
- locationConstraint: 위치 옵션
- maxCandidates: 최대 제안
- isOrganizerOptional: 이끌이 선택적 플래그
- returnSuggestionReasons: 이유 포함
- minimumAttendeePercentage: 최소 출석 임계값
mcp_CalendarTools_graph_getEvent
지정된 사용자의 일정에서 단일 일정 이벤트를 가져옵니다.
필수 매개 변수:
- eventId: 이벤트의 고유 식별자입니다.
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- select: OData $select 쿼리 매개 변수
- expand: 탐색 속성에 대한 OData $expand
mcp_CalendarTools_graph_getSchedule
사용자, 메일 그룹 또는 리소스에 대한 약속 있음/없음 일정을 가져옵니다.
필수 매개 변수:
- 일정: 사용자 또는 리소스의 SMTP 주소
- startTime: dateTime 및 timeZone을 사용하여 시작 시간
- endTime: dateTime 및 timeZone을 사용하여 종료 시간
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- availabilityViewInterval: 시간 슬롯 길이(분)
mcp_CalendarTools_graph_listCalendarView
사용자의 지정된 시간 범위 내에서 일정 발생을 검색합니다.
필수 매개 변수:
- startDateTime: 시간 범위의 시작(ISO 8601)
- endDateTime: 시간 범위 종료(ISO 8601)
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- top: 최대 이벤트 수
- orderby: Order by 절
mcp_CalendarTools_graph_listEvents
지정된 사용자의 일정에서 이벤트 목록을 검색합니다.
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- startDateTime: 시간 범위의 시작(ISO 8601)
- endDateTime: 시간 범위 종료(ISO 8601)
- 최대 이벤트 수입니다.
- 필터: OData 필터 쿼리
- orderby: 쿼리별 OData 순서
mcp_CalendarTools_graph_updateEvent
지정된 사용자의 일정에서 기존 일정 이벤트를 업데이트합니다.
필수 매개 변수:
- eventId: 이벤트의 고유 식별자입니다.
선택적 매개 변수
- userId: 사용자 ID 또는 userPrincipalName
- 주제: 업데이트된 제목
- 본문: 업데이트된 본문 콘텐츠
- start: 업데이트된 시작 시간
- 끝: 업데이트된 종료 시간
- 위치: 업데이트된 위치
- attendees_addresses: 참석자 이메일 업데이트됨
- attendees_types: 업데이트된 참석자 유형
- attendees_names: 업데이트된 참석자 이름
- isCancelled: true로 설정하여 취소
- 되풀이: 업데이트된 되풀이 패턴
주요 특징
이벤트 관리
- 데이터의 만들기, 읽기, 업데이트 및 삭제
- 초대 수락, 거절 및 취소
- 되풀이 이벤트 지원
- 온라인 모임과 통합(Teams, Skype)
가용성 및 예약
- 약속 있음/없음 일정 가져오기
- 가용성 확인을 사용하여 모임 시간 찾기
- 시간 범위 필터링이 있는 일정 보기
- 참석자 가용성 분석
참석자 관리
- 필수, 선택 사항 및 리소스 참석자 관리
- 시간 제안 지원
- 응답 추적
- 메일 그룹 지원
되풀이 방법
- 매일, 매주, 매월 및 매년
- 절대 및 상대 되풀이
- 종료 날짜 또는 발생 횟수
- 요일 및 월 사양
온라인 모임
- 비즈니스용 Teams와 통합
- 비즈니스용 Skype를 지원합니다.
- 소비자용 Skype 지원
- 자동 모임 링크 생성
노트
- 모든 타임스탬프는 표준 시간대와 함께 UTC/ISO 8601 형식을 사용합니다.
- 일정 MCP는 UserprofileMCP를 사용하여 조직에서 사용자를 찾습니다.
- 메일은 유효한 형식이어야 합니다.
- 참석자 배열(주소, 형식, 이름)은 순서가 같아야 합니다.
- 온라인 모임에는 isOnlineMeeting=true 및 onlineMeetingProvider가 필요합니다.
- 되풀이하려면 패턴 및 범위 개체가 모두 필요합니다.
- 표준 시간대는 시작 및 종료 시간에 걸쳐 일관되어야 합니다.
- TransactionId를 사용하면 idempotent 이벤트를 만들 수 있습니다.