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 カスタムオーディエンスに同期。
  • 購入オートメーション用の商品管理とデジタル配信ファイルの添付。
  • キャンペーンの下書き、更新、スケジュール設定、調査。
  • イベントトリガーやセグメントエントリーオートメーションを含む、メールシーケンスの作成と編集。
  • キャンペーンのキャンセル、一時停止、再開、複製、削除、およびシーケンスへのコンタクト登録。
  • トランザクションメールテンプレートの管理と、単一トランザクションメールの送信。
  • ランディングページの作成、編集、公開、非公開、削除。
  • 公開済みランディングページ用のカスタムドメインの接続と検証。
  • チーム招待、受信トレイの会話、アウトバウンド Webhook エンドポイントの管理。
  • メール本文、件名、複数ステップのシーケンスの生成。
  • 分析、購読者アクティビティ、到達性の健全性、ダッシュボード URL の調査。
  • 企業の製品情報、送信者ウェブサイト、一般的なフレームワーク向けの統合例の設定。

公開されているすべての MCP ツールには、明示的な readOnlyHint、destructiveHint、openWorldHint アノテーションが含まれており、互換性のあるクライアントが正確なツール使用アフォーダンスを表示できます。ツールは outputSchema 定義も公開し、structuredContent を返すため、クライアントやモデルは後続の呼び出しのために機械可読な結果形状を取得できます。

クイックセットアップ

最も簡単なセットアップ方法は、Sequenzy ウィザードを使用することです。

npx @sequenzy/setup

ウィザードはブラウザのログインフローを開き、個人用 API キーを作成し、サポートされている AI クライアントを検出して、可能な場合は自動的に設定します。

ホスト型リモート MCP

Streamable HTTP MCP をサポートするクライアントの場合は、ローカルの stdio プロセスを実行する代わりに、Sequenzy のホスト型エンドポイントを使用します。

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

リモートクライアントは、サポートされている場合、Sequenzy OAuth フローで認証する必要があります。ローカルクライアントや自動化クライアントは、引き続き以下の stdio パッケージを SEQUENZY_API_KEY で使用できます。

機械可読な検出ファイル:

手動セットアップ

すべての 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 キーごとに 1 分あたり 100 リクエスト、バーストは 1 秒あたり 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" }

Commerce product filters match products purchased through commerce orders. Values can be provider:productId for provider-scoped IDs (shopify, woocommerce, or api), a bare product ID to match any provider, or provider:productId:count for threshold operators:

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

Engagement fields such as emailSent, emailDelivered, emailOpened, emailClicked, emailBounced, and emailComplained accept rolling windows like 7d, 30d, 90d, 180d, all, threshold values like 5:30d, or a campaign scope like campaign:cmp_123.

Audience Syncs (Meta Ads)

ToolDescription
list_audience_syncsセグメントとオーディエンスの同期を、スケジュールと最終同期ステータスとともに一覧表示します。
list_ad_accounts同期に利用可能なMeta広告アカウントを一覧表示します。
create_audience_syncセグメントをスケジュールに基づいてMetaカスタムオーディエンスにプッシュします。
update_audience_sync同期頻度の変更（hourly、daily、weekly）または一時停止/再開を行います。
delete_audience_sync同期マッピングを削除します。Metaオーディエンス自体は保持されます。
sync_audience_now通常スケジュール外で即時アップロードをトリガーします。

Requires the Meta Ads integration to be connected in the Sequenzy dashboard (Settings -> Integrations). create_audience_sync accepts an existing segment (segmentId) or a ready-made template (predefinedSegmentId, for example zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged) - the template segment is created automatically on first use, and the first upload runs immediately.

Audiences are add-only: subscribers who later leave the segment stay in the Meta audience. Meta requires 100+ matched people before an audience can be used for ad delivery.

Templates

ToolDescription
list_templatesテンプレートをローカライゼーションステータスとともに一覧表示します。
get_templateテンプレートの詳細、コンテンツ、ローカライズされたバリアントを読み取ります。
create_templateHTMLまたはSequenzyブロックからテンプレートを作成します。
update_templateテンプレートのメタデータ、ラベル、HTML、またはブロックを更新します。
delete_templateテンプレートを削除します。

A/B Tests

ToolDescription
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テストを削除します。

Use get_ab_test to discover variant IDs before editing. Variant updates accept either html or blocks, not both.

Campaigns

ToolDescription
list_campaignsキャンペーンを一覧表示します。オプションでステータスで絞り込み可能です。
get_campaignキャンペーンの詳細と統計を取得します。
get_email_send送信済みメールの詳細レコードを検査します。
create_campaignHTML、ブロック、テンプレート、またはキャンペーンデータから下書きキャンペーンを作成します。
update_campaign下書きキャンペーンを更新します（キャンペーンデータや計算済みリストを含む）。
schedule_campaign下書きをスケジュールするか、既存のスケジュール済みキャンペーンを再スケジュールします。
send_test_email1つのアドレスにテストメールを送信します。
cancel_campaignスケジュール済みまたは送信中のキャンペーンをキャンセルします。
pause_campaign送信中のキャンペーンを一時停止します。
resume_campaign一時停止したキャンペーンを再開します。オプションで配信を時間分散できます。
delete_campaignキャンペーンを削除します。
duplicate_campaignキャンペーンを複製して新しい下書きを作成します。
resend_campaign_to_non_openers送信済みキャンペーンを開封しなかった元のオーディエンスメンバー向けに下書きの再送信を作成します。

