Smartlead MCP Server

Smartlead MCP サーバー

Smartlead キャンペーン管理と連携するための Model Context Protocol（MCP）サーバーです。キャンペーンの作成と管理、キャンペーン設定の更新、キャンペーンシーケンスの管理を行うツールを提供します。

機能

• 新しいキャンペーンを作成
• キャンペーンのスケジュール設定を更新
• キャンペーンの一般設定を更新
• キャンペーンの詳細を取得
• フィルタリングオプションを指定してすべてのキャンペーンを一覧表示
• キャンペーンのメールシーケンスを管理（保存、取得、更新、削除）
• キャンペーン内のメールアカウントを管理（追加、更新、削除）
• キャンペーン内のリードを管理（追加、更新、削除）

インストール

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

npm install

3. .env.example を基に .env ファイルを作成し、Smartlead API キーを追加します：

SMARTLEAD_API_KEY=your_api_key_here

4. プロジェクトをビルドします：

npm run build

使用方法

単独での使用

サーバーを直接起動するには：

npm start

Claude との連携

この MCP サーバーを Claude で使用するには、MCP 設定ファイルに追加する必要があります：

1. Claude VSCode 拡張機能の場合は、c:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json に追加します
2. Claude デスクトップアプリの場合は、Windows では %APPDATA%\Claude\claude_desktop_config.json に追加します

設定例：

