Sequenzy MCP Server

Sequenzy MCP Server

Máy chủ MCP chính thức cho Sequenzy, nền tảng tiếp thị email được hỗ trợ bởi AI.

Kết nối Sequenzy với Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw và các máy khách MCP khác để trợ lý AI của bạn có thể quản lý các hoạt động email bằng các công cụ có cấu trúc thay vì các lệnh gọi API thủ công.

Những Gì Bạn Có Thể Làm

• Quản lý người đăng ký, thẻ, danh sách và phân khúc động.
• Đồng bộ phân khúc với đối tượng tùy chỉnh Meta để nhắm mục tiêu lại trên Facebook và Instagram.
• Quản lý sản phẩm và đính kèm tệp phân phối kỹ thuật số cho các tự động hóa mua hàng.
• Soạn thảo, cập nhật, lên lịch và kiểm tra chiến dịch.
• Tạo và chỉnh sửa chuỗi email, bao gồm tự động hóa kích hoạt sự kiện và gia nhập phân khúc.
• Hủy, tạm dừng, tiếp tục, sao chép hoặc xóa chiến dịch và đăng ký liên hệ vào chuỗi.
• Quản lý mẫu email giao dịch và gửi email giao dịch đơn lẻ.
• Tạo, chỉnh sửa, xuất bản, hủy xuất bản và xóa trang đích.
• Kết nối và xác minh tên miền tùy chỉnh cho các trang đích đã xuất bản.
• Quản lý lời mời nhóm, hội thoại hộp thư đến và điểm cuối webhook gửi đi.
• Tạo bản sao email, dòng tiêu đề và chuỗi nhiều bước.
• Kiểm tra phân tích, hoạt động người đăng ký, tình trạng khả năng gửi và URL bảng điều khiển.
• Cấu hình thông tin sản phẩm công ty, trang web người gửi và ví dụ tích hợp cho các framework phổ biến.

Mỗi công cụ MCP đã xuất bản bao gồm các chú thích readOnlyHint, destructiveHint và openWorldHint rõ ràng để các máy khách tương thích có thể hiển thị các khả năng sử dụng công cụ chính xác. Các công cụ cũng xuất bản định nghĩa outputSchema và trả về structuredContent, cung cấp cho máy khách và mô hình các hình dạng kết quả có thể đọc được bằng máy cho các lệnh gọi tiếp theo.

Thiết Lập Nhanh

Cách thiết lập dễ nhất là trình hướng dẫn Sequenzy:

npx @sequenzy/setup

Trình hướng dẫn mở luồng đăng nhập trình duyệt, tạo khóa API cá nhân, phát hiện các máy khách AI được hỗ trợ và tự động cấu hình chúng khi có thể.

MCP Từ Xa Được Lưu Trữ

Đối với các máy khách hỗ trợ MCP HTTP có thể truyền phát, hãy sử dụng điểm cuối được lưu trữ của Sequenzy thay vì chạy quy trình stdio cục bộ:

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

Máy khách từ xa nên xác thực bằng luồng OAuth của Sequenzy khi được hỗ trợ. Máy khách cục bộ và tự động hóa vẫn có thể sử dụng gói stdio bên dưới với SEQUENZY_API_KEY.

Tệp khám phá có thể đọc được bằng máy:

• Tệp kê khai máy chủ MCP: server.json
• Thẻ tác nhân: .well-known/agent-card.json
• Tệp kê khai khả năng tác nhân: agent-capability.json
• Siêu dữ liệu kỹ năng OpenClaw: openclaw/skill.json

Thiết Lập Thủ Công

Tất cả các máy khách MCP stdio sử dụng cùng một lệnh:

• Lệnh: npx
• Đối số: -y @sequenzy/mcp
• Biến môi trường bắt buộc: SEQUENZY_API_KEY=seq_user_your_key_here

Biến môi trường tùy chọn:

