Klaviyo MCP

Klaviyo MCP

Klaviyo MCP サーバーです。複数アカウントにわたるキャンペーン、フロー、セグメント、メトリクス、レポート、プロフィールを対象とした、読み取り専用のツールが24個あります。

インストール

Claude Code：

claude mcp add klaviyo -e KLAVIYO_KEY_MAIN=pk_your_key -- npx -y @scalably-io/klaviyo-mcp

Codex：

codex mcp add klaviyo --env KLAVIYO_KEY_MAIN=pk_your_key -- npx -y @scalably-io/klaviyo-mcp

Claude Desktop：最新の GitHub リリースから klaviyo-mcp.mcpb をダウンロードして開いてください。Claude Desktop のインストールフォームでは、1つのアカウント（KLAVIYO_KEY_MAIN）のみ設定できます。

セットアップ

1. Klaviyo の Settings > API Keys でプライベート API キーを作成します。
2. アカウントごとに KLAVIYO_KEY_<name>=pk_xxx の環境変数を1つ設定します。例：KLAVIYO_KEY_MAIN または KLAVIYO_KEY_STOREONE。サーバーは起動時にすべての KLAVIYO_KEY_* 変数を自動検出します。list_accounts で検出されたアカウントを確認できます。
3. 複数の Klaviyo アカウント（代理店、複数ブランドのポートフォリオ）に対応しているのは Claude Code または Codex のみです。どちらも任意の追加環境変数を渡せるためです。アカウント数に応じて KLAVIYO_KEY_<name> 変数を追加し、ツールを呼び出す際に対応する account 引数（KLAVIYO_KEY_ の後に続く名前を小文字にしたもの）を指定してください。
4. 24個すべてのツールは読み取り専用です。

ツール（24）

ツール	機能
list_accounts	設定済みのKlaviyoアカウントをすべて一覧表示します。利用可能なブランドを確認するため、最初に使用してください。
list_campaigns	特定のKlaviyoアカウントの最近のメールキャンペーンを一覧表示します。キャンペーンID、名前、ステータス、送信日を返します。
campaign_report	Klaviyoアカウントのメールキャンペーンのパフォーマンス指標を取得します。指定した期間の開封数、クリック数、売上、バウンス率、配信停止数を返します。
list_metrics	Klaviyoアカウントで利用可能な指標を一覧表示します。売上レポートに必要な「Placed Order」指標IDを見つけるために使用します。
multi_account_summary	設定済みのすべてのKlaviyoアカウントからキャンペーンのパフォーマンス概要を取得します。ブランド横断の統合レポートを返します。
flow_report	Klaviyoアカウントのメールフロー（自動化）のパフォーマンスを取得します。ウェルカムシリーズ、カート放棄、購入後などの指標を返します。
campaign_ab_report	Klaviyoアカウントのメール／SMSキャンペーンについて、バリエーション（A/Bグループ）ごとの指標を取得します。結果をバリエーション別に分け、グループ間で比較できます。
flow_series_report	Klaviyoアカウントのフロー（自動化）の時系列指標を取得します。指定した間隔で集計します。
segment_report	Klaviyoアカウントのセグメントパフォーマンス指標を取得します。メンバー数、追加数、削除数を含みます。
form_report	Klaviyoアカウントの登録フォームのパフォーマンスを取得します。表示回数、送信数、送信率を含みます。
list_segments	Klaviyoアカウントのすべてのセグメントを、名前、メンバー数、作成日とともに一覧表示します。
list_lists	Klaviyoアカウントのすべてのメールリストを、名前、オプトイン方式、作成日とともに一覧表示します。
list_flows	Klaviyoアカウントのすべてのフロー（自動化）を、名前、ステータス、トリガーの種類、最終更新日とともに一覧表示します。
get_campaign_detail	IDで指定した単一のキャンペーンの詳細を取得します。名前、ステータス、送信時刻、件名、プレビューテキスト、チャネル、メッセージIDを含みます。
list_suppressed_profiles	単一の理由でメールマーケティングから抑制されたプロフィールを一覧表示します。Klaviyoではsuppression.reasonにanyではなくequalsのみを指定できるため、全体を確認するには理由ごとに1回ずつ呼び出してください。
metric_aggregate	任意のKlaviyo指標（例：開封数、クリック数、売上）の値を、カスタムの期間と間隔で集計します。
get_template	IDでメールテンプレートを取得します。HTML／テキストの内容を含みます。監査やプレビューに使用します。
list_recent_events	Klaviyoアカウントの最近のイベントを一覧表示します。必要に応じてmetric_id（例：Placed Order）で絞り込めます。直近の最大100件を返します。
account_info	Klaviyoアカウントのメタデータを取得します。組織名、タイムゾーン、通貨、連絡先メールアドレス、業種を含みます。
list_tags	Klaviyoアカウントのすべてのタグを一覧表示します（キャンペーン、フロー、セグメント、リストのラベル付けに使用）。
list_templates	Klaviyoアカウントのメールテンプレートを一覧表示します（名前、エディターの種類、日付）。1つのテンプレートのHTMLを取得するにはget_templateを使用します。
get_profile	メールアドレスまたはプロフィールIDで顧客プロフィールを検索します。名前、所在地、メールマーケティングの同意／抑制ステータスを含みます。
get_flow_detail	IDで指定したフローの構造を取得します。ステータス、トリガー、アクション／ステップ（種類、メッセージチャネル）を含みます。IDの確認にはlist_flowsを使用します。
custom_report	エキスパート向けの高度な機能です。統計、group_by、filter、interval、timeframeを細かく指定して、任意のKlaviyo値レポートまたは時系列レポートを実行します。

