MCP 도구 목록

Atmark MCP 서버가 에이전트에게 주는 도구 열두 개와 각 도구에 필요한 권한.

Markdown 보기마지막 수정
  • send_email
  • reply_email
  • forward_email
  • list_inbox
  • read_email
  • get_thread
  • get_attachment_url
  • get_approval_status
  • get_my_policy
  • get_verification_code
  • list_scheduled
  • cancel_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로 보내 주세요.