Integrations
Used for managing environment variables, specifically storing the Klaviyo API key securely in a .env file for authentication.
Used for package management, installing dependencies, and running scripts for the MCP server including development and testing modes.
Klaviyo MCP サーバー強化
Klaviyo APIとの連携を可能にする包括的なモデルコンテキストプロトコル(MCP)サーバー。この拡張バージョンは、オリジナルのMCPサーバーとの完全な互換性を維持しながら、高度な分析機能、パフォーマンス最適化、堅牢なエラー処理を提供します。
🌟 主な機能
- 高度な分析とレポート: キャンペーンのパフォーマンス指標、集計データ、詳細な分析情報にアクセスします
- 包括的な API カバレッジ: 最新リビジョン (2024-06-15) のすべての Klaviyo API エンドポイントをサポート
- パフォーマンスの最適化: インテリジェントなキャッシュ、レート制限の処理、効率的なデータ処理
- 堅牢なエラー処理: フォールバックメカニズム、詳細なログ記録、そして正常なデグラデーション
- 簡単な統合: モデルコンテキストプロトコルを介してClaudeや他のLLMとシームレスに統合
📊 分析とレポート機能
この拡張バージョンでは、オリジナルにはなかった強力な分析機能が追加されています。
- キャンペーンパフォーマンス指標: 開封率、クリック率、直帰率など
- カスタムメトリック集計: 期間、ディメンション、測定値ごとにメトリックを集計します
- 収益帰属: キャンペーンやフローによって生成された収益を追跡します
- 加入者インサイト: 加入者の増加、エンゲージメント、行動を分析
🔧 技術的な強化
1. 集中設定✅
- すべてのAPIパラメータの中央設定システム(
src/config.js
)を作成しました - API の改訂日、有効な統計、その他のパラメータを簡単に設定できるようにしました
- APIパラメータが変更された場合に異なるファイル間での不整合を防止
2. 強化されたログシステム✅
- さまざまなログレベル(デバッグ、情報、警告、エラー)を備えた堅牢なログシステムを実装しました。
- APIリクエストとレスポンスの特別なログ記録を追加しました
- セキュリティのためログ内の機密データをマスク
- 設定可能なログ出力先と詳細度
3. インテリジェントなレート制限✅
- レート制限エラーの再試行ロジックを追加しました
- 再試行時にジッターを伴う指数バックオフを実装しました
- レート制限に遭遇したときに明確なフィードバックを追加しました
- レート制限中に重要なリクエストを優先する
4. パフォーマンスキャッシュ✅
- 頻繁にアクセスされるデータに対してメモリ内キャッシュを実装
- TTL(生存時間)に基づくキャッシュ無効化を追加
- さまざまなデータ タイプ (メトリック、キャンペーンなど) に合わせて最適化されたキャッシュ
- 監視と最適化のためのキャッシュ統計
5. エラー処理とフォールバック✅
- すべてのAPIインタラクションに対する包括的なエラー処理
- プライマリリクエストが失敗した場合の、パフォーマンス低下時のフォールバックメカニズム
- 詳細なエラーメッセージとトラブルシューティング情報
- JSON解析エラーの防止と処理
🔄 APIバージョン
この拡張バージョンは、最新の機能と改善を含むKlaviyo APIリビジョン2024-06-15
を使用しています。サーバーは、集中管理された設定システムを通じて、将来のAPIリビジョンとの互換性を維持するように設計されています。
📋 帰属表示
このプロジェクトは、 Matt Coatsworth氏が作成したオリジナルのKlaviyo MCPサーバーの拡張版です。この拡張版の基盤は、オリジナルの作業に基づいています。
🚀 はじめに
前提条件
- Node.js v18以上
- APIアクセス可能なKlaviyoアカウント
- 適切なスコープ (campaigns:read、metrics:read など) を持つプライベート API キー
インストール
- このリポジトリをクローンします:Copy
- 依存関係をインストールします:Copy
.env.example
に基づいて.env
ファイルを作成します。Copy.env
ファイルを編集して、Klaviyo API キーを追加します。Copy
サーバーの起動
自動リロード付きの開発モードでサーバーを起動します。
生産用途の場合:
MCP Inspectorによるテスト
MCP Inspector を使用してサーバーをテストできます。
これにより、利用可能なすべてのツールとリソースをテストできる Web インターフェイスが開きます。
📚 ドキュメント
分析機能と API パラメータの詳細については、以下を参照してください。
- ANALYTICS.md - 分析機能と使用方法に関する包括的なドキュメント
- docs/KLAVIYO_API_REFERENCE.md - Klaviyo APIパラメータのリファレンス
🔍 使用例
キャンペーンパフォーマンス指標の取得
集計されたメトリックのクエリ
キャンペーンパフォーマンスサマリーの取得
🛠️ 利用可能なツール
分析とレポート(拡張バージョンの新機能)
get_campaign_metrics
: 特定のキャンペーンのパフォーマンス指標 (開封率、クリック率など) を取得します。query_metric_aggregates
: カスタム分析レポート用に集計されたメトリックデータをクエリするget_campaign_performance
: キャンペーンの包括的なパフォーマンス概要を取得します
キャンペーン(拡張)
get_campaigns
: Klaviyoからキャンペーンを取得するget_campaign
: Klaviyoから特定のキャンペーンを取得するget_campaign_message
: テンプレートの詳細を含む特定のキャンペーンメッセージを取得しますget_campaign_messages
: 特定のキャンペーンのすべてのメッセージを取得するget_campaign_recipient_estimation
: キャンペーンの推定受信者数を取得する
プロフィール
get_profiles
: Klaviyoからプロファイルを取得するget_profile
: Klaviyoから特定のプロファイルを取得するcreate_profile
: Klaviyoで新しいプロフィールを作成するupdate_profile
: Klaviyo の既存のプロフィールを更新するdelete_profile
: Klaviyoからプロフィールを削除する
リストとセグメント
get_lists
: Klaviyoからリストを取得するget_list
: Klaviyoから特定のリストを取得するcreate_list
: Klaviyo で新しいリストを作成するadd_profiles_to_list
: Klaviyo のリストにプロフィールを追加するget_segments
: Klaviyoからセグメントを取得するget_segment
: Klaviyoから特定のセグメントを取得する
イベントとメトリクス
get_events
: Klaviyoからイベントを取得するcreate_event
: Klaviyoで新しいイベントを作成するget_metrics
: Klaviyoからメトリクスを取得するget_metric
: Klaviyoから特定のメトリックを取得する
フロー
get_flows
: Klaviyoからフローを取得するget_flow
: Klaviyoから特定のフローを取得するupdate_flow_status
: Klaviyo のフローのステータスを更新する
コンテンツ管理
get_templates
: Klaviyoからテンプレートを取得するget_template
: Klaviyoから特定のテンプレートを取得するcreate_template
: Klaviyo で新しいテンプレートを作成するget_images
: Klaviyoから画像を取得するget_image
: Klaviyoから特定の画像を取得する
電子商取引
get_catalogs
: Klaviyoからカタログを取得するget_catalog_items
: Klaviyo のカタログからアイテムを取得するget_catalog_item
: Klaviyo のカタログから特定のアイテムを取得するget_coupons
: Klaviyoからクーポンを入手create_coupon_code
: Klaviyoで新しいクーポンコードを作成する
追加ツール
get_tags
: Klaviyoからタグを取得するcreate_tag
: Klaviyoで新しいタグを作成するadd_tag_to_resource
: Klaviyo のリソースにタグを追加するget_webhooks
: KlaviyoからWebhookを取得するcreate_webhook
: Klaviyo で新しい Webhook を作成するdelete_webhook
: Klaviyo から Webhook を削除しますrequest_profile_deletion
: データプライバシーコンプライアンスのためのプロファイルの削除をリクエストするget_forms
: Klaviyoからフォームを取得するget_form
: Klaviyoから特定のフォームを取得するget_product_reviews
: Klaviyo から製品レビューを取得するget_product_review
: Klaviyo から特定の製品のレビューを取得する
🔗 利用可能なリソース
klaviyo://profile/{id}
: 特定のプロフィールに関する情報を取得するklaviyo://list/{id}
: 特定のリストに関する情報を取得するklaviyo://segment/{id}
: 特定のセグメントに関する情報を取得するklaviyo://campaign/{id}
: 特定のキャンペーンに関する情報を取得するklaviyo://flow/{id}
: 特定のフローに関する情報を取得するklaviyo://template/{id}
: 特定のテンプレートの情報を取得するklaviyo://metric/{id}
: 特定のメトリックに関する情報を取得するklaviyo://catalog/{id}
: 特定のカタログに関する情報を取得する
⚠️ 既知の問題と制限事項
- Klaviyo APIはレポートエンドポイントにレート制限を課す可能性があります
- 一部の指標はAPIで利用できるようになるまでに時間がかかる場合があります
- 履歴データの利用可能範囲は、Klaviyoプランによって制限される場合があります。
- Claude Desktop を使用する場合、機能に影響しない JSON 解析の警告が表示されることがあります。
📝 ライセンス
このプロジェクトはオリジナルのKlaviyo MCPサーバーから派生したものです。ライセンス情報については、オリジナルの作者にお問い合わせください。
👥 貢献者
- マット・コートワースによるオリジナル作品
- イヴァン・リベラによる強化版
🔗 外部リソース
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Klaviyo API とのやり取りを可能にし、顧客プロファイル、リスト、セグメント、キャンペーン、フロー、およびさまざまなマーケティング自動化機能を管理するためのツールとリソースを提供する包括的なモデル コンテキスト プロトコル サーバーです。
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.Last updated -JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides seamless interaction with Workato's API through custom AI tools, enabling management of recipes, connections, connectors, folders, and activity logs.Last updated -TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides a comprehensive interface for interacting with the ConnectWise Manage API, simplifying API discovery, execution, and management for both developers and AI assistants.Last updated -462Python
- -securityAlicense-qualityA Model Context Protocol server that provides standardized interfaces for interacting with Ollama API, offering JSON responses, error handling, and intelligent guidance for LLM-based API calls.Last updated -PythonMIT License