• SEQUENZY_API_URL - URL cơ sở API Sequenzy. Mặc định là https://api.sequenzy.com.
• SEQUENZY_APP_URL - URL cơ sở bảng điều khiển Sequenzy được sử dụng bởi các trình trợ giúp URL ứng dụng. Mặc định là https://sequenzy.com.

Claude Desktop

Thêm phần này vào cấu hình Claude Desktop của bạn:

• 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"
      }
    }
  }
}

Khởi động lại Claude Desktop sau khi chỉnh sửa cấu hình.

Claude Code

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

Trên Windows gốc, bọc npx bằng cmd /c:

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

Đối với cấu hình dự án dùng chung, sử dụng .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

Cấu hình Codex thủ công trong ~/.codex/config.toml:

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

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

Cursor

Thêm phần này vào ~/.cursor/mcp.json:

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

Windsurf

Sử dụng cùng định dạng JSON như Cursor.

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

VS Code Copilot

VS Code sử dụng đối tượng servers:

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

Các Máy Khách MCP Khác

Đối với OpenClaw, Hermes và các máy khách tương thích MCP khác, trỏ máy khách đến npx -y @sequenzy/mcp và đặt SEQUENZY_API_KEY.

Lấy Khóa API

1. Mở bảng điều khiển Sequenzy.
2. Đi tới Cài đặt -> Khóa API.
3. Tạo khóa cá nhân.
4. Thêm khóa vào cấu hình máy khách MCP của bạn.

Khóa cá nhân bắt đầu bằng seq_user_. Bạn có thể thu hồi chúng bất kỳ lúc nào trong bảng điều khiển.

Công Cụ

Máy chủ này hiện cung cấp 120 công cụ MCP.

Tài Khoản, Công Ty, Thiết Lập

Công cụ	Mô tả
get_account	Lấy thông tin tài khoản, các công ty có sẵn và công ty hiện tại.
select_company	Đặt công ty đang hoạt động cho các lệnh gọi công cụ trong tương lai.
get_app_urls	Xây dựng URL bảng điều khiển cho chiến dịch, trang đích, chuỗi, email, cài đặt, tên miền và chi tiết email đã gửi.
create_company	Tạo công ty hoặc thương hiệu mới.
get_company	Đọc chi tiết công ty, thông tin sản phẩm, màu thương hiệu, ngữ cảnh viết AI và cài đặt bản địa hóa.
update_company	Chỉnh sửa thông tin sản phẩm và ngữ cảnh thương hiệu mà AI sử dụng cho email được tạo.
create_api_key	Tạo khóa API cho một công ty.
list_websites	Liệt kê các trang web và tên miền người gửi đã cấu hình.
add_website	Thêm trang web người gửi. Quá trình xử lý có thể mất khoảng 30 giây.
check_website	Kiểm tra xem trang web đã được xử lý và sẵn sàng chưa.
get_integration_guide	Lấy ví dụ tích hợp dành riêng cho framework.

Người Đăng Ký

Công cụ	Mô tả
add_subscriber	Thêm người đăng ký với thuộc tính, thẻ, trạng thái, chế độ chọn tham gia và ID danh sách tùy chọn.
update_subscriber	Cập nhật thuộc tính, thêm thẻ hoặc xóa thẻ.
remove_subscriber	Hủy đăng ký người đăng ký hoặc xóa cứng họ.
get_subscriber	Lấy chi tiết người đăng ký bằng email hoặc ID bên ngoài.
search_subscribers	Tìm kiếm theo truy vấn, thẻ, danh sách, trạng thái, phân khúc hoặc phân trang.

Sản Phẩm & Phân Phối Kỹ Thuật Số

