다음을 통해 공유


Microsoft Mail MCP 서버 참조

중요

Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.

개요

서버 ID입니다. 표시 이름 설명
mcp_MailTools Microsoft Outlook 메일 MCP 서버(Frontier): Microsoft Graph Mail 도구를 제공하는 MCP 서버.

사용 가능한 도구

1. mcp_MailTools_graph_mail_createMessage

초안 전자 메일을 만듭니다. body.body.contentType = "HTML"을 설정하여 HTML을 지원합니다.

필수 매개 변수:

  • 제목: 메시지 제목
  • toRecipients: 전자 메일 주소가 있는 받는 사람 배열
  • body: contentType(텍스트/HTML) 및 콘텐츠가 있는 메시지 본문

선택적 매개 변수

  • preferHtml: HTML 콘텐츠에 대해 true로 설정
  • 헤더: 선택적 추가 헤더

mcp_MailTools_graph_mail_deleteMessage

로그인한 사용자의 사서함에서 메시지를 삭제합니다.

필수 매개 변수:

  • id: 메시지 ID

선택적 매개 변수

  • If-Match: 동시성 제어를 위한 선택적 ETag

mcp_MailTools_graph_mail_getMessage

로그인한 사용자의 사서함에서 ID로 메시지를 가져옵니다. preferHtml을 사용하여 HTML 본문을 요청합니다.

필수 매개 변수:

  • id: 메시지 ID

선택적 매개 변수

  • select: OData select 절
  • expand: OData expand 절
  • preferHtml: 요청 HTML 본문 형식
  • 헤더: 선택적 HTTP 헤더

mcp_MailTools_graph_mail_listSent

보낸 편지함의 메시지를 나열합니다.

선택적 매개 변수

  • 필터: OData 필터
  • 검색: 검색 쿼리
  • orderby: 정렬 식
  • top: 반환할 항목 수
  • select: 반환할 필드

mcp_MailTools_graph_mail_reply

기존 메시지에 회신을 보냅니다. 또는 headers을 통해 preferHtml HTML을 지원합니다.

필수 매개 변수:

  • id: 회신할 메시지 ID

선택적 매개 변수

  • 주석: 회신 텍스트
  • 메시지: 선택적 메시지 재정의
  • preferHtml: HTML 서식 설정
  • 헤더: 선택적 HTTP 헤더

mcp_MailTools_graph_mail_replyAll

기존 메시지에 전체 회신을 보냅니다. 또는 headers을 통해 preferHtml HTML을 지원합니다.

필수 매개 변수:

  • id: 전체 회신에 대한 메시지 ID

선택적 매개 변수

  • 주석: 회신 텍스트
  • 메시지: 선택적 메시지 재정의
  • preferHtml: HTML 서식 설정
  • 헤더: 선택적 HTTP 헤더

mcp_MailTools_graph_mail_searchMessages

KQL 스타일 쿼리와 함께 Microsoft Graph Search API를 사용하여 Outlook 메시지를 검색합니다.

필수 매개 변수:

  • 요청: entityTypes, 쿼리, 원본, 크기 매개 변수를 사용하는 검색 요청 배열

메시지 콘텐츠, 제목, 본문 및 첨부 파일 검색 지원

mcp_MailTools_graph_mail_sendDraft

ID로 기존 초안 메시지를 보냅니다.

필수 매개 변수:

  • id: 보낼 임시 메시지 ID

mcp_MailTools_graph_mail_sendMail

앱은 로그인한 사용자로 전자 메일을 보내야 합니다.

필수 매개 변수:

  • 메시지: 제목, toRecipients 및 본문이 있는 메시지 개체
  • 제목: 전자 메일 제목
  • toRecipients: 기본 받는 사람
  • 본문: contentType(텍스트/HTML) 및 콘텐츠가 있는 전자 메일 본문

선택적 매개 변수

  • ccRecipients: 탄소 복사 받는 사람
  • bccRecipients: 블라인드 카본 카피 받는 사람
  • saveToSentItems: 보낸 편지에 저장(기본값: true)
  • preferHtml: HTML 렌더링 강제 적용
  • 헤더: 선택적 추가 HTTP 헤더

10. mcp_MailTools_graph_mail_updateMessage

메시지의 변경 가능한 속성(예: 제목, 본문, 범주)을 업데이트합니다.

필수 매개 변수:

  • id: 메시지 ID

선택적 매개 변수

  • 주제: 새 주제
  • 본문: 새 메시지 본문
  • 범주: 메시지 범주
  • 중요도: 낮음, 보통 또는 높음
  • If-Match: 동시성 제어를 위한 ETag

주요 특징

전자 메일 컴퍼지션

  • 초안 만들기 및 전자 메일 보내기
  • HTML 및 일반 텍스트 지원
  • 받는 사람, CC 및 BCC 받는 사람
  • .NET 서식 지정 옵션

전자 메일 관리

  • 메시지 가져오기, 업데이트 및 삭제
  • 회신 및 모든 회신 기능
  • 자산 관리
  • 범주 및 중요도 설정

검색 및 필터링

  • KQL 스타일 메시지 검색
  • OData 쿼리 지원
  • 제목, 본문, 첨부 파일 검색
  • 페이지 매김 및 필터링

Sentitems

  • 채팅 메시지 나열
  • 보낸 편지에 선택적 저장
  • 보낸 항목 필터링 및 검색

노트

  1. 모든 작업에서 Microsoft Graph Mail API 사용
  2. HTML 콘텐츠에 contentType = 본문의 "HTML"이 필요합니다.
  3. preferHtml 헤더 요청 HTML 본문 형식
  4. 검색은 KQL 쿼리와 함께 Microsoft Graph Search API를 사용합니다.
  5. 임시 메시지를 만들고, 업데이트하고, 별도로 보낼 수 있습니다.
  6. 업데이트에 대한 동시성 제어에 대한 ETag 지원