메모
이 글에서는 표준 하네스로 구동되는 에이전트 또는 에이전트 플로우에서 사용되는 기능에 대해 설명합니다.
Important
미리 보기 기능입니다.
- Microsoft 고객이 조기에 액세스하고 피드백을 제공할 수 있도록 공식 릴리스 전에 미리 보기 기능을 릴리스합니다.
- 미리 보기 기능은 기능이 제한되어 있으며 프로덕션용으로 사용되지 않습니다.
- Microsoft 미리 보기 MCP 도구 이름 및 매개 변수를 변경할 수 있습니다. 하드 코딩된 종속성을 방지합니다. Microsoft 시나리오 지원을 유지 관리합니다.
- 미리 보기 기능은 Microsoft 추가 사용 약관 적용됩니다.
메모
애플리케이션 특화 Microsoft 365 MCP 도구들(Copilot, 캘린더, 메일, SharePoint, OneDrive, Teams, User, Word)은 하위 호환성 목적으로만 설계되었으며, 운영 환경이나 새로운 프로젝트에서는 사용하지 않아야 합니다. Microsoft 365 리소스에 접근해야 하는 신규 프로젝트의 경우, GitHub Copilot 하네스와 함께 Work IQ MCP를 사용하세요. 자세한 내용은 Copilot Studio의 Work IQ MCP를 참조하세요.
Overview
| 서버 ID | 테넌트 수준의 URL | 표시 이름 | Description |
|---|---|---|---|
mcp_MailTools |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_MailTools |
메일 | Microsoft Graph 메일 작업을 위한 도구로, 이메일 메시지 생성, 발송, 답장 및 관리 등이 포함됩니다. |
사용 가능한 도구
mcp_MailTools_graph_mail_createMessage
초안 전자 메일을 만듭니다.
body.body.contentType = "HTML"를 설정하여 HTML을 지원합니다.
필수 매개 변수:
- 제목: 메시지 제목
- toRecipients: 전자 메일 주소가 있는 받는 사람 배열
- 본문: contentType(텍스트/HTML) 및 콘텐츠가 포함된 메시지 본문
선택적 매개 변수:
- preferHtml: HTML 콘텐츠에 대해 true로 설정
- 헤더: 선택적 추가 헤더
mcp_MailTools_graph_mail_deleteMessage
로그인한 사용자의 사서함에서 메시지를 삭제합니다.
필수 매개 변수:
- 아이디: 메시지 ID
선택적 매개 변수:
-
If-Match: 동시성 제어에 대한 선택 사항
ETag
mcp_MailTools_graph_mail_getMessage
로그인한 사용자의 사서함에서 ID로 메시지를 가져옵니다. HTML 본문을 요청하는 데 사용합니다 preferHtml .
필수 매개 변수:
- 아이디: 메시지 ID
선택적 매개 변수:
- select: OData select 절
- expand: OData expand 절
- preferHtml: 요청 HTML 본문 형식
- 헤더: 선택적 HTTP 헤더
mcp_MailTools_graph_mail_listSent
보낸 항목의 메시지를 나열합니다.
선택적 매개 변수:
- 필터: OData 필터
- 검색: 검색 쿼리
- orderby: 정렬 식
- 맨 위로: 반환할 항목 수
- 선택: 반환할 필드
mcp_MailTools_graph_mail_reply
기존 메시지에 회신을 보냅니다.
preferHtml 또는 headers을 통해 HTML을 지원합니다.
필수 매개 변수:
- 아이디: 회신할 메시지 ID
선택적 매개 변수:
- 주석: 회신 텍스트
- 메시지: 선택적 메시지 덮어쓰기
- preferHtml: HTML 서식 설정
- 헤더: 선택적 HTTP 헤더
mcp_MailTools_graph_mail_replyAll
기존 메시지에 전체 회신을 보냅니다.
preferHtml 또는 headers을 통해 HTML을 지원합니다.
필수 매개 변수:
- id: 전체 회신할 메시지 ID
선택적 매개 변수:
- 주석: 회신 텍스트
- 메시지: 선택적 메시지 덮어쓰기
- preferHtml: HTML 서식 설정
- 헤더: 선택적 HTTP 헤더
mcp_MailTools_graph_mail_searchMessages
KQL(키워드 쿼리 언어) 스타일 쿼리를 사용하여 Microsoft Graph Search API를 사용하여 Outlook 메시지를 검색합니다.
필수 매개 변수:
-
요청:
entityTypes, query, from, size 매개변수가 있는 검색 요청 배열
메시지 콘텐츠, 제목, 본문 및 첨부 파일 검색 지원
mcp_MailTools_graph_mail_sendDraft
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
선택적 매개 변수:
- 제목: 새 주제
- 본문: 새 메시지 본문
- 카테고리: 메시지 범주
- 중요성: 낮음, 보통 또는 높음
-
If-Match:
ETag동시성 제어용
주요 기능
전자 메일 컴퍼지션
- 초안 만들기 및 전자 메일 보내기
- HTML 및 일반 텍스트 지원
- 받는 사람, CC 및 BCC 수신자
- 다양한 서식 옵션
Email 관리
- 메시지를 가져오기, 업데이트 및 삭제합니다.
- 답장 및 전체 답장 기능
- 초안 관리.
- 범주 및 중요도 설정입니다.
검색 및 필터링
- KQL 스타일 메시지 검색
- OData 쿼리 지원.
- 제목, 본문 및 첨부 파일을 검색합니다.
- 페이지 매김 및 필터링.
Sentitems
- 보낸 메시지를 나열합니다.
- 보낸 항목에 선택적으로 저장합니다.
- 보낸 항목을 필터링하고 검색합니다.
Notes
- 모든 작업은 Microsoft Graph Mail API를 사용합니다.
- HTML 콘텐츠는
contentType = "HTML"본문에 필요합니다. -
preferHtml헤더는 HTML 본문 형식을 요청합니다. - 검색은 KQL 쿼리와 함께 Microsoft Graph Search API를 사용합니다.
- 임시 메시지를 만들고, 업데이트하고, 별도로 보낼 수 있습니다.
-
ETag업데이트에 대한 동시성 제어를 지원합니다.