Công cụ	Mô tả
list_products	Liệt kê các sản phẩm đã đồng bộ từ dữ liệu Stripe, Shopify, WooCommerce, thủ công hoặc Commerce API.
upsert_products	Tạo hoặc cập nhật tối đa 100 sản phẩm Commerce API được khóa bằng ID sản phẩm của bạn.
delete_product	Xóa sản phẩm đã được đẩy trước đó thông qua Commerce API.
attach_product_file	Đính kèm tệp phân phối được lưu trữ hoặc tải lên cục bộ vào sản phẩm.
remove_product_file	Xóa tệp phân phối sản phẩm đã đính kèm.
sync_products	Xếp hàng đồng bộ danh mục sản phẩm Stripe.

Sau khi tệp phân phối sản phẩm được đính kèm, các sự kiện mua hàng phù hợp bao gồm download.url và download.name, vì vậy email kích hoạt mua hàng có thể sử dụng thẻ hợp nhất như {{event.download.url}}.

Danh Sách, Thẻ, Phân Khúc

Công cụ	Mô tả
list_tags	Liệt kê tất cả các thẻ.
create_tag	Tạo định nghĩa thẻ với màu tùy chọn.
update_tag	Cập nhật màu thẻ.
delete_tag	Xóa thẻ và xóa nó khỏi người đăng ký.
list_lists	Liệt kê danh sách người đăng ký.
create_list	Tạo danh sách người đăng ký.
update_list	Đổi tên hoặc mô tả danh sách người đăng ký.
delete_list	Xóa danh sách người đăng ký.
add_subscribers_to_list	Thêm tối đa 500 người đăng ký vào danh sách từ một mảng email.
remove_subscribers_from_list	Xóa tối đa 500 người đăng ký khỏi danh sách.
list_segments	Liệt kê các phân khúc đã lưu và số lượng.
create_segment	Tạo phân khúc đã lưu từ bộ lọc hoặc nhóm AND/OR lồng nhau.
update_segment	Cập nhật tên phân khúc, bộ lọc, nhóm gốc hoặc toán tử nối.
delete_segment	Xóa phân khúc đã lưu.
get_segment_count	Xem trước số lượng người đăng ký đang hoạt động cho một phân khúc.

Đối với xuất người đăng ký, search_subscribers chấp nhận listId, listName chính xác hoặc list (ID trước, sau đó là tên chính xác). Nếu limit bị bỏ qua, công cụ sẽ tìm nạp tất cả người đăng ký phù hợp bằng các trang API 100 hàng.

Để điền danh sách hàng loạt, sử dụng add_subscribers_to_list; điểm cuối API hỗ trợ là POST /api/v1/lists/{listId}/subscribers không có hậu tố /bulk:

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

Gửi tối đa 500 email mỗi yêu cầu. Giới hạn tốc độ API tiêu chuẩn vẫn áp dụng: 100 yêu cầu mỗi phút cho mỗi khóa API và 20 yêu cầu mỗi giây bùng nổ. Đối với nhập CLI theo hướng CSV, tiêu đề email được chấp nhận bao gồm email, e-mail, email address và mail; nếu không có tiêu đề được nhận dạng, CLI sẽ đọc cột đầu tiên.

Bộ lọc phân khúc hỗ trợ thuộc tính, sự kiện, tư cách thành viên phân khúc đã lưu, sự kiện tương tác, quy tắc mua sản phẩm Stripe và quy tắc mua sản phẩm thương mại. Sử dụng filterJoinOperator: "or" cho các phân khúc khớp-bất-kỳ hoặc truyền nhóm root v2 cho logic lồng nhau.

Mỗi trường bộ lọc phân khúc xác thực các toán tử riêng của nó:

• 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, trường tương tác email: is, is_not, at_least, less_than_count
• emailBounced: cũng hỗ trợ 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

Ví dụ bộ lọc sản phẩm 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" }

Bộ lọc sản phẩm thương mại khớp với các sản phẩm được mua thông qua đơn hàng thương mại. Giá trị có thể là provider:productId cho ID phạm vi nhà cung cấp (shopify, woocommerce, hoặc api), một ID sản phẩm thuần để khớp với bất kỳ nhà cung cấp nào, hoặc provider:productId:count cho toán tử ngưỡng:

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

