Klaviyo MCP Server

Klaviyo MCP サーバー

Klaviyo API と連携するための包括的な Model Context Protocol（MCP）サーバーです。このサーバーは、Klaviyo でプロフィール、リスト、セグメント、キャンペーン、フローなどを管理するためのツールとリソースを提供します。

## 機能

- Klaviyo API エンドポイントを網羅
- Klaviyo の主要なすべての操作に対応する MCP ツール
- Klaviyo のデータにアクセスするための MCP リソース
- Model Context Protocol を介して LLM と簡単に連携

## セットアップ

1. このリポジトリをクローンします
2. 依存関係をインストールします：
   ```
   npm install
   ```
3. `.env.example` をもとに `.env` ファイルを作成し、Klaviyo API キーを追加します：
   ```
   KLAVIYO_API_KEY=your_private_api_key_here
   ```
4. サーバーを起動します：
   ```
   npm run dev
   ```

## MCP Inspector でのテスト

MCP Inspector を使用してサーバーをテストできます：

```
npm run inspect
```

利用可能なすべてのツールとリソースをテストできるウェブインターフェースが開きます。

## 利用可能なツール

### プロフィール
- `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_campaigns`：Klaviyo のキャンペーンを取得します
- `get_campaign`：Klaviyo の特定のキャンペーンを取得します

### フロー
- `get_flows`：Klaviyo のフローを取得します
- `get_flow`：Klaviyo の特定のフローを取得します
- `update_flow_status`：Klaviyo のフローのステータスを更新します

### テンプレート
- `get_templates`：Klaviyo のテンプレートを取得します
- `get_template`：Klaviyo の特定のテンプレートを取得します
- `create_template`：Klaviyo に新しいテンプレートを作成します

### カタログ
- `get_catalogs`：Klaviyo のカタログを取得します
- `get_catalog_items`：Klaviyo のカタログからアイテムを取得します
- `get_catalog_item`：Klaviyo のカタログから特定のアイテムを取得します

### タグ
- `get_tags`：Klaviyo のタグを取得します
- `create_tag`：Klaviyo に新しいタグを作成します
- `add_tag_to_resource`：Klaviyo のリソースにタグを追加します

### ウェブフック
- `get_webhooks`：Klaviyo のウェブフックを取得します
- `create_webhook`：Klaviyo に新しいウェブフックを作成します
- `delete_webhook`：Klaviyo からウェブフックを削除します

### データプライバシー
- `request_profile_deletion`：データプライバシー規制への準拠のため、プロフィールの削除をリクエストします

### クーポン
- `get_coupons`：Klaviyo のクーポンを取得します
- `create_coupon_code`：Klaviyo に新しいクーポンコードを作成します

### フォーム
- `get_forms`：Klaviyo のフォームを取得します
- `get_form`：Klaviyo の特定のフォームを取得します

### レビュー
- `get_product_reviews`：Klaviyo の商品レビューを取得します
- `get_product_review`：Klaviyo の特定の商品レビューを取得します

### 画像
- `get_images`：Klaviyo の画像を取得します
- `get_image`：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}`：特定のカタログに関する情報を取得します

## API ドキュメント

Klaviyo API の詳細については、[公式ドキュメント](https://developers.klaviyo.com/en/reference/api_overview)をご覧ください。