도구 레퍼런스

연결된 어시스턴트가 호출할 수 있는 모든 도구를, 서버가 등록한 것과 동일한 방식으로 그룹화했습니다. 도구는 사용자의 연결이 필요한 스코프를 보유하고 있을 때만 어시스턴트에 제공됩니다 — 존재는 하지만 항상 오류를 내는 쓰기 도구 같은 것은 없습니다. 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 | | 트리 편집으로, 스튜디오 내 코파일럿의 편집과 동일한 방식으로 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 | | 현재 프로젝트를 재사용 가능한 템플릿으로 스냅샷합니다. |

수신자

| 도구 | 스코프 | 파괴적 | 참고 | | --- | --- | :-: | --- | | list_data_sources | contacts:read | | 연락처 리스트를 포함한 모든 데이터 소스. 자격 증명 값은 절대 반환되지 않습니다. | | list_contact_lists | contacts:read | | 연락처 리스트만 — id, 이름, 필드, 행 수. | | get_contact_list_summary | contacts:read | | 개수와 수신 거부 합계 — 개별 연락처 데이터는 없습니다. | | find_contacts | contacts:read | | 제한된 조회(최대 25행, 커서 기반 페이지네이션). 모든 호출은 대시보드의 연락처 조회와 마찬가지로 개인정보 접근 로그에 기록됩니다. | | upsert_contacts | contacts:write | | 행을 추가하거나 수정합니다. 요금제의 연락처 상한을 적용합니다. | | remove_contact | contacts:write | ✓ | 행 하나를 영구히 제거합니다. | | add_suppression / remove_suppression | contacts:write | | 계정 전체에서 주소를 차단하거나 차단 해제합니다 — 수신자 본인의 수신 거부 링크와 동일한 효과입니다. |

결과

| 도구 | 스코프 | 파괴적 | 참고 | | --- | --- | :-: | --- | | get_campaign_results | analytics:read | | 오픈/클릭/응답/매출, A/B 변형 비교, 클릭 히트맵. 요약된 정보만 제공하며 원시 수신자별 이벤트는 절대 제공하지 않습니다. 위젯이 연결되어 있습니다. | | 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 | 오너 메시지를 추가하고 수신자에게 돌아갈 수 있는 링크를 이메일로 보냅니다. |

계정

| 도구 | 스코프 | 참고 | | --- | --- | --- | | get_plan_usage | 없음 — 항상 사용 가능 | 요금제, 할당량, 이번 달 사용량. 읽기 전용이며 프로젝트/연락처/메일함처럼 민감한 계정 데이터가 아니므로, 어떤 스코프를 부여했는지와 관계없이 항상 이용할 수 있습니다. |

위젯

MCP Apps를 지원하는 호스트(Claude — Gemini에는 위젯 레이어가 없어 항상 일반 텍스트/JSON 결과를 받습니다)에서는 세 가지 도구가 인터랙티브 위젯을 함께 표시합니다: preview_email(실시간 데스크톱/모바일 이메일 미리보기), get_campaign_results(결과 대시보드), prepare_send(발송 확인 카드 — 이 카드의 자체 Confirm & Send 버튼이 실제로 confirm_send를 호출합니다).