{
  "mcpServers": {
    "smartlead": {
      "command": "node",
      "args": ["E:/mcp-servers/smartlead/dist/index.js"],
      "env": {
        "SMARTLEAD_API_KEY": "your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

your_api_key_here を実際の Smartlead API キーに置き換えてください。

設定

サーバーは環境変数を使って設定できます：

• SMARTLEAD_API_KEY（必須）：Smartlead API キー
• SMARTLEAD_API_URL（任意）：カスタム API URL（デフォルトは https://server.smartlead.ai/api/v1）
• SMARTLEAD_RETRY_MAX_ATTEMPTS：API 呼び出しの最大再試行回数（デフォルト：3）
• SMARTLEAD_RETRY_INITIAL_DELAY：再試行までの初期待機時間（ミリ秒）（デフォルト：1000）
• SMARTLEAD_RETRY_MAX_DELAY：再試行までの最大待機時間（ミリ秒）（デフォルト：10000）
• SMARTLEAD_RETRY_BACKOFF_FACTOR：再試行の待機時間に適用するバックオフ係数（デフォルト：2）

利用可能なツール

smartlead_create_campaign

Smartlead で新しいキャンペーンを作成します。

パラメーター：

• name（必須）：キャンペーン名
• client_id（任意）：キャンペーンのクライアント ID

smartlead_update_campaign_schedule

キャンペーンのスケジュール設定を更新します。

パラメーター：

• campaign_id（必須）：更新するキャンペーンの ID
• timezone：キャンペーンのタイムゾーン（例："America/Los_Angeles"）
• days_of_the_week：メールを送信する曜日（1～7。1 は月曜日）
• start_hour：24 時間形式の開始時刻（例："09:00"）
• end_hour：24 時間形式の終了時刻（例："17:00"）
• min_time_btw_emails：メール間の最小間隔（分）
• max_new_leads_per_day：1 日あたりの新規リードの最大数
• schedule_start_time：ISO 形式のスケジュール開始時刻

smartlead_update_campaign_settings

キャンペーンの一般設定を更新します。

パラメーター：

• campaign_id（必須）：更新するキャンペーンの ID
• name：キャンペーンの新しい名前
• status：キャンペーンのステータス（active、paused、completed）
• settings：その他のキャンペーン設定

smartlead_get_campaign

ID を指定して特定のキャンペーンの詳細を取得します。

パラメーター：

• campaign_id（必須）：取得するキャンペーンの ID

smartlead_list_campaigns

任意のフィルターを指定して、すべてのキャンペーンを一覧表示します。

パラメーター：

• status：ステータスでキャンペーンを絞り込みます（active、paused、completed、all）
• limit：返すキャンペーンの最大数
• offset：ページネーションのオフセット

smartlead_save_campaign_sequence

A/B テストのバリアントを含む、キャンペーンのメールシーケンスを保存します。

パラメーター:

• campaign_id（必須）：キャンペーンの ID
• sequences（必須）：メールシーケンス項目の配列。各項目の内容：
  • id：シーケンスの ID（更新時のみ。作成時は省略）
  • seq_number（必須）：シーケンス番号（シーケンス内の順序）
  • seq_delay_details（必須）：遅延設定。内容：
    • delay_in_days（必須）：このメールを送信するまでの日数
  • variant_distribution_type：バリアントの配分タイプ（MANUAL_EQUAL、MANUAL_PERCENTAGE、AI_EQUAL）
  • lead_distribution_percentage：勝者の判定に使用するリードプールのサンプル割合
  • winning_metric_property：勝者のバリアントの判定に使用する指標（OPEN_RATE、CLICK_RATE、REPLY_RATE、POSITIVE_REPLY_RATE）
  • seq_variants：メールバリアントの配列。各バリアントの内容：
    • subject（必須）：メールの件名
    • email_body（必須）：メール本文の内容（HTML）
    • variant_label（必須）：バリアントのラベル（例：「A」、「B」、「C」）
    • id：バリアントの ID（更新時のみ。作成時は省略）
    • variant_distribution_percentage：このバリアントを受信するリードの割合
  • subject：メールの件名（シンプルなフォローアップの場合、空欄にすると同じスレッドで送信されます）
  • email_body：シンプルなフォローアップ用のメール本文の内容（HTML）

smartlead_get_campaign_sequence

キャンペーンのメールシーケンスを取得します。

パラメーター:

• campaign_id（必須）：キャンペーンの ID

smartlead_update_campaign_sequence

キャンペーンシーケンス内の特定のメールを更新します。

パラメーター:

• campaign_id（必須）：キャンペーンの ID
• sequence_id（必須）：更新するシーケンスメールの ID
• subject：更新後のメールの件名
• body：更新後のメール本文の内容
• wait_days：このメールを送信するまでの更新後の日数

smartlead_delete_campaign_sequence

キャンペーンシーケンスから特定のメールを削除します。

パラメーター:

• campaign_id（必須）：キャンペーンの ID
• sequence_id（必須）：削除するシーケンスメールの ID

smartlead_add_email_account_to_campaign

メールアカウントをキャンペーンに追加します。

パラメーター:

• campaign_id（必須）：キャンペーンの ID
• email_account_id（必須）：追加するメールアカウントの ID

smartlead_update_email_account_in_campaign

キャンペーン内のメールアカウントを更新します。

パラメーター:

• campaign_id（必須）：キャンペーンの ID
• email_account_id（必須）：更新するメールアカウントの ID
• settings：このキャンペーンにおけるメールアカウントの設定

smartlead_delete_email_account_from_campaign

キャンペーンからメールアカウントを削除します。

パラメーター:

• campaign_id（必須）：キャンペーンの ID
• email_account_id（必須）：削除するメールアカウントの ID

smartlead_add_lead_to_campaign

リードをキャンペーンに追加します（一度に最大100件）。

パラメーター:

• campaign_id（必須）：キャンペーンの ID
• lead_list（必須）：リード情報オブジェクトの配列（最大100件）。各項目の内容：
  • email（必須）：リードのメールアドレス
  • first_name：リードの名
  • last_name：リードの姓
  • company_name：リードの会社名
  • phone_number：リードの電話番号
  • website：リードのウェブサイト
  • location：リードの所在地
  • custom_fields：リードのカスタムフィールド（最大20項目）
  • linkedin_profile：リードの LinkedIn プロフィール URL
  • company_url：リードの会社 URL
• settings：リード追加の設定：
  • ignore_global_block_list：true の場合、アップロードされたリードはグローバルブロックリストを回避します
  • ignore_unsubscribe_list：true の場合、リードは配信停止済みのリードとの照合を回避します
  • ignore_community_bounce_list：true の場合、アップロードされたリードはユーザーベース全体でバウンスしたリードとの照合を回避します
  • ignore_duplicate_leads_in_other_campaign：true の場合、リードは他のキャンペーンとの照合を回避しません

smartlead_update_lead_in_campaign

キャンペーン内のリードを更新します。

パラメーター：

• campaign_id（必須）：キャンペーンの ID
• lead_id（必須）：更新するリードの ID
• lead（必須）：更新後のリード情報。以下が含まれます：
  • email：リードのメールアドレス
  • first_name：リードの名
  • last_name：リードの姓
  • company：リードの会社
  • custom_variables：リードのカスタム変数

smartlead_delete_lead_from_campaign

キャンペーンからリードを削除します。

パラメーター：

• campaign_id（必須）：キャンペーンの ID
• lead_id（必須）：削除するリードの ID

ライセンス

MIT