Klaviyo MCP Server 4 15

🚀 Klaviyo API MCP サーバー

Klaviyo の API とやり取りするための包括的なモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、プロファイル、リスト、イベント、キャンペーン、フロー、テンプレート、セグメント、メトリクス、ディレクトリ、およびデータプライバシーの管理に必要なツールとリソースを提供します。

✨ 主な機能

• Klaviyo の API 機能を網羅
• Zod を使用した適切な検証を行う構造化ツール
• API リファレンスドキュメントのリソース
• エラー処理とログ記録

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .env ファイルを作成し、Klaviyo API キーを含めます。

   KLAVIYO_API_KEY=your_private_api_key_here
   

4. サーバーを起動します。

   npm run dev
   

💻 使用例

基本的な使用法

MCP モニターを使用してテストすることができます。

npm run inspect

これにより、Web インターフェースが開き、以下のことができます。

• 利用可能なツールとリソースを表示
• 異なる入力でツールをテスト
• サーバーのログと応答を表示

高度な使用法

以下は、利用可能なツールの一覧です。

プロファイル

• get_profiles：プロファイルのリストを取得し、必要に応じてフィルタリングできます。
• get_profile：特定のプロファイル ID を取得します。
• create_profile：新しいプロファイルを作成します。
• update_profile：既存のプロファイルを更新します。
• delete_profile：プロファイルを削除します。

リスト

• get_lists：すべてのリストを取得します。
• get_list：ID で特定のリストを取得します。
• create_list：新しいリストを作成します。
• update_list：既存のリストを更新します。
• delete_list：リストを削除します。
• get_list_profiles：リスト内のプロファイルを取得します。
• add_profiles_to_list：プロファイルをリストに追加します。
• remove_profiles_from_list：リストからプロファイルを削除します。

イベント

• get_events：イベントのリストを取得し、必要に応じてフィルタリングできます。
• get_event：ID で特定のイベントを取得します。
• create_event：新しいイベントを作成します。

キャンペーン

• get_campaigns：キャンペーンのリストを取得し、必要に応じてフィルタリングできます。
• get_campaign：ID で特定のキャンペーンを取得します。
• create_campaign：新しいキャンペーンを作成します。
• update_campaign：既存のキャンペーンを更新します。
• delete_campaign：キャンペーンを削除します。

フロー

• get_flows：すべてのフローを取得します。
• get_flow：ID で特定のフローを取得します。
• create_flow：新しいフローを作成します。
• update_flow：既存のフローを更新します。
• delete_flow：フローを削除します。

テンプレート

• get_templates：すべてのテンプレートを取得します。
• get_template：ID で特定のテンプレートを取得します。
• create_template：新しいテンプレートを作成します。
• update_template：既存のテンプレートを更新します。
• delete_template：テンプレートを削除します。

セグメント

• get_segments：すべてのセグメントを取得します。
• get_segment：ID で特定のセグメントを取得します。
• create_segment：新しいセグメントを作成します。
• update_segment：既存のセグメントを更新します。
• delete_segment：セグメントを削除します。

メトリクス

• get_metrics：メトリクスのリストを取得します。
• get_metric：ID で特定のメトリクスを取得します。
• create_metric：新しいメトリクスを作成します。
• update_metric：既存のメトリクスを更新します。
• delete_metric：メトリクスを削除します。

ディレクトリ

• get_directories：すべてのディレクトリを取得します。
• get_directory：ID で特定のディレクトリを取得します。
• create_directory：新しいディレクトリを作成します。
• update_directory：既存のディレクトリを更新します。
• delete_directory：ディレクトリを削除します。

📚 ドキュメント

• ドキュメントのパス：詳細な API リファレンスと使用方法の説明が提供されています。