Các trường tương tác như emailSent, emailDelivered, emailOpened, emailClicked, emailBounced, và emailComplained chấp nhận cửa sổ cuộn như 7d, 30d, 90d, 180d, all, giá trị ngưỡng như 5:30d, hoặc phạm vi chiến dịch như campaign:cmp_123.

Đồng bộ đối tượng (Meta Ads)

Công cụ	Mô tả
list_audience_syncs	Liệt kê đồng bộ phân khúc-đối tượng với lịch trình và trạng thái đồng bộ cuối.
list_ad_accounts	Liệt kê các tài khoản quảng cáo Meta có sẵn để đồng bộ.
create_audience_sync	Đẩy một phân khúc vào đối tượng tùy chỉnh Meta theo lịch trình.
update_audience_sync	Thay đổi tần suất đồng bộ (hourly, daily, weekly) hoặc tạm dừng/tiếp tục.
delete_audience_sync	Xóa ánh xạ đồng bộ; bản thân đối tượng Meta được giữ lại.
sync_audience_now	Kích hoạt tải lên ngay lập tức ngoài lịch trình thông thường.

Yêu cầu tích hợp Meta Ads được kết nối trong bảng điều khiển Sequenzy (Cài đặt -> Tích hợp). create_audience_sync chấp nhận một phân khúc hiện có (segmentId) hoặc một mẫu có sẵn (predefinedSegmentId, ví dụ zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged) - phân khúc mẫu được tạo tự động khi sử dụng lần đầu và lần tải lên đầu tiên chạy ngay lập tức.

Đối tượng chỉ thêm: người đăng ký sau đó rời khỏi phân khúc vẫn ở trong đối tượng Meta. Meta yêu cầu hơn 100 người khớp trước khi đối tượng có thể được sử dụng để phân phối quảng cáo.

Mẫu

Công cụ	Mô tả
list_templates	Liệt kê mẫu với trạng thái bản địa hóa.
get_template	Đọc chi tiết mẫu, nội dung và các biến thể bản địa hóa.
create_template	Tạo mẫu từ HTML hoặc khối Sequenzy.
update_template	Cập nhật siêu dữ liệu mẫu, nhãn, HTML hoặc khối.
delete_template	Xóa một mẫu.

Kiểm tra A/B

Công cụ	Mô tả
list_ab_tests	Liệt kê kiểm tra A/B và biến thể, tùy chọn phạm vi theo chuỗi.
get_ab_test	Lấy biến thể, nội dung và trạng thái bản địa hóa.
get_ab_test_stats	Lấy thống kê tổng hợp và theo từng biến thể.
restart_ab_test	Khởi động lại kiểm tra A/B đã dừng hoặc hoàn thành.
update_ab_test_variant	Cập nhật chủ đề biến thể nháp, văn bản xem trước, HTML hoặc khối.
create_ab_test	Tạo kiểm tra A/B cho chiến dịch hoặc chuỗi.
add_ab_test_variant	Thêm biến thể vào kiểm tra A/B hiện có.
delete_ab_test_variant	Xóa biến thể kiểm tra A/B nháp.
delete_ab_test	Xóa kiểm tra A/B.

Sử dụng get_ab_test để khám phá ID biến thể trước khi chỉnh sửa. Cập nhật biến thể chấp nhận html hoặc blocks, không phải cả hai.

Chiến dịch

