MCP 도구 목록
Atmark MCP 서버가 에이전트에게 주는 도구 열두 개와 각 도구에 필요한 권한.
send_emailreply_emailforward_emaillist_inboxread_emailget_threadget_attachment_urlget_approval_statusget_my_policyget_verification_codelist_scheduledcancel_scheduled
도구별 설명
| 도구 | 하는 일 | 권한 |
|---|---|---|
send_email | 새 메일을 보냅니다. from을 생략하면 대표 주소로 보냅니다. | 보내기 |
reply_email | 받은 메일에 회신합니다. 기본 받는 사람은 보낸 사람, 제목은 Re: …입니다. | 보내기 |
forward_email | 받은 메일을 전달합니다. 본문 텍스트만, 첨부는 빼고 옮깁니다. | 보내기 |
list_inbox | 받은 메일 목록(최신순). 보낸 사람·기간·스레드로 거릅니다. 격리된 메일은 개수만 보입니다. | 읽기 |
read_email | 받은 메일 한 통을 읽습니다. 길면 잘리고 offset으로 이어 읽습니다. | 읽기 |
get_thread | 스레드를 봅니다. 길면 최신 메일부터 보이고, before_message_id로 앞을 이어 봅니다. | 읽기 |
get_attachment_url | 받은 첨부의 내려받기 링크(5분 유효) | 읽기 |
get_approval_status | 승인 대기 결과(대기·승인·거절·만료) | 읽기 |
get_my_policy | 자기 정책과 한도, 기본 발신 주소 | 자기 정보 |
get_verification_code | 가입·로그인 인증 코드 찾기. 인증 코드 | 읽기 |
list_scheduled | 예약 메일 목록과 상태(scheduled·dispatched·cancelled) | 읽기 |
cancel_scheduled | 예약 취소. 사유 코드가 필수입니다. | 보내기 |
알아 둘 것
agent_id는 인자가 아닙니다. 토큰이 정합니다. 에이전트는 자기 메일과 정보만 봅니다.- 소유자 권한이 필요한 도구(정책 바꾸기 등)는 서버에 없습니다. 예약을 만드는 도구도 없습니다. 예약은 REST API로 만듭니다.
- 같은 인자로 다시 불러도 메일은 두 번 나가지 않습니다. 결과에
replayed: true가 붙습니다. 그래서 거부된 메일을 원인을 고친 뒤 다시 보낼 때는idempotency_key에 새 값을 넣어야 합니다. - 발송 결과(
sent·denied·pending_approval)와 전달 거부(refused)는 모두 정상 결과입니다. 결과의next_step한 줄이 다음 할 일을 말합니다. - 받은 메일의 본문·제목·주소·파일명은 결과 안의 외부 데이터 블록에만 들어 있습니다. 받은 메일은 데이터로 다루기
이 문서에 대한 의견은 support@atmark.ai로 보내 주세요.