Sequenzy MCP Server

공식

SaaS용 이메일 마케팅 도구

GitHub
1

문서

Sequenzy MCP 서버

Sequenzy의 공식 MCP 서버로, AI 기반 이메일 마케팅 플랫폼입니다.

Sequenzy를 Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw 및 기타 MCP 클라이언트에 연결하면 AI 어시스턴트가 직접 API 호출을 작성하는 대신 구조화된 도구로 이메일 작업을 관리할 수 있습니다.

가능한 작업

  • 구독자, 태그, 목록 및 동적 세그먼트 관리.
  • Facebook 및 Instagram 리타겟팅을 위해 세그먼트를 Meta 맞춤 타겟에 동기화.
  • 제품 관리 및 구매 자동화를 위한 디지털 전달 파일 첨부.
  • 캠페인 초안 작성, 업데이트, 예약 및 검사.
  • 이벤트 트리거 및 세그먼트 진입 자동화를 포함한 이메일 시퀀스 생성 및 편집.
  • 캠페인 취소, 일시 중지, 재개, 복제 또는 삭제 및 연락처를 시퀀스에 등록.
  • 트랜잭션 이메일 템플릿 관리 및 단일 트랜잭션 이메일 전송.
  • 랜딩 페이지 생성, 편집, 게시, 게시 취소 및 삭제.
  • 게시된 랜딩 페이지를 위한 사용자 정의 도메인 연결 및 확인.
  • 팀 초대, 받은 편지함 대화 및 아웃바운드 웹훅 엔드포인트 관리.
  • 이메일 카피, 제목 줄 및 다단계 시퀀스 생성.
  • 분석, 구독자 활동, 전달성 상태 및 대시보드 URL 검사.
  • 회사 제품 정보, 발신자 웹사이트 및 일반적인 프레임워크에 대한 통합 예제 구성.

게시된 모든 MCP 도구에는 호환 클라이언트가 정확한 도구 사용 어포던스를 표시할 수 있도록 명시적인 readOnlyHint, destructiveHint 및 openWorldHint 주석이 포함됩니다. 또한 도구는 outputSchema 정의를 게시하고 structuredContent을 반환하여 클라이언트와 모델이 후속 호출을 위한 기계 판독 가능한 결과 형태를 제공합니다.

빠른 설정

가장 쉬운 설정 경로는 Sequenzy 마법사입니다:

npx @sequenzy/setup

마법사는 브라우저 로그인 흐름을 열고, 개인 API 키를 생성하며, 지원되는 AI 클라이언트를 감지하고 가능한 경우 자동으로 구성합니다.

호스팅된 원격 MCP

스트리밍 가능한 HTTP MCP를 지원하는 클라이언트의 경우 로컬 stdio 프로세스를 실행하는 대신 Sequenzy의 호스팅된 엔드포인트를 사용하세요:

https://api.sequenzy.com/v1/mcp

원격 클라이언트는 지원되는 경우 Sequenzy OAuth 흐름으로 인증해야 합니다. 로컬 및 자동화 클라이언트는 여전히 SEQUENZY_API_KEY과 함께 아래 stdio 패키지를 사용할 수 있습니다.

기계 판독 가능한 검색 파일:

수동 설정

모든 stdio MCP 클라이언트는 동일한 명령을 사용합니다:

  • 명령: npx
  • 인수: -y @sequenzy/mcp
  • 필수 환경 변수: SEQUENZY_API_KEY=seq_user_your_key_here

선택적 환경 변수:

  • SEQUENZY_API_URL - Sequenzy API 기본 URL. 기본값은 https://api.sequenzy.com입니다.
  • SEQUENZY_APP_URL - 앱 URL 도우미가 사용하는 Sequenzy 대시보드 기본 URL. 기본값은 https://sequenzy.com입니다.

Claude Desktop

Claude Desktop 구성에 다음을 추가하세요:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

구성을 편집한 후 Claude Desktop을 다시 시작하세요.

Claude Code

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- npx -y @sequenzy/mcp