Công cụ	Mô tả
list_campaigns	Liệt kê chiến dịch, tùy chọn lọc theo trạng thái.
get_campaign	Lấy chi tiết và thống kê chiến dịch.
get_email_send	Kiểm tra bản ghi chi tiết email đã gửi.
create_campaign	Tạo chiến dịch nháp từ HTML, khối, mẫu hoặc dữ liệu chiến dịch.
update_campaign	Cập nhật chiến dịch nháp, bao gồm dữ liệu chiến dịch và danh sách tính toán.
schedule_campaign	Lên lịch cho bản nháp hoặc lên lịch lại cho chiến dịch đã lên lịch hiện có.
send_test_email	Gửi email kiểm tra đến một địa chỉ.
cancel_campaign	Hủy chiến dịch đã lên lịch hoặc đang gửi.
pause_campaign	Tạm dừng chiến dịch đang gửi.
resume_campaign	Tiếp tục chiến dịch đã tạm dừng, tùy chọn phân phối theo thời gian.
delete_campaign	Xóa chiến dịch.
duplicate_campaign	Nhân bản chiến dịch thành bản nháp mới.
resend_campaign_to_non_openers	Tạo bản nháp gửi lại cho các thành viên đối tượng ban đầu chưa mở chiến dịch đã gửi.

Trang đích

Công cụ	Mô tả
list_landing_pages	Liệt kê trang đích với trạng thái, số liệu, nội dung và URL.
get_landing_page	Lấy chi tiết trang đích, nội dung trình tạo, số liệu và URL công khai.
create_landing_page	Tạo trang đích nháp từ nội dung mẫu mặc định hoặc JSON.
update_landing_page	Chỉnh sửa tên trang đích, slug hoặc nội dung tương thích trình chỉnh sửa đầy đủ.
publish_landing_page	Xuất bản trang đích, tùy chọn lưu chỉnh sửa trước.
unpublish_landing_page	Đưa trang đích về trạng thái nháp, tùy chọn lưu chỉnh sửa trước.
delete_landing_page	Xóa trang đích chưa xuất bản.
connect_landing_page_domain	Kết nối miền trang đích tùy chỉnh và trả về chi tiết thiết lập DNS.
update_landing_page_domain_settings	Thay thế hoặc xác minh cài đặt miền tùy chỉnh trang đích.

Nội dung trang đích sử dụng lược đồ JSON tương thích trình chỉnh sửa của Sequenzy với version, template, seo, theme, và blocks. Miền trang đích tùy chỉnh yêu cầu bản ghi CNAME trỏ đến pages.sequenzydns.com; gọi update_landing_page_domain_settings với verify: true sau khi thay đổi DNS được lan truyền.

Chuỗi

Công cụ	Mô tả
list_sequences	Liệt kê chuỗi email và trạng thái tự động hóa.
get_sequence	Lấy chi tiết chuỗi, bao gồm bước nodeId, emailId được liên kết, chủ đề, văn bản xem trước và khối.
create_sequence	Tạo chuỗi do AI tạo hoặc các bước rõ ràng.
update_sequence	Cập nhật cài đặt chuỗi, hành vi đăng ký, các bước hiện có, logic nhánh hoặc chèn các bước tuyến tính.
insert_sequence_step	Chèn một bước email mới, tùy chọn với nút trì hoãn trước nó.
enable_sequence	Kích hoạt chuỗi.
disable_sequence	Đóng băng chuỗi, chặn đăng ký mới và giữ người nhận hiện tại.
pause_sequence_enrollments	Dừng đăng ký mới cho chuỗi đang hoạt động trong khi người nhận hiện tại tiếp tục.
resume_sequence_enrollments	Mở lại đăng ký mới cho chuỗi đang hoạt động mà không thay đổi người nhận hiện tại.
enroll_subscribers_in_sequence	Đăng ký tối đa 500 người đăng ký theo email, ID người đăng ký hoặc cả hai, tùy chọn tại nút đích.
cancel_sequence_enrollments	Dừng đăng ký đang hoạt động hoặc đang chờ theo giá trị trường sự kiện người đăng ký hoặc mục nhập.
delete_sequence	Xóa chuỗi.

Tạo chuỗi hỗ trợ:

