도구 레퍼런스
연결된 어시스턴트가 호출할 수 있는 모든 도구를, 서버가 등록한 것과 동일한 방식으로 그룹화했습니다. 도구는 사용자의 연결이 필요한 스코프를 보유하고 있을 때만 어시스턴트에 제공됩니다 — 존재는 하지만 항상 오류를 내는 쓰기 도구 같은 것은 없습니다. contacts:write를 부여하지 않았다면 어시스턴트는 upsert_contacts 자체를 아예 보지 못합니다. 각 스코프의 의미는 스코프 및 권한을 참고하세요.
아래 표의 파괴적은 Claude 자체의 심사 절차가 요구하는 것과 동일한 MCP 어노테이션으로, 효과를 쉽게 되돌릴 수 없는 도구(프로젝트 삭제, 트리 덮어쓰기, 연락처 제거)를 표시할 뿐이며 막연한 의미의 "위험함"을 뜻하지 않습니다. 모든 쓰기 도구는 예상되는 필드만 받으며, 모델이 임의의 변경을 몰래 밀어넣을 수 있는 원시 페이로드를 받는 도구는 하나도 없습니다.
검색
| 도구 | 스코프 | 참고 |
|---|
search | projects:read / templates:read / contacts:read 중 하나 | 이름으로 프로젝트, 템플릿, 연락처 리스트를 검색합니다. fetch용 불투명 id를 반환합니다. 딥 리서치가 가능한 클라이언트가 자동으로 호출하는 도구입니다. |
fetch | search와 동일 | search의 id 하나를 전체 콘텐츠로 해석합니다. |
이메일 디자인
| 도구 | 스코프 | 파괴적 | 참고 |
|---|
list_projects | projects:read | | 모든 프로젝트의 id, 이름, 목적. |
get_email | projects:read | | 프로젝트의 프리헤더, 현재 블록 트리, 테마와 응답 설정. |
preview_email | projects:read | | 실제 발송 메일 HTML 파이프라인을 그대로 거쳐 렌더링합니다 — 발송 시 생성될 문서와 동일합니다. 위젯이 연결되어 있습니다(아래 참고). |
list_block_types | projects:read | | 실제 레지스트리에서 생성되는 전체 44개 블록 카탈로그 — 항상 최신 상태이며 수작업으로 관리되지 않습니다. |
list_templates | projects:read | | 사용자가 저장한 템플릿 또는 승인된 커뮤니티 갤러리. |
create_project | projects:write | | 내장 목적별 템플릿으로 시드할 수 있으며 프리헤더도 지정할 수 있습니다(선택 사항). |
add_block / update_block / move_block | projects:write | | 트리 편집으로, 스튜디오 내 Mia AI의 편집과 동일한 방식으로 canPlace/필드 검증을 거칩니다. |
remove_block | projects:write | ✓ | 블록과 그 하위 블록을 삭제합니다. |
set_theme | projects:write | | 브랜드 색상, 폰트, 글자 크기 체계, 버튼 스타일, 링크 스타일, 블록 간격, 카드 레이아웃, 다크 모드. |
rename_project | projects:write | | |
delete_project | projects:write | ✓ | 영구 삭제. |
apply_template | projects:write | ✓ | 프로젝트의 전체 트리와 테마를 덮어씁니다. |
save_as_template | templates:write | | 현재 프로젝트를 재사용 가능한 템플릿으로 스냅샷합니다. |
publish_landing_page | projects:write | | 이메일을 /lp/<slug>의 공개 웹 페이지로 게시하고 URL을 반환합니다. 발송과 마찬가지로, 어시스턴트는 먼저 이메일을 보여 주고 승인을 받도록 안내되어 있습니다. |
unpublish_landing_page | projects:write | | 페이지를 내립니다. 주소는 계속 예약되어 있습니다. |
set_response_settings | projects:write | | 완료된 응답의 기준을 정합니다. 포함되는 모든 블록 또는 아무 응답, 포함되는 블록, 마지막 메시지, 선택 사항인 https 리디렉션. |
수신자
| 도구 | 스코프 | 파괴적 | 참고 |
|---|
list_data_sources | contacts:read | | 연락처 리스트를 포함한 모든 데이터 소스. 자격 증명 값은 절대 반환되지 않습니다. |
list_contact_lists | contacts:read | | 연락처 리스트만 — id, 이름, 필드, 행 수. |
get_contact_list_summary | contacts:read | | 개수, 수신 거부 합계, 이메일 확인 결과 분포, 마지막 재확인 상태 — 개별 연락처 데이터는 없습니다. |
find_contacts | contacts:read | | 제한된 조회(최대 25행, 커서 기반 페이지네이션). sortBy: "engagementScore"를 지정하면 목록의 유망 연락처를 점수와 이번 주 변화와 함께 높은 순으로 반환합니다. 모든 호출은 대시보드의 연락처 조회와 마찬가지로 개인정보 접근 로그에 기록됩니다. |
upsert_contacts | contacts:write | | 행을 추가하거나 수정합니다. 요금제의 연락처 상한을 적용합니다. |
remove_contact | contacts:write | ✓ | 행 하나를 영구히 제거합니다. |
add_suppression / remove_suppression | contacts:write | | 계정 전체에서 주소를 차단하거나 차단 해제합니다 — 수신자 본인의 수신 거부 링크와 동일한 효과입니다. |
결과
| 도구 | 스코프 | 파괴적 | 참고 |
|---|
get_campaign_results | analytics:read | | 오픈/클릭/응답/매출, A/B 변형 비교, 클릭 히트맵. 요약된 정보만 제공하며 원시 수신자별 이벤트는 절대 제공하지 않습니다. 위젯이 연결되어 있습니다. |
get_email_insights | analytics:read | | Insights 보기 하나(개요, 블록, 단일 블록, 오디언스, 교차표, 발송, 참여)를 집계값으로 반환하며, 날짜·발송·변형·목록 필터를 선택적으로 적용할 수 있습니다. 페이지와 같은 숫자이며, 오디언스와 교차표는 Pro 이상이 필요합니다. 차이는 관찰된 것이며 검정된 것이 아닙니다. |
get_form_responses | analytics:read | | 질문별 집계. 자유 서술 답변은 개수가 제한되고 격리 처리된 샘플입니다. |
list_orders | analytics:read | | 상품 블록 체크아웃 주문. |
list_campaign_sends | analytics:read | | 과거 대량 발송, 최신순. |
list_schedules | analytics:read | | 프로젝트에 설정된 반복 발송. |
mark_order_fulfilled | commerce:write | | 실물 주문을 발송 완료로 표시하고 구매자에게 이메일을 보냅니다. |
create_schedule | campaigns:send | | 새 반복 발송을 구성합니다. |
set_schedule_enabled | campaigns:send | ✓ | 활성화된 일정을 끄면 이후 발송이 조용히 중단되므로 파괴적으로 표시됩니다. |
발송
| 도구 | 스코프 | 파괴적 | 참고 |
|---|
send_test_email | campaigns:read | | 지정한 주소 하나로 [Test] 접두사가 붙은 사본 한 통을 보냅니다 — 실제 수신자에게 영향을 주지 않으며 campaigns:send가 필요하지 않습니다. |
prepare_send | campaigns:send | | 어노테이션상 읽기 전용입니다 — 수신자를 확정하고 미리보기를 렌더링할 뿐 아무것도 발송하지 않습니다. confirmationToken과 함께, 유효하지 않은 주소나 동의 없음으로 건너뛸 연락처 수를 반환합니다. 위젯이 연결되어 있습니다(발송 확인 카드). |
confirm_send | campaigns:send | ✓ | prepare_send가 반환한 것과 정확히 동일한 confirmationToken을 10분 이내에 변경 없이 그대로 요구합니다. 이유는 보안을 참고하세요. |
메일함 및 티켓
| 도구 | 스코프 | 참고 |
|---|
list_mailbox_threads / get_mailbox_thread | mailbox:read | 인증된 도메인으로 수신된 메일. 메시지 본문은 신뢰할 수 없는, 수신자가 작성한 콘텐츠로 격리 처리됩니다. |
reply_to_mailbox_thread | mailbox:write | 원본 메일이 도착한 바로 그 메일함 주소에서, 올바르게 스레드로 묶여 발송됩니다. |
list_tickets / get_ticket | mailbox:read | 지원 티켓 대화. 동일한 신뢰할 수 없는 콘텐츠 격리 처리가 적용됩니다. |
reply_to_ticket | mailbox:write | 오너 메시지를 추가하고 수신자에게 돌아갈 수 있는 링크를 이메일로 보냅니다. |
여정 및 세그먼트
| 도구 | 스코프 | 파괴적 | 참고 |
|---|
list_journeys | journeys:read | | 모든 여정의 ID, 이름, 켜짐/꺼짐, 트리거 종류, 단계 수. |
get_journey | journeys:read | | 이메일·목록·세그먼트 이름이 포함된 여정의 전체 흐름과, 실행을 막는 문제. 꺼져 있고 실행 가능한 여정이면 enableToken도 반환합니다. |
list_segments | journeys:read | | 저장된 세그먼트와 그 연락처 목록 및 규칙. |
create_segment | journeys:write | | 하나의 연락처 목록에 세그먼트를 저장합니다. 요금제의 세그먼트 한도가 적용됩니다. |
build_journey | journeys:write | | 일상 언어 요청으로 여정 빌더의 Mia AI를 사용해 새 여정을 만들거나 꺼진 여정을 편집합니다. Mia AI 1턴을 사용합니다. 결과는 항상 꺼진 상태로 저장되며, 켜진 여정은 절대 변경하지 않습니다. |
set_journey_enabled | journeys:write (켜려면 + campaigns:send) | ✓ | 여정을 켜려면 get_journey가 반환한 enableToken을 변경 없이, 10분 이내에, 그 사이 편집 없이 전달해야 합니다. prepare_send/confirm_send와 같은 2단계 방식입니다. 일시 중지에는 둘 다 필요하지 않습니다. |
실험
| 도구 | 스코프 | 파괴적 | 참고 |
|---|
list_experiments | analytics:read | | A/B 실험을 최신순으로 나열합니다. 발송 실험과 여정 실험 모두 포함합니다. 상태, 그룹, 지표, 분석 엔진의 최신 결과, 기록된 결정, 결과 페이지 링크를 돌려줍니다. 상태, 종류, 이메일, 여정으로 거를 수 있습니다. |
get_experiment_results | analytics:read | | 실험 하나의 보고서(결과 페이지의 JSON 내보내기와 같은 내용)와 분석 엔진의 결과 한 줄을 돌려줍니다. 어시스턴트는 그 한 줄만이 판정이라고 안내받으므로, 엔진이 승자를 정했을 때만 승자를 말합니다. |
create_experiment_draft | projects:write | | 이메일 하나에 발송 실험 초안을 만듭니다. 이름, 가설, 지표, 그리고 요금제가 허용하는 수까지의 그룹을 균등하게 나눠 설정합니다. 아무것도 발송하지 않습니다. 대상 설정, 잠그기, 시작은 돌려받은 링크로 대시보드에서 합니다. 여정 실험은 분할 단계에서 만듭니다. |
실험을 잠그거나 시작하거나 결정하거나 배포하는 도구는 없습니다. 이 단계는 대시보드에서 직접 합니다.
계정
| 도구 | 스코프 | 참고 |
|---|
get_plan_usage | 없음 — 항상 사용 가능 | 요금제, 할당량, 이번 달 사용량. 읽기 전용이며 프로젝트/연락처/메일함처럼 민감한 계정 데이터가 아니므로, 어떤 스코프를 부여했는지와 관계없이 항상 이용할 수 있습니다. |
위젯
MCP Apps를 지원하는 호스트(Claude — Gemini에는 위젯 레이어가 없어 항상 일반 텍스트/JSON 결과를 받습니다)에서는 세 가지 도구가 인터랙티브 위젯을 함께 표시합니다: preview_email(실시간 데스크톱/모바일 이메일 미리보기), get_campaign_results(결과 대시보드), prepare_send(발송 확인 카드 — 이 카드의 자체 Confirm & Send 버튼이 실제로 confirm_send를 호출합니다).