MCP 経由で Smartlead を Cursor に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Smartlead をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Smartlead + Cursor

あらゆる AI エージェントから Smartlead のコールドメール配信を操作：シーケンスとスケジュール付きのキャンペーンの作成と運用、リードとカテゴリーの管理、マスター受信箱での返信の確認と回答、キャンペーンとアカウントの分析の比較、送信用メールボックスとウォームアップの確認。Smartlead の API キーで動作し、取り消せない配信停止と削除はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

SMARTLEAD_API_KEY

ステップ 1 — 認証情報を取得

設定は約 2 分です。API の利用には Smartlead の有料プランが必要です。

1. Smartlead で Settings を開き、API Keys セクションに進みます（プランによっては Settings、Integrations の中にあります）。
2. API キーを SMARTLEAD_API_KEY にコピーします。コネクタはすべてのリクエストにクエリパラメーター api_key として付けるので、キーだけを貼り付けてください。
3. コネクタをインストールし、smartlead_list_campaigns を実行します。キャンペーンが一覧表示され、キーが確認できます。

キーはアカウントへのフルアクセスを与えるので、パスワードと同じように扱ってください。

キャンペーン: 最初は smartlead_list_campaigns です。各キャンペーンの id が、ほかのすべてのツールの campaign_id になります。smartlead_get_campaign、smartlead_get_campaign_sequences、smartlead_list_campaign_email_accounts で設定を確認できます。新しく作るときは、AI が smartlead_create_campaign（DRAFTED 状態の空のキャンペーン）、smartlead_save_campaign_sequences、smartlead_update_campaign_schedule（タイムゾーン、曜日、送信時間帯、メール間隔の分数、1 日あたりの新規リード数、開始時刻）、smartlead_update_campaign_settings（名前、開封とクリックのトラッキング、リードへの送信を止める条件、プレーンテキスト、フォローアップの割合、AI によるメールボックス割り当て、配信停止テキスト）、smartlead_add_email_accounts_to_campaign、smartlead_add_leads_to_campaign を順に呼び、最後に smartlead_update_campaign_status を START で実行します。ステータスは START（ACTIVE ではありません）、PAUSED、STOPPED（終了で元に戻せません。一時停止なら PAUSED）、ARCHIVED です。開始すると実際にメールが送られるので、先にシーケンス、スケジュール、リード数を AI に表示させてください。

シーケンス: smartlead_save_campaign_sequences はシーケンス全体を置き換え、含めなかったステップは削除されます。AI はまず smartlead_get_campaign_sequences で読み、既存ステップの ID を保ったまま全ステップを送ります。差し込みには {{first_name}}、{{company_name}}、カスタムフィールド名を使います。

リード:

• smartlead_list_campaign_leads はキャンペーンのリードを一覧表示します。各行にはキャンペーンとリードの紐付け ID（行の id。smartlead_create_lead_note で使用）とリード本体（lead.id。lead_id として使用）があります。
• smartlead_get_lead_by_email は全キャンペーンからリードを探し、smartlead_get_lead は ID で読み、smartlead_get_lead_campaign_overview はそのリードが入っているすべてのキャンペーンを表示します。
• smartlead_add_leads_to_campaign は 1 回の呼び出しで最大 400 件です。グローバルブロックリストにある、配信停止済み、またはほかのキャンペーンに入っているリードは、設定で許可しない限りスキップされます。応答にはアップロード、重複、ブロックの件数が入ります。
• 変更: smartlead_update_lead（変わらなくても API はメールアドレスを必須とします。カスタムフィールドは最大 200 個）、smartlead_update_lead_category（ID は smartlead_list_lead_categories から。一時停止も同時に可能）、smartlead_pause_lead、smartlead_resume_lead（すぐに、または指定日数後）、1 つのキャンペーンからの配信停止は smartlead_unsubscribe_lead_from_campaign です。

返信: smartlead_list_inbox_replies はマスター受信箱の返信を全キャンペーン横断で新しい順に一覧表示し、キャンペーン、メールボックス、カテゴリー、返信時刻で絞り込めます。smartlead_get_inbox_item は 1 つのスレッドを開きます。返信するには、smartlead_get_lead_message_history が各メッセージの stats_id、message_id、time を返し、AI がそれを email_stats_id、reply_message_id、reply_email_time として smartlead_reply_to_lead に渡します。返信はそのスレッドのメールボックスから、すぐに、または scheduled_time に送られます。smartlead_create_lead_note は社内メモを追加します。