• trigger: "segment_entered" cộng với segmentId cho tự động hóa mục nhập phân khúc đã lưu.
• trigger: "event_received" cộng với {{event.*}} thẻ hợp nhất trong chủ đề hoặc nội dung thân.
• trigger: "inactivity" cộng với eventName, inactiveDays, và inactivityBaseline tùy chọn (sequence_created_at hoặc subscriber_created_at).
• goal cho nội dung email do AI tạo.
• steps rõ ràng với blocks của Sequenzy.
• steps rõ ràng với HTML, mà Sequenzy chuyển đổi thành các khối có thể chỉnh sửa.
• Chờ cố định qua delay / delayMs, hoặc chờ trường ngày động qua waitUntil cho nhắc nhở gia hạn, theo dõi cuộc hẹn, thúc đẩy hết hạn dùng thử và các ngày cụ thể sự kiện khác.
• Các bước hành động giảm giá hiển thị thẻ hợp nhất như {{discount.code}} và {{discount.percentOff}}.
• enrollmentMode: "matching_field" và enrollmentFieldPath cho tự động hóa sự kiện cụ thể sản phẩm, biến thể, đơn hàng hoặc đăng ký.

Cập nhật chuỗi hỗ trợ insertSteps để thêm các bước tuyến tính mới sau nodeId được trả về bởi get_sequence. Bỏ qua afterNodeId chỉ khi thêm vào chuỗi có chính xác một đuôi tuyến tính. insertSteps hỗ trợ các bước có thể thêm không yêu cầu bản ghi đồng hành, chẳng hạn như email, trì hoãn, hành động thẻ/danh sách, cập nhật thuộc tính, giảm giá, điều kiện, bước chờ sự kiện và webhook. Sử dụng branch cho nhánh if/else đa đường; cung cấp branch hoặc insertSteps, không phải cả hai. Điều kiện nhánh hỗ trợ kiểm tra sự hiện diện và vắng mặt thẻ với has_tag và does_not_have_tag, cộng với danh sách, phân khúc đã lưu, sự kiện, liên kết đã nhấp và so sánh trường. Mảng emails và steps chỉ chỉnh sửa các bước email hiện có theo nodeId, emailId, hoặc thứ tự mảng; sử dụng insertSteps để tạo bước mới và bao gồm delay, delayMs, hoặc waitUntil cấp bước khi email được chèn cần bộ đếm thời gian. waitUntil chấp nhận trường ngày từ sự kiện kích hoạt cộng với offset tùy chọn, direction (before hoặc after), và missingAction (continue hoặc exit). Đối với chuỗi đang hoạt động, truyền confirmStructuralChange: true với insertSteps hoặc branch chỉ sau khi xác nhận tác động luồng trực tiếp.

Chạy cancel_sequence_enrollments với dryRun: true trước khi áp dụng hủy hàng loạt.

Tạo kiểu khối email

Các công cụ chấp nhận blocks duy trì kiểu trực quan từng khối dưới đối tượng styles của khối:

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

Để tương thích với các prompt tác nhân cũ hơn, các khóa kiểu cấp cao nhất như backgroundColor, backgroundOpacity, borderColor, borderWidth và borderRadius cũng được chấp nhận và lưu dưới styles.

Email Giao dịch

Công cụ	Mô tả
list_transactional_emails	Liệt kê các mẫu giao dịch và slug API.
get_transactional_email	Đọc một email giao dịch theo ID hoặc slug.
create_transactional_email	Tạo một mẫu email giao dịch.
update_transactional_email	Cập nhật siêu dữ liệu giao dịch hoặc nội dung thân email.
send_email	Gửi một email giao dịch đơn lẻ theo mẫu hoặc HTML.

Các biến send_email hỗ trợ mảng lồng nhau cho các khối lặp lại, chẳng hạn như { "event": { "items": [...] } }.

Phân tích