기본 Windows에서는 npx을 cmd /c로 래핑합니다:

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- cmd /c npx -y @sequenzy/mcp

공유 프로젝트 구성의 경우 .mcp.json을 사용하세요:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Codex

codex mcp add sequenzy --env SEQUENZY_API_KEY=seq_user_your_key_here -- npx -y @sequenzy/mcp
codex mcp list

~/.codex/config.toml의 수동 Codex 구성:

[mcp_servers.sequenzy]
command = "npx"
args = ["-y", "@sequenzy/mcp"]

[mcp_servers.sequenzy.env]
SEQUENZY_API_KEY = "seq_user_your_key_here"

Cursor

~/.cursor/mcp.json에 다음을 추가하세요:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Windsurf

Cursor와 동일한 JSON 형태를 사용합니다.

  • macOS: ~/Library/Application Support/Windsurf/mcp.json
  • Windows: %APPDATA%\Windsurf\mcp.json

VS Code Copilot

VS Code는 servers 객체를 사용합니다:

{
  "servers": {
    "sequenzy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

기타 MCP 클라이언트

OpenClaw, Hermes 및 기타 MCP 호환 클라이언트의 경우 클라이언트를 npx -y @sequenzy/mcp로 지정하고 SEQUENZY_API_KEY를 설정하세요.

API 키 얻기

  1. Sequenzy 대시보드를 엽니다.
  2. 설정 -> API 키로 이동합니다.
  3. 개인 키를 생성합니다.
  4. MCP 클라이언트 구성에 키를 추가합니다.

개인 키는 seq_user_으로 시작합니다. 대시보드에서 언제든지 취소할 수 있습니다.

도구

이 서버는 현재 120개의 MCP 도구를 노출합니다.

계정, 회사, 설정

도구설명
get_account계정 정보, 사용 가능한 회사 및 현재 회사를 가져옵니다.
select_company향후 도구 호출을 위한 활성 회사를 설정합니다.
get_app_urls캠페인, 랜딩 페이지, 시퀀스, 이메일, 설정, 도메인 및 전송된 이메일 세부 정보에 대한 대시보드 URL을 빌드합니다.
create_company새 회사 또는 브랜드를 생성합니다.
get_company회사 세부 정보, 제품 정보, 브랜드 색상, AI 작성 컨텍스트 및 현지화 설정을 읽습니다.
update_companyAI가 생성된 이메일에 사용하는 제품 정보 및 브랜드 컨텍스트를 편집합니다.
create_api_key회사용 API 키를 생성합니다.
list_websites구성된 발신자 웹사이트 및 도메인을 나열합니다.
add_website발신자 웹사이트를 추가합니다. 처리에는 약 30초가 소요될 수 있습니다.
check_website웹사이트가 처리되어 준비되었는지 확인합니다.
get_integration_guide프레임워크별 통합 예제를 가져옵니다.

구독자

도구설명
add_subscriber속성, 태그, 상태, 옵트인 모드 및 선택적 목록 ID로 구독자를 추가합니다.
update_subscriber속성을 업데이트하거나 태그를 추가 또는 제거합니다.
remove_subscriber구독자를 구독 취소하거나 완전히 삭제합니다.
get_subscriber이메일 또는 외부 ID로 구독자 세부 정보를 가져옵니다.
search_subscribers쿼리, 태그, 목록, 상태, 세그먼트 또는 페이지 매김으로 검색합니다.

제품 및 디지털 전달

도구설명
list_productsStripe, Shopify, WooCommerce, 수동 또는 Commerce API 데이터에서 동기화된 제품을 나열합니다.
upsert_products제품 ID로 키가 지정된 최대 100개의 Commerce API 제품을 생성하거나 업데이트합니다.
delete_productCommerce API를 통해 이전에 푸시된 제품을 삭제합니다.
attach_product_file호스팅되거나 로컬로 업로드된 전달 파일을 제품에 첨부합니다.
remove_product_file첨부된 제품 전달 파일을 제거합니다.
sync_productsStripe 제품 카탈로그 동기화를 대기열에 추가합니다.

제품 전달 파일이 첨부되면 일치하는 구매 이벤트에 download.url 및 download.name가 포함되므로 구매 트리거 이메일에서 {{event.download.url}}와 같은 병합 태그를 사용할 수 있습니다.

목록, 태그, 세그먼트

도구설명
list_tags모든 태그를 나열합니다.
create_tag선택적 색상으로 태그 정의를 생성합니다.
update_tag태그 색상을 업데이트합니다.
delete_tag태그를 삭제하고 구독자로부터 제거합니다.
list_lists구독자 목록을 나열합니다.
create_list구독자 목록을 생성합니다.
update_list구독자 목록의 이름을 바꾸거나 설명합니다.
delete_list구독자 목록을 삭제합니다.
add_subscribers_to_list이메일 배열에서 최대 500명의 구독자를 목록에 추가합니다.
remove_subscribers_from_list목록에서 최대 500명의 구독자를 제거합니다.
list_segments저장된 세그먼트 및 개수를 나열합니다.
create_segment필터 또는 중첩된 AND/OR 그룹에서 저장된 세그먼트를 생성합니다.
update_segment세그먼트 이름, 필터, 루트 그룹 또는 조인 연산자를 업데이트합니다.
delete_segment저장된 세그먼트를 삭제합니다.
get_segment_count세그먼트의 활성 구독자 수를 미리 봅니다.

구독자 내보내기의 경우 search_subscribers은 listId, 정확한 listName 또는 list(ID 먼저, 그 다음 정확한 이름)를 허용합니다. limit가 생략되면 도구는 100행 API 페이지를 사용하여 일치하는 모든 구독자를 가져옵니다.

대량 목록 채우기의 경우 add_subscribers_to_list을 사용하세요. 백엔드 API 엔드포인트는 POST /api/v1/lists/{listId}/subscribers이며 /bulk 접미사가 없습니다:

{
  "emails": ["[email protected]", "[email protected]"],
  "duplicateStrategy": "skip",
  "enrollInSequences": false,
  "optInMode": "default"
}

요청당 최대 500개의 이메일을 보냅니다. 표준 API 속도 제한이 여전히 적용됩니다: API 키당 분당 100개의 요청 및 초당 20개의 요청 버스트. CSV 기반 CLI 가져오기의 경우 허용되는 이메일 헤더에는 email, e-mail, email address 및 mail가 포함됩니다. 인식된 헤더가 없으면 CLI는 첫 번째 열을 읽습니다.

세그먼트 필터는 속성, 이벤트, 저장된 세그먼트 멤버십, 참여 이벤트, Stripe 제품 구매 규칙 및 상거래 제품 구매 규칙을 지원합니다. 임의 일치 세그먼트에는 filterJoinOperator: "or"을 사용하거나 중첩된 논리를 위해 v2 root 그룹을 전달합니다.

각 세그먼트 필터 필드는 자체 연산자를 검증합니다:

  • status, segment: is, is_not
  • tag: contains, not_contains, is_empty, is_not_empty
  • email: contains, not_contains
  • emailProvider, list: is, is_not, is_empty, is_not_empty
  • firstName, lastName: contains, not_contains, is_empty, is_not_empty
  • added: less_than, more_than
  • attribute: is, is_not, is_empty, is_not_empty, gte, lte, gt, lt, contains, not_contains
  • event, 이메일 참여 필드: is, is_not, at_least, less_than_count
  • emailBounced: is_temporary_bounce, is_permanent_bounce도 지원합니다.
  • stripeProduct: is, is_not, at_least, less_than_count
  • stripeCurrentProduct, stripeTrialProduct: is, is_not, gte, lte, gt, lt
  • commerceProduct: is, is_not, at_least, less_than_count

Stripe 제품 필터 예제:

{ "field": "stripeProduct", "operator": "is", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "is_not", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "at_least", "value": "prod_pro:3" }
{ "field": "stripeProduct", "operator": "less_than_count", "value": "prod_pro:3" }

커머스 제품 필터는 커머스 주문을 통해 구매한 제품과 일치합니다. 값은 제공자 범위 ID의 경우 provider:productId(shopify, woocommerce, 또는 api), 모든 제공자와 일치하는 베어 제품 ID, 또는 임계값 연산자의 경우 provider:productId:count이 될 수 있습니다:

{ "field": "commerceProduct", "operator": "is", "value": "api:starter-kit" }
{ "field": "commerceProduct", "operator": "at_least", "value": "shopify:42:2" }

emailSent, emailDelivered, emailOpened, emailClicked, emailBounced, emailComplained와 같은 인게이지먼트 필드는 7d, 30d, 90d, 180d, all와 같은 롤링 윈도우, 5:30d와 같은 임계값, 또는 campaign:cmp_123와 같은 캠페인 범위를 허용합니다.

오디언스 동기화 (Meta Ads)

도구설명
list_audience_syncs세그먼트-오디언스 동기화를 일정 및 마지막 동기화 상태와 함께 나열합니다.
list_ad_accounts동기화에 사용 가능한 Meta 광고 계정을 나열합니다.
create_audience_sync일정에 따라 세그먼트를 Meta 커스텀 오디언스에 푸시합니다.
update_audience_sync동기화 빈도(hourly, daily, weekly)를 변경하거나 일시 중지/재개합니다.
delete_audience_sync동기화 매핑을 제거합니다. Meta 오디언스 자체는 유지됩니다.
sync_audience_now정기 일정 외에 즉시 업로드를 트리거합니다.

Sequenzy 대시보드(설정 -> 통합)에서 Meta Ads 통합이 연결되어 있어야 합니다. create_audience_sync은 기존 세그먼트(segmentId) 또는 미리 만들어진 템플릿(예: predefinedSegmentId, zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged)을 허용합니다. 템플릿 세그먼트는 처음 사용 시 자동으로 생성되며 첫 업로드가 즉시 실행됩니다.

오디언스는 추가 전용입니다. 나중에 세그먼트를 떠난 구독자는 Meta 오디언스에 남아 있습니다. Meta는 광고 게재에 오디언스를 사용하려면 100명 이상의 일치하는 사람이 필요합니다.

템플릿

도구설명
list_templates현지화 상태와 함께 템플릿을 나열합니다.
get_template템플릿 세부 정보, 콘텐츠 및 현지화된 변형을 읽습니다.
create_templateHTML 또는 Sequenzy 블록에서 템플릿을 생성합니다.
update_template템플릿 메타데이터, 레이블, HTML 또는 블록을 업데이트합니다.
delete_template템플릿을 삭제합니다.

A/B 테스트

도구설명
list_ab_testsA/B 테스트 및 변형을 나열하며, 선택적으로 시퀀스로 범위를 지정합니다.
get_ab_test변형, 콘텐츠 및 현지화 상태를 가져옵니다.
get_ab_test_stats집계 및 변형별 통계를 가져옵니다.
restart_ab_test중지되거나 완료된 A/B 테스트를 다시 시작합니다.
update_ab_test_variant초안 변형 제목, 미리보기 텍스트, HTML 또는 블록을 업데이트합니다.
create_ab_test캠페인 또는 시퀀스 A/B 테스트를 생성합니다.
add_ab_test_variant기존 A/B 테스트에 변형을 추가합니다.
delete_ab_test_variant초안 A/B 테스트 변형을 삭제합니다.
delete_ab_testA/B 테스트를 삭제합니다.

편집하기 전에 변형 ID를 찾으려면 get_ab_test를 사용하세요. 변형 업데이트는 html 또는 blocks 중 하나만 허용하며 둘 다 허용하지 않습니다.

캠페인

도구설명
list_campaigns캠페인을 나열하며, 선택적으로 상태별로 필터링합니다.
get_campaign캠페인 세부 정보 및 통계를 가져옵니다.
get_email_send전송된 이메일 세부 기록을 검사합니다.
create_campaignHTML, 블록, 템플릿 또는 캠페인 데이터에서 초안 캠페인을 생성합니다.
update_campaign캠페인 데이터 및 계산된 목록을 포함하여 초안 캠페인을 업데이트합니다.
schedule_campaign초안을 예약하거나 기존 예약된 캠페인을 다시 예약합니다.
send_test_email하나의 주소로 테스트 이메일을 보냅니다.
cancel_campaign예약되었거나 전송 중인 캠페인을 취소합니다.
pause_campaign전송 중인 캠페인을 일시 중지합니다.
resume_campaign일시 중지된 캠페인을 재개하며, 선택적으로 시간 경과에 따라 전송을 분산합니다.
delete_campaign캠페인을 삭제합니다.
duplicate_campaign캠페인을 새 초안으로 복제합니다.
resend_campaign_to_non_openers전송된 캠페인을 열지 않은 원래 오디언스 멤버를 위한 초안 재전송을 생성합니다.

랜딩 페이지

도구설명
list_landing_pages상태, 지표, 콘텐츠 및 URL과 함께 랜딩 페이지를 나열합니다.
get_landing_page랜딩 페이지 세부 정보, 빌더 콘텐츠, 지표 및 공개 URL을 가져옵니다.
create_landing_page기본 템플릿 콘텐츠 또는 JSON에서 초안 랜딩 페이지를 생성합니다.
update_landing_page랜딩 페이지 이름, 슬러그 또는 전체 편집기 호환 콘텐츠를 편집합니다.
publish_landing_page랜딩 페이지를 게시하며, 선택적으로 편집 내용을 먼저 저장합니다.
unpublish_landing_page랜딩 페이지를 초안 상태로 되돌리며, 선택적으로 편집 내용을 먼저 저장합니다.
delete_landing_page게시되지 않은 랜딩 페이지를 삭제합니다.
connect_landing_page_domain커스텀 랜딩 페이지 도메인을 연결하고 DNS 설정 세부 정보를 반환합니다.
update_landing_page_domain_settings랜딩 페이지 커스텀 도메인 설정을 교체하거나 확인합니다.

랜딩 페이지 콘텐츠는 version, template, seo, theme, blocks이 포함된 Sequenzy의 편집기 호환 JSON 스키마를 사용합니다. 커스텀 랜딩 페이지 도메인에는 pages.sequenzydns.com를 가리키는 CNAME 레코드가 필요합니다. DNS 변경 사항이 전파된 후 verify: true과 함께 update_landing_page_domain_settings를 호출하세요.

시퀀스

도구설명
list_sequences이메일 시퀀스 및 자동화 상태를 나열합니다.
get_sequence단계 nodeId, 연결된 emailId, 제목, 미리보기 텍스트 및 블록을 포함한 시퀀스 세부 정보를 가져옵니다.
create_sequenceAI 생성 또는 명시적 단계 시퀀스를 생성합니다.
update_sequence시퀀스 설정, 등록 동작, 기존 단계, 분기 논리를 업데이트하거나 선형 단계를 삽입합니다.
insert_sequence_step하나의 새 이메일 단계를 삽입하며, 선택적으로 그 앞에 지연 노드를 둡니다.
enable_sequence시퀀스를 활성화합니다.
disable_sequence시퀀스를 동결하여 새 등록을 차단하고 현재 수신자를 보류합니다.
pause_sequence_enrollments현재 수신자가 계속 진행되는 동안 활성 시퀀스에 대한 새 등록을 중지합니다.
resume_sequence_enrollments현재 수신자를 변경하지 않고 활성 시퀀스에 대한 새 등록을 다시 엽니다.
enroll_subscribers_in_sequence이메일, 구독자 ID 또는 둘 다로 최대 500명의 구독자를 등록하며, 선택적으로 대상 노드에서 등록합니다.
cancel_sequence_enrollments구독자 또는 진입 이벤트 필드 값으로 활성 또는 대기 중인 등록을 중지합니다.
delete_sequence시퀀스를 삭제합니다.

시퀀스 생성은 다음을 지원합니다:

  • 저장된 세그먼트 진입 자동화를 위한 trigger: "segment_entered" 및 segmentId.
  • 제목 또는 본문 콘텐츠의 trigger: "event_received" 및 {{event.*}} 병합 태그.
  • trigger: "inactivity" 및 eventName, inactiveDays, 그리고 선택적 inactivityBaseline(sequence_created_at 또는 subscriber_created_at).
  • AI 생성 이메일 콘텐츠를 위한 goal.
  • Sequenzy blocks을 사용한 명시적 steps.
  • HTML을 사용한 명시적 steps으로, Sequenzy가 편집 가능한 블록으로 변환합니다.
  • delay / delayMs을 통한 고정 대기, 또는 갱신 알림, 약속 후속 조치, 평가판 만료 알림 및 기타 이벤트별 날짜를 위한 waitUntil을 통한 동적 날짜 필드 대기.
  • {{discount.code}} 및 {{discount.percentOff}}와 같은 병합 태그를 노출하는 할인 액션 단계.
  • 제품, 변형, 주문 또는 구독별 이벤트 자동화를 위한 enrollmentMode: "matching_field" 및 enrollmentFieldPath.

시퀀스 업데이트는 get_sequence에서 반환된 nodeId 뒤에 새 선형 단계를 추가하기 위한 insertSteps을 지원합니다. 정확히 하나의 선형 꼬리가 있는 시퀀스에 추가할 때만 afterNodeId을 생략하세요. insertSteps은 이메일, 지연, 태그/목록 액션, 속성 업데이트, 할인, 조건, 이벤트 대기 단계 및 웹훅과 같은 동반 레코드가 필요하지 않은 추가 가능한 단계를 지원합니다. 다중 경로 if/else 분기에는 branch를 사용하세요. branch 또는 insertSteps 중 하나만 제공하고 둘 다 제공하지 마세요. 분기 조건은 has_tag 및 does_not_have_tag을 사용한 태그 존재 및 부재 확인과 목록, 저장된 세그먼트, 이벤트, 클릭된 링크 및 필드 비교를 지원합니다. emails 및 steps 배열은 nodeId, emailId 또는 배열 순서로 기존 이메일 단계만 편집합니다. 새 단계를 생성하려면 insertSteps을 사용하고 삽입된 이메일에 타이머가 필요한 경우 단계 수준 delay, delayMs 또는 waitUntil를 포함하세요. waitUntil는 트리거 이벤트의 날짜 필드와 선택적 offset, direction(before 또는 after), missingAction(continue 또는 exit)을 허용합니다. 활성 시퀀스의 경우, 라이브 흐름 영향을 확인한 후에만 insertSteps 또는 branch와 함께 confirmStructuralChange: true을 전달하세요.

대량 취소를 적용하기 전에 dryRun: true과 함께 cancel_sequence_enrollments을 실행하세요.

이메일 블록 스타일링

blocks을 허용하는 도구는 블록의 styles 객체 아래에 블록별 시각적 스타일링을 유지합니다:

{
  "type": "card",
  "title": "Your update",
  "content": "Everything is ready.",
  "variant": "default",
  "styles": {
    "backgroundColor": "#f8fafc",
    "backgroundOpacity": 85,
    "borderColor": "#cbd5e1",
    "borderWidth": 1,
    "borderRadius": 12
  }
}

이전 에이전트 프롬프트와의 호환성을 위해 backgroundColor, backgroundOpacity, borderColor, borderWidth, borderRadius와 같은 최상위 스타일 키도 허용되며 styles 아래에 저장됩니다.

트랜잭셔널 이메일

도구설명
list_transactional_emails트랜잭셔널 템플릿과 API 슬러그를 나열합니다.
get_transactional_emailID 또는 슬러그로 트랜잭셔널 이메일을 읽습니다.
create_transactional_email트랜잭셔널 이메일 템플릿을 생성합니다.
update_transactional_email트랜잭셔널 메타데이터 또는 본문 내용을 업데이트합니다.
send_email템플릿 또는 HTML로 단일 트랜잭셔널 이메일을 전송합니다.

send_email 변수는 { "event": { "items": [...] } }와 같은 반복 블록을 위한 중첩 배열을 지원합니다.

분석

도구설명
get_stats7d, 30d 또는 90d에 대한 개요 통계를 가져옵니다.
get_campaign_stats상세 캠페인 성과를 가져옵니다.
get_sequence_stats시퀀스 성과를 가져옵니다.
list_campaign_events캠페인에 대한 페이지네이션된 원시 이메일 이벤트를 나열합니다.
list_sequence_events시퀀스에 대한 페이지네이션된 원시 이메일 이벤트를 나열합니다.
get_subscriber_activity구독자 이메일 통계, 활동 및 등록 정보를 가져옵니다.

분석 도구는 기본적으로 감지된 봇, 스캐너, 링크 미리보기 및 추적된 자산 열람/클릭을 제외합니다. 원시 인게이지먼트 진단이 필요한 경우 includeMachineEngagement: true를 get_stats, get_campaign_stats, get_sequence_stats, get_ab_test_stats, get_subscriber 또는 get_subscriber_activity에 전달하세요. 포함된 열람/클릭 활동 행에는 API가 이벤트 수준 활동을 반환하는 machine, engagementQuality 및 classificationReasons 필드가 노출됩니다.

팀, 받은 편지함, 웹훅

도구설명
list_team_members팀 구성원 및 보류 중인 초대를 나열합니다.
invite_team_member관리자 또는 뷰어로 팀원을 초대하며, 선택적으로 청구 접근 권한을 부여합니다.
cancel_team_invitation보류 중인 팀 초대를 취소합니다.
list_conversations상태 및 읽지 않음 필터로 구독자 답장 대화를 나열합니다.
get_conversation대화 및 해당 메시지 기록을 읽습니다.
reply_to_conversation아웃바운드 답장을 보내거나 내부 메모를 추가합니다.
update_conversation_status대화를 열거나 닫습니다.
mark_conversation_read대화의 모든 메시지를 읽음으로 표시합니다.
list_webhooks아웃바운드 웹훅 엔드포인트를 나열합니다.
create_webhook아웃바운드 웹훅을 생성하고 일회성 서명 비밀 키를 반환합니다.
update_webhook웹훅 이름, URL, 이벤트 또는 상태를 업데이트합니다.
delete_webhook웹훅 엔드포인트 및 전송 기록을 영구적으로 삭제합니다.
test_webhook웹훅 엔드포인트에 테스트 이벤트를 전송합니다.
list_webhook_deliveries웹훅에 대한 최근 전송 시도를 나열합니다.
replay_webhook_delivery웹훅 전송을 재생합니다.

AI 생성

도구설명
generate_email프롬프트에서 이메일 블록을 생성합니다.
generate_sequence목표에서 다중 이메일 시퀀스를 생성합니다.
generate_subject_linesA/B 제목 줄 변형을 생성합니다.

생성된 콘텐츠는 검토를 위해 초안 콘텐츠로 반환됩니다.

리소스

서버는 읽기 전용 MCP 리소스도 노출합니다.

리소스설명
sequenzy://dashboard지난 7일간의 실시간 개요 통계입니다.
sequenzy://company현재 회사 및 현지화 설정입니다.
sequenzy://campaigns/recent상태 및 기본 통계가 포함된 최근 10개의 캠페인입니다.
sequenzy://subscribers/recent가장 최근에 추가된 구독자입니다.
sequenzy://subscribers/engaged가장 활동적이거나 참여도가 높은 구독자입니다.
sequenzy://sequences상태가 포함된 모든 시퀀스입니다.
sequenzy://templates현지화 상태가 포함된 템플릿입니다.
sequenzy://segments구독자 수가 포함된 저장된 세그먼트입니다.
sequenzy://tags사용 횟수가 포함된 태그입니다.
sequenzy://health전달성 지표 및 상태 점검입니다.
sequenzy://app-routes대시보드 경로 템플릿 및 설정 탭입니다.

예시 프롬프트

Add [email protected] with tags "vip" and "developer", then put them on the beta list.

Create a 4-email churn prevention sequence for users whose subscription expires soon. Leave it in draft mode.

Create a segment for subscribers who bought Stripe product prod_pro at least 3 times.

Draft a campaign about our new analytics dashboard, target the Pro users segment, and send a test to me.

How did the last campaign perform compared with the one before it?

보안

  • 공유 팀 비밀이 아닌 개인 API 키를 사용하세요.
  • 키는 Sequenzy 사용자가 접근할 수 있는 회사에만 접근합니다.
  • 더 이상 접근이 필요하지 않으면 설정 -> API 키에서 키를 취소하세요.
  • 전송, 예약, 삭제 및 대량 변경에 대해 클라이언트 승인 프롬프트를 활성화된 상태로 유지하세요.
  • 캠페인 및 시퀀스에 대해 초안 워크플로를 선호하고, 시작 전에 Sequenzy에서 검토하세요.

문제 해결

SEQUENZY_API_KEY environment variable is required

MCP 클라이언트 구성에서 SEQUENZY_API_KEY를 설정하거나 다음을 실행하세요:

npx @sequenzy/setup

유효하지 않은 API 키

설정 -> API 키에서 새 개인 키를 생성하고, MCP 구성을 업데이트한 다음 클라이언트를 다시 시작하세요.

중복 리소스

도구 호출이 중복된 세그먼트 이름 또는 전송 도메인을 생성하려고 하면, 서버는 안정적인 code, 에이전트 친화적인 description, 구체적인 resolution 및 docsUrl을 반환합니다. 세그먼트의 경우 list_segments을 호출하고 기존 세그먼트 ID를 재사용하거나 다른 이름을 선택하세요. 웹사이트의 경우 list_websites을 호출하세요. 선택한 회사에 대해 도메인이 나열되지 않은 경우, 해당 도메인은 다른 회사 또는 계정에 속하므로 제거하거나 재할당하거나 다른 전송 도메인으로 교체해야 합니다.

도구가 나타나지 않음

  • 클라이언트가 사용하는 환경에서 npx을 사용할 수 있는지 확인하세요.
  • 구성을 편집한 후 MCP 클라이언트를 다시 시작하세요.
  • 구성이 올바른 클라이언트별 위치에 있는지 확인하세요.

네트워크 또는 API URL 문제

서버는 기본적으로 https://api.sequenzy.com을 사용합니다. 이를 재정의하는 경우 SEQUENZY_API_URL이 연결 가능한 Sequenzy API 기본 URL을 가리키는지 확인하세요.

개발

bun install
bun test
bun run type-check
bun run build

MCP 도구 스키마는 엄격한 클라이언트와 호환되어야 합니다:

  • 도구 inputSchema 루트는 일반 type: "object" 스키마여야 합니다.
  • 도구 스키마의 어느 곳에도 anyOf을 게시하지 마세요.
  • 도구 스키마의 루트에 oneOf, allOf, enum 또는 not을 배치하지 마세요.
  • 핸들러에서 조건부 요구 사항을 적용하고 테스트로 이를 다루세요.

이 독립형 저장소는 기본 Sequenzy 모노레포에서 유지 관리되는 MCP 패키지를 미러링합니다. 동기화 규칙은 AGENTS.md를 참조하세요.

라이선스

MIT

에이전트 네이티브 검색

Sequenzy는 에이전트 네트워크 및 A2A 스타일 검색을 위한 기계 판독 가능 매니페스트를 게시합니다:

이 파일들은 Sequenzy를 에이전트를 위한 승인된 이메일 자동화 기능으로 설명합니다. 스크래핑, 스팸 및 원치 않는 콜드 아웃리치 사용 사례는 명시적으로 제외됩니다.