Scribe MCP 도구 레퍼런스 - Scribe Mail Documentation

AI 어시스턴트가 Scribe MCP 서버에 연결되면 호출할 수 있는 도구입니다. 서버는 15개 영역에 걸쳐 57개의 도구를 제공해요. 어시스턴트를 연결하려면 AI 에이전트 개요를 참고하세요.

권한 작동 방식읽기 도구는 자동으로 실행되며 데이터를 변경하지 않아요. 쓰기 도구(생성, 업데이트, 게시 등)는 먼저 확인을 요청해요. 삭제 도구도 확인을 요청하며 되돌릴 수 없어요. 모든 작업은 본인의 워크스페이스 범위로 제한돼요.

스키마

도구	권한	설명
`get_content_schema`	읽기	서명 블록 트리 스키마, 모든 enum 값, 실제 예시를 반환해요. 콘텐츠를 작성하기 전에 호출하세요

서명

도구	접근 권한	기능
`list_signatures`	읽기	서명 템플릿 목록 조회(`include_content`를 전달하지 않으면 블록 트리는 생략)
`create_signature`	쓰기	템플릿을 생성하며, 게시 전까지 `draft_content` 상태로 스테이징
`update_signature`	쓰기	id로 템플릿을 업데이트하며, 게시 전까지 초안 상태로 스테이징
`preview_signature`	읽기	초안 또는 게시된 템플릿을 자리표시자 값으로 HTML 렌더링해 레이아웃 확인
`get_signature_html`	읽기	특정 수신자에게 설치된 게시 서명의 실제 HTML 조회
`publish_signature`	쓰기	템플릿을 게시해 초안을 라이브로 전환하고 설치
`install_signature`	쓰기	게시 없이 현재 라이브 콘텐츠를 설치
`delete_signature`	삭제	템플릿을 삭제하고 팀원에게서 할당 해제

서명 변형

변형은 회신 이메일 또는 내부(동일 도메인) 이메일에 표시되는 대체 서명이에요. 변형을 사용하려면 Microsoft 365 서명 연동이 활성화되어 있어야 하며, 그렇지 않으면 변형 쓰기 작업은 409 variants_unavailable를 반환해요.

도구	접근 권한	기능
`list_signature_variants`	읽기	서명의 회신 및 내부 변형 목록을 상태와 콘텐츠와 함께 조회
`update_signature_variant`	쓰기	회신 또는 내부 변형을 생성하거나 업데이트하며, 게시 전까지 초안 상태로 스테이징
`publish_signature_variant`	쓰기	변형을 게시해 초안을 라이브로 전환하고 재배포
`delete_signature_variant`	삭제	변형을 기본 서명으로 되돌림(레코드는 유지)

서명 수신자

도구	권한	기능
`list_signature_recipients`	읽기	서명이 할당된 대상과 타기팅 규칙을 조회해요
`add_signature_recipients`	쓰기	여러 팀원 이메일에 서명을 일괄 할당해요
`remove_signature_recipients`	쓰기	서명에서 수동으로 할당된 수신자를 제거해요
`set_signature_recipient_rules`	쓰기	자동 할당과 Smartfield 조건 규칙을 설정해요
`add_signature_recipient_entities`	쓰기	디렉터리의 조직 단위나 그룹에 서명을 타기팅해요
`remove_signature_recipient_entities`	쓰기	디렉터리의 조직 단위나 그룹에서 타기팅을 해제해요

팀원

도구	권한	기능
`list_teammates`	읽기	팀원과 이메일, Smartfield 값을 조회해요
`create_teammate`	쓰기	이메일과 선택적 필드 값으로 팀원을 추가해요
`update_teammate`	쓰기	팀원의 Smartfield 값을 설정해요
`delete_teammate`	삭제	팀원을 소프트 삭제해요

이메일

도구	권한	기능
`list_emails`	읽기	팀원의 이메일(기본 및 별칭)을 조회해요
`create_email`	쓰기	팀원에게 별칭 이메일을 추가해요
`update_email`	쓰기	이메일 주소를 변경해요
`delete_email`	삭제	별칭 이메일을 소프트 삭제해요(기본 이메일은 삭제할 수 없어요)

Smartfields