Công cụ	Mô tả
get_stats	Nhận số liệu thống kê tổng quan cho 7d, 30d hoặc 90d.
get_campaign_stats	Nhận hiệu suất chiến dịch chi tiết.
get_sequence_stats	Nhận hiệu suất chuỗi.
list_campaign_events	Liệt kê các sự kiện email thô được phân trang cho một chiến dịch.
list_sequence_events	Liệt kê các sự kiện email thô được phân trang cho một chuỗi.
get_subscriber_activity	Nhận số liệu thống kê email, hoạt động và đăng ký của người đăng ký.

Các công cụ phân tích mặc định loại trừ các lần mở/nhấp từ bot, máy quét, xem trước liên kết và tài sản theo dõi đã phát hiện. Truyền includeMachineEngagement: true vào get_stats, get_campaign_stats, get_sequence_stats, get_ab_test_stats, get_subscriber hoặc get_subscriber_activity khi bạn cần chẩn đoán tương tác thô; các hàng hoạt động mở/nhấp được bao gồm sẽ hiển thị các trường machine, engagementQuality và classificationReasons nơi API trả về hoạt động cấp sự kiện.

Nhóm, Hộp thư đến, Webhook

Công cụ	Mô tả
list_team_members	Liệt kê thành viên nhóm và lời mời đang chờ xử lý.
invite_team_member	Mời đồng đội làm quản trị viên hoặc người xem, với quyền truy cập thanh toán tùy chọn.
cancel_team_invitation	Hủy lời mời nhóm đang chờ xử lý.
list_conversations	Liệt kê các cuộc trò chuyện trả lời của người đăng ký với bộ lọc trạng thái và chưa đọc.
get_conversation	Đọc một cuộc trò chuyện và lịch sử tin nhắn của nó.
reply_to_conversation	Gửi trả lời đi hoặc thêm ghi chú nội bộ.
update_conversation_status	Mở hoặc đóng một cuộc trò chuyện.
mark_conversation_read	Đánh dấu tất cả tin nhắn trong một cuộc trò chuyện là đã đọc.
list_webhooks	Liệt kê các điểm cuối webhook gửi đi.
create_webhook	Tạo một webhook gửi đi và trả về bí mật ký một lần của nó.
update_webhook	Cập nhật tên, URL, sự kiện hoặc trạng thái webhook.
delete_webhook	Xóa vĩnh viễn một điểm cuối webhook và lịch sử gửi.
test_webhook	Gửi một sự kiện kiểm tra đến điểm cuối webhook.
list_webhook_deliveries	Liệt kê các lần thử gửi gần đây cho một webhook.
replay_webhook_delivery	Phát lại một lần gửi webhook.

Tạo bằng AI

Công cụ	Mô tả
generate_email	Tạo các khối email từ một prompt.
generate_sequence	Tạo một chuỗi nhiều email từ một mục tiêu.
generate_subject_lines	Tạo các biến thể dòng chủ đề A/B.

Nội dung được tạo được trả về dưới dạng nội dung nháp để xem xét.

Tài nguyên

Máy chủ cũng hiển thị các tài nguyên MCP chỉ đọc.

Tài nguyên	Mô tả
sequenzy://dashboard	Số liệu thống kê tổng quan trực tiếp trong 7 ngày qua.
sequenzy://company	Cài đặt công ty và bản địa hóa hiện tại.
sequenzy://campaigns/recent	10 chiến dịch cuối cùng với trạng thái và số liệu thống kê cơ bản.
sequenzy://subscribers/recent	Người đăng ký được thêm gần đây nhất.
sequenzy://subscribers/engaged	Người đăng ký tích cực hoặc tương tác nhiều nhất.
sequenzy://sequences	Tất cả các chuỗi với trạng thái.
sequenzy://templates	Các mẫu với trạng thái bản địa hóa.
sequenzy://segments	Các phân đoạn đã lưu với số lượng người đăng ký.
sequenzy://tags	Thẻ với số lần sử dụng.
sequenzy://health	Chỉ số khả năng gửi và trạng thái sức khỏe.
sequenzy://app-routes	Các mẫu tuyến đường bảng điều khiển và tab cài đặt.

