> ## Documentation Index > Fetch the complete documentation index at: https://help.scribe-mail.com/llms.txt > Use this file to discover all available pages before exploring further. # Scribe MCP 도구 레퍼런스 > Scribe MCP 서버가 AI 어시스턴트에 노출하는 모든 도구를 영역별로 묶어 읽기, 쓰기, 삭제 권한과 함께 정리했어요. AI 어시스턴트가 Scribe MCP 서버에 연결되면 호출할 수 있는 도구입니다. 서버는 15개 영역에 걸쳐 57개의 도구를 제공해요. 어시스턴트를 연결하려면 [AI 에이전트 개요](/ko/ai-agents)를 참고하세요. **권한 작동 방식** 읽기 도구는 자동으로 실행되며 데이터를 변경하지 않아요. 쓰기 도구(생성, 업데이트, 게시 등)는 먼저 확인을 요청해요. 삭제 도구도 확인을 요청하며 되돌릴 수 없어요. 모든 작업은 본인의 워크스페이스 범위로 제한돼요. ## 스키마 | 도구 | 권한 | 설명 | | -------------------- | -- | -------------------------------------------------------- | | `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 에이전트 개요](/ko/ai-agents)에서 어시스턴트별 단계를 따라 진행하세요.