Klaviyo MCP Server 4 15

🚀 Klaviyo API MCP 服務器

Klaviyo API MCP 服務器是一個全面的模型上下文協議（MCP）服務器，用於與 Klaviyo 的 API 進行交互。它提供了豐富的工具和資源，可用於管理配置文件、列表、事件、活動、流程、模板、段、指標、目錄和數據隱私。

✨ 主要特性

• 全面覆蓋 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

這將打開一個網絡界面，允許你：

• 查看可用工具和資源。
• 使用不同輸入測試工具。
• 查看服務器日誌和響應。

高級用法

以下是服務器提供的可用工具及其功能：

配置文件

• 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 參考和使用說明。