Prompt Ví dụ

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?

Bảo mật

• Sử dụng khóa API cá nhân, không phải bí mật nhóm dùng chung.
• Khóa chỉ truy cập các công ty mà người dùng Sequenzy của bạn có thể truy cập.
• Thu hồi khóa từ Cài đặt -> Khóa API khi không còn cần truy cập.
• Giữ các prompt phê duyệt của máy khách được bật cho các thao tác gửi, lập lịch, xóa và thay đổi hàng loạt.
• Ưu tiên quy trình làm việc nháp cho các chiến dịch và chuỗi, sau đó xem xét trong Sequenzy trước khi khởi chạy.

Khắc phục sự cố

SEQUENZY_API_KEY environment variable is required

Đặt SEQUENZY_API_KEY trong cấu hình máy khách MCP, hoặc chạy:

npx @sequenzy/setup

Khóa API không hợp lệ

Tạo khóa cá nhân mới trong Cài đặt -> Khóa API, cập nhật cấu hình MCP của bạn và khởi động lại máy khách.

Tài nguyên trùng lặp

Nếu một lệnh gọi công cụ tạo ra tên phân đoạn hoặc miền gửi trùng lặp, máy chủ sẽ trả về code ổn định, description thân thiện với tác nhân, resolution cụ thể và docsUrl. Đối với phân đoạn, hãy gọi list_segments và sử dụng lại ID phân đoạn hiện có hoặc chọn một tên khác. Đối với trang web, hãy gọi list_websites; nếu miền không được liệt kê cho công ty đã chọn, nó thuộc về một công ty hoặc tài khoản khác và phải được xóa, gán lại hoặc thay thế bằng một miền gửi khác.

Công cụ không xuất hiện

• Xác nhận npx có sẵn trong môi trường mà máy khách sử dụng.
• Khởi động lại máy khách MCP sau khi chỉnh sửa cấu hình.
• Kiểm tra xem cấu hình có ở đúng vị trí dành riêng cho máy khách không.

Sự cố mạng hoặc URL API

Máy chủ sử dụng https://api.sequenzy.com theo mặc định. Nếu bạn ghi đè nó, hãy xác minh SEQUENZY_API_URL trỏ đến URL cơ sở API Sequenzy có thể truy cập được.

Phát triển

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

Các lược đồ công cụ MCP phải duy trì khả năng tương thích với các máy khách nghiêm ngặt:

• Các gốc inputSchema của công cụ phải là các lược đồ type: "object" thuần túy.
• Không công bố anyOf ở bất kỳ đâu trong lược đồ công cụ.
• Không đặt oneOf, allOf, enum hoặc not ở gốc của lược đồ công cụ.
• Thực thi các yêu cầu có điều kiện trong trình xử lý và bao phủ chúng bằng các bài kiểm tra.

Kho lưu trữ độc lập này phản ánh gói MCP được duy trì trong monorepo Sequenzy chính. Xem AGENTS.md để biết các quy tắc đồng bộ hóa.

Giấy phép

MIT

Khám phá gốc tác nhân

Sequenzy công bố các tệp kê khai có thể đọc bằng máy cho các mạng tác nhân và khám phá kiểu A2A:

• Điểm cuối MCP từ xa: https://api.sequenzy.com/v1/mcp
• Tệp kê khai khả năng tác nhân: agent-capability.json
• Thẻ tác nhân kiểu A2A: .well-known/agent-card.json
• Siêu dữ liệu kỹ năng OpenClaw/Moltbot: openclaw/skill.json
• Hướng dẫn vận hành OpenClaw/Moltbot: openclaw/SKILL.md

Các tệp này mô tả Sequenzy như một khả năng tự động hóa email được ủy quyền cho các tác nhân. Chúng loại trừ rõ ràng các trường hợp sử dụng thu thập dữ liệu, spam và tiếp cận lạnh không được yêu cầu.