Sequenzy MCP Server
官方SaaS 的電子郵件行銷工具
文件
Sequenzy MCP 伺服器
Sequenzy 的官方 MCP 伺服器,這是一個 AI 驅動的電子郵件行銷平台。
將 Sequenzy 連接到 Claude Desktop、Claude Code、Codex、Cursor、Windsurf、VS Code Copilot、OpenClaw 及其他 MCP 客戶端,讓您的 AI 助理能夠使用結構化工具來管理電子郵件操作,而無需手動編寫 API 呼叫。
您可以執行的操作
- 管理訂閱者、標籤、列表和動態區隔。
- 將區隔同步至 Meta 自訂廣告受眾,用於 Facebook 和 Instagram 再行銷。
- 管理產品並附加數位交付檔案,用於購買自動化。
- 草擬、更新、排程和檢查行銷活動。
- 建立和編輯電子郵件序列,包括事件觸發和區隔進入自動化。
- 取消、暫停、繼續、複製或刪除行銷活動,並將聯絡人加入序列。
- 管理交易電子郵件範本並發送單一交易電子郵件。
- 建立、編輯、發布、取消發布和刪除登陸頁面。
- 為已發布的登陸頁面連接和驗證自訂網域。
- 管理團隊邀請、收件匣對話和對外 Webhook 端點。
- 生成電子郵件文案、主旨行和多步驟序列。
- 檢查分析數據、訂閱者活動、送達率健康狀況和儀表板網址。
- 設定公司產品資訊、寄件者網站以及常見框架的整合範例。
每個已發布的 MCP 工具都包含明確的 readOnlyHint、destructiveHint 和 openWorldHint 註釋,以便相容的客戶端能夠顯示準確的工具使用提示。工具也會發布 outputSchema 定義並回傳 structuredContent,為客戶端和模型提供機器可讀的結果結構,用於後續呼叫。
快速設定
最簡單的設定方式是使用 Sequenzy 精靈:
npx @sequenzy/setup
該精靈會開啟瀏覽器登入流程、建立個人 API 金鑰、偵測支援的 AI 客戶端,並在可能的情況下自動進行設定。
託管遠端 MCP
對於支援 Streamable HTTP MCP 的客戶端,請使用 Sequenzy 的託管端點,而無需執行本機 stdio 程序:
https://api.sequenzy.com/v1/mcp
遠端客戶端應在支援時使用 Sequenzy OAuth 流程進行驗證。本機和自動化客戶端仍可使用下方的 stdio 套件搭配 SEQUENZY_API_KEY。
機器可讀的探索檔案:
- MCP 伺服器清單:
server.json - 代理程式卡片:
.well-known/agent-card.json - 代理程式能力清單:
agent-capability.json - OpenClaw 技能中繼資料:
openclaw/skill.json
手動設定
所有 stdio MCP 客戶端使用相同的指令:
- 指令:
npx - 參數:
-y @sequenzy/mcp - 必要的環境變數:
SEQUENZY_API_KEY=seq_user_your_key_here
選用的環境變數:
SEQUENZY_API_URL- Sequenzy API 基礎網址。預設為https://api.sequenzy.com。SEQUENZY_APP_URL- 應用程式網址輔助工具所使用的 Sequenzy 儀表板基礎網址。預設為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 上,使用 cmd /c 包裝 npx:
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 金鑰
- 開啟 Sequenzy 儀表板。
- 前往「設定」->「API 金鑰」。
- 建立個人金鑰。
- 將金鑰新增至您的 MCP 客戶端設定。
個人金鑰以 seq_user_ 開頭。您可以隨時在儀表板中撤銷它們。
工具
此伺服器目前提供 120 個 MCP 工具。
帳戶、公司、設定
| 工具 | 說明 |
|---|---|
get_account | 取得帳戶資訊、可用公司以及目前公司。 |
select_company | 為後續的工具呼叫設定作用中的公司。 |
get_app_urls | 為行銷活動、登陸頁面、序列、電子郵件、設定、網域和已發送電子郵件詳細資料建立儀表板網址。 |
create_company | 建立新公司或品牌。 |
get_company | 讀取公司詳細資料、產品資訊、品牌顏色、AI 寫作情境和在地化設定。 |
update_company | 編輯 AI 用於生成電子郵件的產品資訊和品牌情境。 |
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_products | 列出從 Stripe、Shopify、WooCommerce、手動或 Commerce API 資料同步的產品。 |
upsert_products | 建立或更新最多 100 個以您的產品 ID 為索引的 Commerce API 產品。 |
delete_product | 刪除先前透過 Commerce API 推送的產品。 |
attach_product_file | 將託管或本機上傳的交付檔案附加到產品。 |
remove_product_file | 移除附加的產品交付檔案。 |
sync_products | 排程 Stripe 產品目錄同步。 |
附加產品交付檔案後,相符的購買事件會包含 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_nottag:contains、not_contains、is_empty、is_not_emptyemail:contains、not_containsemailProvider、list:is、is_not、is_empty、is_not_emptyfirstName、lastName:contains、not_contains、is_empty、is_not_emptyadded:less_than、more_thanattribute:is、is_not、is_empty、is_not_empty、gte、lte、gt、lt、contains、not_containsevent、電子郵件參與欄位:is、is_not、at_least、less_than_countemailBounced:也支援is_temporary_bounce、is_permanent_bouncestripeProduct:is、is_not、at_least、less_than_countstripeCurrentProduct、stripeTrialProduct:is、is_not、gte、lte、gt、ltcommerceProduct: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" }
商務產品篩選器會比對透過商務訂單購買的產品。值可以是 provider:productId 用於提供者範圍的 ID(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 廣告)
| 工具 | 說明 |
|---|---|
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 廣告整合。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_template | 從 HTML 或 Sequenzy 區塊建立範本。 |
update_template | 更新範本中繼資料、標籤、HTML 或區塊。 |
delete_template | 刪除範本。 |
A/B 測試
| 工具 | 說明 |
|---|---|
list_ab_tests | 列出 A/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_test | 刪除 A/B 測試。 |
在編輯前使用 get_ab_test 探索變體 ID。變體更新接受 html 或 blocks,不可同時使用。
行銷活動
| 工具 | 說明 |
|---|---|
list_campaigns | 列出活動,可選擇依狀態篩選。 |
get_campaign | 取得活動詳細資料和統計資料。 |
get_email_send | 檢查已發送電子郵件的詳細記錄。 |
create_campaign | 從 HTML、區塊、範本或活動資料建立草稿活動。 |
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 | 列出登陸頁面,包含狀態、指標、內容和網址。 |
get_landing_page | 取得登陸頁面詳細資料、建構器內容、指標和公開網址。 |
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 | 取代或驗證登陸頁面自訂網域設定。 |
登陸頁面內容使用 Sequenzy 的編輯器相容 JSON 架構,包含 version、template、seo、theme 和 blocks。自訂登陸頁面網域需要一個指向 pages.sequenzydns.com 的 CNAME 記錄;在 DNS 變更生效後,使用 verify: true 呼叫 update_landing_page_domain_settings。
序列
| 工具 | 說明 |
|---|---|
list_sequences | 列出電子郵件序列和自動化狀態。 |
get_sequence | 取得序列詳細資料,包括步驟 nodeId、連結的 emailId、主旨、預覽文字和區塊。 |
create_sequence | 建立 AI 生成或明確步驟的序列。 |
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)。goal用於 AI 生成的電子郵件內容。- 明確的
steps搭配 Sequenzyblocks。 - 明確的
steps搭配 HTML,Sequenzy 會將其轉換為可編輯區塊。 - 透過
delay/delayMs設定固定等待,或透過waitUntil設定動態日期欄位等待,用於續訂提醒、預約跟進、試用到期提示和其他事件特定日期。 - 折扣動作步驟,會公開如
{{discount.code}}和{{discount.percentOff}}的合併標籤。 enrollmentMode: "matching_field"和enrollmentFieldPath,用於產品、變體、訂單或訂閱特定的事件自動化。
序列更新支援 insertSteps,用於在 get_sequence 回傳的 nodeId 之後新增線性步驟。僅在附加至恰好有一個線性尾端的序列時,才省略 afterNodeId。insertSteps 支援可新增的步驟,這些步驟不需要伴隨記錄,例如電子郵件、延遲、標籤/清單動作、屬性更新、折扣、條件、等待事件步驟和 webhook。使用 branch 進行多路徑 if/else 分支;提供 branch 或 insertSteps,不可同時提供。分支條件支援使用 has_tag 和 does_not_have_tag 檢查標籤存在與否,以及清單、已儲存區隔、事件、點擊連結和欄位比較。emails 和 steps 陣列僅透過 nodeId、emailId 或陣列順序編輯現有電子郵件步驟;使用 insertSteps 建立新步驟,並在插入的電子郵件需要計時器時,包含步驟層級的 delay、delayMs 或 waitUntil。waitUntil 接受來自觸發事件的日期欄位,加上可選的 offset、direction(before 或 after)和 missingAction(continue 或 exit)。對於使用中的序列,僅在確認即時流程影響後,才傳遞 confirmStructuralChange: true 搭配 insertSteps 或 branch。
在套用大量取消前,先使用 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 slug。 |
get_transactional_email | 透過 ID 或 slug 讀取交易郵件。 |
create_transactional_email | 建立交易郵件範本。 |
update_transactional_email | 更新交易中繼資料或內文內容。 |
send_email | 透過範本或 HTML 發送單一交易郵件。 |
send_email 變數支援用於重複區塊的巢狀陣列,例如 { "event": { "items": [...] } }。
分析
| 工具 | 說明 |
|---|---|
get_stats | 取得 7d、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;包含的開啟/點擊活動列會揭露 machine、engagementQuality 和 classificationReasons 欄位,其中 API 會回傳事件層級的活動。
團隊、收件匣、Webhook
| 工具 | 說明 |
|---|---|
list_team_members | 列出團隊成員和待處理的邀請。 |
invite_team_member | 邀請隊友成為管理員或檢視者,可選擇是否授予帳單存取權。 |
cancel_team_invitation | 取消待處理的團隊邀請。 |
list_conversations | 列出訂閱者回覆對話,並可依狀態和未讀篩選。 |
get_conversation | 讀取對話及其訊息歷史記錄。 |
reply_to_conversation | 發送對外回覆或新增內部備註。 |
update_conversation_status | 開啟或關閉對話。 |
mark_conversation_read | 將對話中的所有訊息標記為已讀。 |
list_webhooks | 列出對外 Webhook 端點。 |
create_webhook | 建立對外 Webhook 並回傳其一次性簽署密鑰。 |
update_webhook | 更新 Webhook 的名稱、URL、事件或狀態。 |
delete_webhook | 永久刪除 Webhook 端點及其傳遞歷史記錄。 |
test_webhook | 向 Webhook 端點發送測試事件。 |
list_webhook_deliveries | 列出某個 Webhook 近期的傳遞嘗試記錄。 |
replay_webhook_delivery | 重新執行一次 Webhook 傳遞。 |
AI 生成
| 工具 | 說明 |
|---|---|
generate_email | 根據提示生成郵件區塊。 |
generate_sequence | 根據目標生成多封郵件序列。 |
generate_subject_lines | 生成 A/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 風格的探索發布了機器可讀的清單:
- 遠端 MCP 端點:
https://api.sequenzy.com/v1/mcp - 代理能力清單:
agent-capability.json - A2A 風格的代理卡片:
.well-known/agent-card.json - OpenClaw/Moltbot 技能中繼資料:
openclaw/skill.json - OpenClaw/Moltbot 操作指南:
openclaw/SKILL.md
這些檔案將 Sequenzy 描述為一個授權的電子郵件自動化能力,供代理使用。它們明確排除了抓取、垃圾郵件和未經請求的冷外聯使用案例。