도구	권한	기능
`list_smart_fields`	읽기	Smartfield 정의를 종류와 데이터 소스와 함께 조회해요
`create_smart_field`	쓰기	커스텀 필드를 정의하고, 필요하면 연동에서 동기화해요
`update_smart_field`	쓰기	커스텀 필드나 연동 링크를 업데이트해요
`delete_smart_field`	삭제	커스텀 필드와 모든 팀원의 해당 필드 값을 삭제해요

폴더

도구	접근 권한	기능
`list_folders`	읽기	서명 폴더와 각 폴더의 서명 개수를 조회
`create_folder`	쓰기	템플릿을 정리할 폴더 생성
`update_folder`	쓰기	폴더 이름 변경
`delete_folder`	삭제	폴더 삭제(먼저 폴더를 비워야 함)

에셋

도구	접근 권한	기능
`list_assets`	읽기	이미지 라이브러리(로고, 배너, 사진) 조회
`create_asset`	쓰기	base64 또는 소스 URL에서 이미지 업로드
`update_asset`	쓰기	에셋의 이름 또는 역할 업데이트
`delete_asset`	삭제	에셋 삭제(사용 중인 에셋은 계속 렌더링되도록 소프트 삭제 처리)

연동

도구	접근 권한	기능
`list_integrations`	읽기	활성 연동을 상태 및 오류 상세 정보와 함께 조회
`list_integration_entities`	읽기	서명을 적용할 디렉터리 조직 단위와 그룹 조회

재무 문서

도구	접근 권한	기능
`list_financial_documents`	읽기	다운로드 가능한 PDF 링크와 함께 청구서 및 대변 메모 조회

워크스페이스

도구	접근 권한	기능
`get_workspace`	읽기	워크스페이스 요금제, 상태, 청구된 사용자 수 조회

분석

클릭률 필드는 없어요. get_analytics_views와 get_analytics_clicks를 함께 사용해 클릭 수를 조회 수로 나눠 계산하세요.

도구	접근 권한	기능
`get_analytics_views`	읽기	지정한 기간의 서명 조회 수를 시계열 또는 순위 분석으로 제공
`get_analytics_clicks`	읽기	지정한 기간의 서명 클릭 수를 시계열 또는 순위 분석으로 제공
`get_analytics_events_summary`	읽기	집계된 전환 및 매출 수치를 시계열 또는 순위 분석으로 제공
`list_analytics_events`	읽기	분석의 기반이 되는 원본 전환 이벤트 목록 조회

방문자

방문자는 워크스페이스에서 식별된 최종 사용자(identify 호출로 수집)를 말하며, Scribe 팀원이 아니에요.

도구	접근 권한	기능
`list_visitors`	읽기	속성 및 최초 접점 어트리뷰션과 함께 식별된 방문자 목록 조회
`get_visitor`	읽기	식별된 방문자 한 명의 속성, 어트리뷰션, 전체 기간 참여 정보 조회
`get_visitor_breakdown`	읽기	식별된 방문자를 가장 많이 확보한 서명 또는 팀원 순위 조회

마케팅 캠페인

도구	접근 권한	기능
`list_marketing_campaigns`	읽기	상태, 타깃, 콘텐츠와 함께 캠페인 목록 조회
`create_marketing_campaign`	쓰기	이름과 기간을 지정해 캠페인 초안 생성
`update_marketing_campaign`	쓰기	id로 캠페인 업데이트
`schedule_marketing_campaign`	쓰기	초안 또는 일시 중지된 캠페인을 활성화하거나 예약
`pause_marketing_campaign`	쓰기	활성 캠페인을 일시 중지
`resume_marketing_campaign`	쓰기	일시 중지된 캠페인을 재개
`delete_marketing_campaign`	삭제	캠페인 삭제(활성 캠페인은 먼저 중지)

어시스턴트 연결

연결할 준비가 되었나요? AI 에이전트 개요에서 어시스턴트별 단계를 따라 진행하세요.

​스키마

​서명

​서명 변형

​서명 수신자

​팀원

​이메일

​Smartfields

​폴더

​에셋

​연동

​재무 문서

​워크스페이스

​분석

​방문자

​마케팅 캠페인

​어시스턴트 연결

스키마

서명

서명 변형

서명 수신자

팀원

이메일

Smartfields

폴더

에셋

연동

재무 문서

워크스페이스

분석

방문자

마케팅 캠페인

어시스턴트 연결