Landing Pages

ToolDescription
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ランディングページのカスタムドメイン設定を置換または検証します。

Landing page content uses Sequenzy's editor-compatible JSON schema with version, template, seo, theme, and blocks. Custom landing page domains require a CNAME record pointing to pages.sequenzydns.com; call update_landing_page_domain_settings with verify: true after DNS changes propagate.

Sequences

ToolDescription
list_sequencesメールシーケンスと自動化ステータスを一覧表示します。
get_sequenceシーケンスの詳細を取得します（ステップ nodeId、リンクされた emailId、件名、プレビューテキスト、ブロックを含む）。
create_sequenceAI生成または明示的なステップのシーケンスを作成します。
update_sequenceシーケンス設定、登録動作、既存ステップ、分岐ロジックを更新するか、線形ステップを挿入します。
insert_sequence_step新しいメールステップを1つ挿入します。オプションでその前に遅延ノードを付与可能です。
enable_sequenceシーケンスを有効化します。
disable_sequenceシーケンスを凍結し、新規登録をブロックして現在の受信者を保留します。
pause_sequence_enrollmentsアクティブなシーケンスへの新規登録を停止します。現在の受信者は続行されます。
resume_sequence_enrollmentsアクティブなシーケンスへの新規登録を再開します。現在の受信者は変更されません。
enroll_subscribers_in_sequenceメール、サブスクライバーID、またはその両方で最大500人のサブスクライバーを登録します。オプションでターゲットノードを指定可能。
cancel_sequence_enrollmentsサブスクライバーまたはエントリーイベントフィールド値で、アクティブまたは待機中の登録を停止します。
delete_sequenceシーケンスを削除します。

Sequence creation supports:

  • trigger: "segment_entered" plus segmentId for saved-segment entry automations.
  • trigger: "event_received" plus {{event.*}} merge tags in subjects or body content.
  • trigger: "inactivity" plus eventName, inactiveDays, and optional inactivityBaseline (sequence_created_at or subscriber_created_at).
  • goal for AI-generated email content.
  • Explicit steps with Sequenzy blocks.
  • Explicit steps with HTML, which Sequenzy converts into editable blocks.
  • Fixed waits via delay / delayMs, or dynamic date-field waits via waitUntil for renewal reminders, appointment follow-ups, trial-expiry nudges, and other event-specific dates.
  • Discount action steps that expose merge tags like {{discount.code}} and {{discount.percentOff}}.
  • enrollmentMode: "matching_field" and enrollmentFieldPath for product-, variant-, order-, or subscription-specific event automations.

Sequence updates support insertSteps for adding new linear steps after a nodeId returned by get_sequence. Omit afterNodeId only when appending to a sequence with exactly one linear tail. insertSteps supports addable steps that do not require companion records, such as email, delay, tag/list actions, attribute updates, discounts, conditions, wait-for-event steps, and webhooks. Use branch for multi-path if/else branches; provide either branch or insertSteps, not both. Branch conditions support tag presence and absence checks with has_tag and does_not_have_tag, plus lists, saved segments, events, clicked links, and field comparisons. The emails and steps arrays only edit existing email steps by nodeId, emailId, or array order; use insertSteps to create new steps and include a step-level delay, delayMs, or waitUntil when the inserted email needs a timer. waitUntil accepts a date field from the trigger event plus optional offset, direction (before or after), and missingAction (continue or exit). For active sequences, pass confirmStructuralChange: true with insertSteps or branch only after confirming the live-flow impact.

Run cancel_sequence_enrollments with dryRun: true before applying bulk cancellation.

Email Block Styling

Tools that accept blocks persist per-block visual styling under a block's styles object:

{
  "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サブスクライバーのメール統計、アクティビティ、登録情報を取得します。

分析ツールは、デフォルトで検出されたボット、スキャナー、リンクプレビュー、追跡アセットの開封/クリックを除外します。生のエンゲージメント診断が必要な場合は、get_stats、get_campaign_stats、get_sequence_stats、get_ab_test_stats、get_subscriber、get_subscriber_activity に includeMachineEngagement: true を渡します。含まれる開封/クリックアクティビティ行は、APIがイベントレベルのアクティビティを返す machine、engagementQuality、classificationReasons フィールドを公開します。

チーム、受信トレイ、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_webhookWebhook名、URL、イベント、ステータスを更新します。
delete_webhookWebhookエンドポイントと配信履歴を完全に削除します。
test_webhookWebhookエンドポイントにテストイベントを送信します。
list_webhook_deliveriesWebhookの最近の配信試行を一覧表示します。
replay_webhook_deliveryWebhook配信を再実行します。

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を再利用するか、別の名前を選択してください。Webサイトの場合は、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をエージェント向けの認可されたメール自動化機能として説明しています。スクレイピング、スパム、未承諾のコールドアウトリーチのユースケースは明示的に除外されています。