分析: キャンペーンごとに smartlead_get_campaign_analytics（開始以来の合計とリードの進捗）、smartlead_get_campaign_analytics_by_date、smartlead_get_campaign_sequence_analytics（ステップと A/B バリアントごと）、smartlead_get_campaign_statistics（送信メール 1 通につき 1 行）があります。smartlead_get_overall_analytics はアカウント全体を対象とし、一部のキャンペーンやクライアントに絞ることもできます。

メールボックスとウォームアップ: smartlead_list_email_accounts はアドレス、プロバイダー、1 日の上限、SMTP/IMAP の状態、ウォームアップを表示します。接続が壊れていると isSmtpSuccess=false です。ほかに smartlead_get_email_account、smartlead_get_warmup_stats（直近 7 日間: 送信したウォームアップメール、受信箱到達、迷惑メール到達、返信）、smartlead_update_email_account（1 日の送信上限、送信者名、署名、BCC、独自のトラッキングドメイン、メール間隔の分数）、smartlead_update_warmup（オンかオフ、1 日の量、段階的な増加、返信率）があります。

Webhook、代理店、リスト: smartlead_list_campaign_webhooks と smartlead_upsert_campaign_webhook（新規作成、または id を渡すと更新）で、イベントは EMAIL_SENT、EMAIL_OPEN、EMAIL_LINK_CLICK、EMAIL_REPLY、EMAIL_BOUNCE、LEAD_UNSUBSCRIBED、LEAD_CATEGORY_UPDATED です。smartlead_list_clients は代理店（ホワイトラベル）アカウントのクライアント ID を返し、smartlead_list_lead_lists はリードリストを一覧表示します。

インストール時はオフ: smartlead_unsubscribe_lead_globally（リードを全キャンペーンから配信停止し、そのアドレスの今後のインポートもブロック）、smartlead_delete_lead_from_campaign（そのキャンペーンからリードと進捗を削除）、smartlead_delete_campaign_webhook です。元に戻せないため、チームに必要になったときにワークスペース管理者がオンにします。

データ形式: 件数はメールまたはリードの数で、率はパーセントです。分析の日付は YYYY-MM-DD で、日の区切りには任意の IANA タイムゾーン（既定は UTC）を指定できます。タイムスタンプは、タイムゾーンを渡さない限り UTC の ISO 8601 です。

ページング: 一覧は offset（既定 0）と limit（既定 100、受信箱は 20）を受け取ります。AI は返る行数が limit より少なくなるまで offset を limit ずつ増やします。smartlead_list_campaign_leads は total_leads も返します。

制限とよくあるエラー: Smartlead は短時間に集中したリクエストを制限し（標準プランで 2 秒あたり約 10 リクエスト）、429 を返します。少し待って再試行してください。401 Invalid API Key はキーの誤り、404 は ID の誤りか別アカウントの ID、400 は無効なフィールド名を示します。

このコネクタは新しい送信用メールボックスの接続とキャンペーンの削除は行いません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Cursor にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Cursor は ~/.cursor/mcp.json から MCP サーバーを読み込みます。次のエントリを追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、Cursor を再起動します。
3. Cursor → Settings → MCP を開き、anythingmcp が一覧にあり接続済みであることを確認します。
4. チャットを始めましょう。エージェントが Smartlead のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「今月いちばん返信率が高い稼働中のキャンペーンはどれ？それぞれの送信数、返信数、バウンス数を見せて。」
• 「直近 24 時間の返信のうち、Interested に分類されたものを見せて。」
• 「Q4 Outreach キャンペーンで [email protected] から届いた最新のメールに返信して、来週の通話を提案して。送る前に文面を見せて。」
• 「SMTP 接続が壊れている、またはウォームアップメールが迷惑メールに多く入っている送信用メールボックスはどれ？」
• 「[email protected] のリードを、入っているすべてのキャンペーンで一時停止して。」

FAQ

Cursor の無料プランでカスタム MCP サーバーは使えますか? はい。MCP は Hobby、Pro、Business の各プランで利用できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Gemini に接続
• Meta Muse に接続
• Microsoft Copilot に接続