設定

変数	必須	用途
KLAVIYO_KEY_MAIN（または任意のKLAVIYO_KEY_<name>）	はい	1つのKlaviyoアカウント用のプライベートAPIキー。アカウントごとに変数を1つ設定します。KLAVIYO_KEY_の後の名前がaccount引数になります。
KLAVIYO_API_BASE	いいえ	Klaviyo APIのベースURLを上書きします（デフォルトはhttps://a.klaviyo.com/api）。
KLAVIYO_RETRY_BASE_MS	いいえ	リトライのバックオフに使用する基本待機時間（ミリ秒）（デフォルトは1000）。

返信の形式

すべてのツールは、status（succeeded、partial、no_op）、operation、summary、target、result、proof、warnings、recoveryを含むプレーンなJSONを返します。失敗時は、プレーンなエラー文字列<code>: <message> <hint>をスローします。

制限

レポート用エンドポイント（campaign_report、flow_report、campaign_ab_report、flow_series_report、segment_report、form_report、値／系列レポート用のcustom_report）には、Klaviyo によるアカウントごとのレート制限があり、1 分あたり 2 リクエストまでです。レポートデータを利用できるのは 2023-06-01 以降のみです。それ以前の日付から始まるカスタム範囲は、この下限日に調整されます。1 回のレポートリクエストで指定できる期間は、暦年をまたげません。そのため、より長いカスタム範囲は、連続する年ごとのチャンクに自動的に分割され、各チャンクの間には間隔を空けて処理されます。

検証

各リリースでは、パッケージのバージョン、.mcpbの sha256、およびその元となった本番環境のコミットを CHANGELOG.md に記載しています。CI では、プッシュのたびにテストと、パッケージ化された tarball のクリーンインストールを実行します。

プライバシーポリシー

このサーバーは、独自の認証情報を使用して、お使いのマシン上でローカルに実行されます。個人データを収集せず、テレメトリーを含まず、データを永続的に保存せず、ラップ対象のベンダー API とのみ通信します。Scalably を含む第三者にデータが送信されることはありません。お問い合わせ先：[email protected]。正式版：https://scalably.io/connector-privacy.html

ライセンス

MIT。著作権者：Scalably。