machfive

MachFive MCP サーバー

MachFive MCP サーバーとは？

MCP（Model Context Protocol）は、Claude などの AI アシスタントが外部アプリに接続できるようにするオープン標準です。AI とソフトウェアをつなぐ共通の翻訳機のようなものです。

MachFive MCP サーバーは、AI アシスタントが MachFive アカウントと直接やり取りできるようにするコネクターです。AI に自然な会話で指示するだけで、キャンペーンの一覧表示、パーソナライズ度の高いコールドメールのシーケンス生成、リードリストの管理、結果のエクスポートなどを行えます。

MachFive にログインして CSV をアップロードし、結果を待つ代わりに、AI に必要なことを伝えるだけで済みます。

• 「SaaS Founders キャンペーンを使って、[email protected] 宛ての 3 通のメールシーケンスを生成して」
• 「MachFive のキャンペーンを表示して」
• 「この 50 件のリードをバッチ処理に送信して」
• 「最新のバッチのステータスを確認して、結果をエクスポートして」

AI がリクエストを理解し、MCP を通じて MachFive に接続して操作を実行します。すべて数秒で完了します。

---

MachFive MCP のセットアップ方法

ステップ 1：API キーを取得する（2 分）

1. app.machfive.co で MachFive アカウントにログインします
2. Settings → API Keys に移動します
3. Create API Key をクリックします
4. キーをコピーして、安全な場所に保管します

⚠️ このキーは非公開にしてください。MachFive アカウントのパスワードのようなものです。

---

ステップ 2：AI クライアントを接続する

オプション A：Claude Desktop（最も簡単）

1. Claude Desktop アプリを開きます
2. Settings → Connectors に移動します
3. Add custom connector をクリックします
4. 次の情報を入力します：
   • Name： MachFive
   • Remote MCP server URL： https://mcp.machfive.co/mcp/YOUR_API_KEY
5. YOUR_API_KEY を作成した API キーに置き換えます
6. Add をクリックします。再起動は不要です！

オプション B：Claude Desktop（設定ファイル）

設定ファイルを直接編集する場合：

1. Settings → Developer → Edit Config に移動します
2. 設定ファイルに以下を追加します（YOUR_API_KEY を置き換えてください）：

{
  "mcpServers": {
    "machfive": {
      "url": "https://mcp.machfive.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

3. 保存して、Claude Desktop を再起動します

オプション C：Cursor

1. Cursor → Settings（⌘ + ,）を開きます
2. MCP を検索します
3. Edit in settings.json をクリックします
4. 以下を追加します（YOUR_API_KEY を置き換えてください）：

{
  "mcpServers": {
    "machfive": {
      "url": "https://mcp.machfive.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

5. 保存して、Cursor を再起動します

オプション D：n8n（AI エージェントとワークフロー）

n8n で AI エージェントを使ってワークフローを自動化するには：

1. MCP Client ノードをワークフローに追加します
2. トランスポートオプションとして Streamable HTTP を選択します
3. URL を入力します：https://mcp.machfive.co/mcp/YOUR_API_KEY
4. AI エージェントノードに接続します

オプション E：その他の MCP クライアント

MCP 対応クライアントでは、API キーを含む次の URL を使用します：

https://mcp.machfive.co/mcp/YOUR_API_KEY

この URL は、Streamable HTTP トランスポートに対応するすべてのクライアントで使用できます。

---

ステップ 3：テストする！（30 秒）

AI アシスタントを開き、次のように試してください：

「MachFive のキャンペーンを一覧表示して」

キャンペーンの一覧が表示されれば、接続できています！ 🎉

---

認証

MachFive MCP は、次の 3 つの認証方法に対応しています。

方法	形式	最適な用途
URL パス	https://mcp.machfive.co/mcp/YOUR_API_KEY	ヘッダーに対応していないクライアント、n8n
Authorization ヘッダー	Authorization: Bearer YOUR_API_KEY	Claude Desktop、Cursor
Authorization ヘッダー（プレフィックスなし）	Authorization: YOUR_API_KEY	シンプルなインテグレーション

Authorization ヘッダーでは、Bearer プレフィックスは省略できます。

---

利用可能なツール

MachFive MCP は、コールドメール生成用に 6 つのツールを提供します。

📋 キャンペーン

ツール	説明
list_campaigns	ワークスペース内のすべてのキャンペーンを一覧表示します。最初にこれを呼び出してください。生成にはキャンペーン ID が必要です。

✉️ メール生成

ツール	説明
generate_sequence	1 件のリード向けにパーソナライズされたメールシーケンスを生成します（同期処理、3～10 分）。
generate_batch	複数のリードを一括生成に送信します（非同期処理。リスト ID をすぐに返します）。

📦 リスト管理

ツール	説明
list_lists	リードリストと一括処理ジョブを参照します。
get_list_status	一括処理ジョブが完了または失敗するまで、ステータスを確認します。
export_list	一括処理の完了後、結果を JSON または CSV としてダウンロードします。

---

何ができますか？

✉️ メール生成

• 「Gator 100 キャンペーンを使って、[email protected] 宛てのコールドメールシーケンスを作成して」
• 「Acme Corp の営業担当副社長、John Smith 向けに、パーソナライズされたメールを 5 通書いて」
• 「このリード向けに、ROI の事例紹介を切り口としたメールを生成して」

📦 一括処理

• 「この 20 件のリードを一括メール生成に送信して」
• 「最新の一括処理のステータスを確認して」
• 「完了した一括処理を CSV としてエクスポートして」

📋 キャンペーン管理

• 「MachFive のキャンペーンを一覧表示して」
• 「どのキャンペーンがある？」
• 「キャンペーン ID を表示して」

📊 結果とエクスポート

• 「前回の一括処理の結果を JSON としてエクスポートして」
• 「SaaS Founders リストの CSV をダウンロードして」
• 「リスト xyz の生成済みメールを表示して」

---

会話の例

1 件のリードをすばやく生成

あなた：「Marketing Agencies キャンペーンを使って、[email protected] 宛てのメールを 3 通作成して。名前は Jane Doe で、グロース担当副社長です。」

AI：「今からシーケンスを生成します。MachFive が見込み顧客を調査し、パーソナライズされたメールを作成するため、通常 3～5 分かかります……」

[3 分後]

AI：「Acme の Jane Doe 向けのメールシーケンスはこちらです。

メール 1 — 件名：ちょっとした質問です、Jane こんにちは、Jane。Acme が最近事業を拡大したことに気付きました……」

一括処理のワークフロー

あなた：「処理するリードが 25 件あります。こちらです：[リードを貼り付け]。SaaS Founders キャンペーンを使ってください。」

AI：「一括処理を送信しました！リスト ID は abc-123 です。ステータスを確認します……」

[自動的にステータスを確認]

AI：「一括処理が完了しました。25 件すべてのリードを処理し、メールを 75 通生成しました。CSV または JSON としてエクスポートしますか？」

朝のワークフロー確認

あなた：「どのキャンペーンがありますか？また、処理中の一括処理はありますか？」

AI：「キャンペーンは 3 件あります：First Campaign、Gator 100、Marketing Agencies です。現在の一括処理はすべて完了しており、保留中のジョブはありません。」

---

トラブルシューティング

問題	解決方法
接続に失敗しました	API キーが正しいことを再確認してください
「Invalid API key」エラー	MachFive の設定で API キーを再生成してください
応答がありません	AI クライアントを再起動してください
generate_sequence がタイムアウトする	正常です。生成には 3～10 分かかります。再試行しないでください。
サーバーを利用できません	インターネット接続を確認して、もう一度お試しください

---

よくある質問

1. コーディングの知識は必要ですか？

いいえ。セットアップは約 5 分で、AI アシスタントの設定に API キーを貼り付けるだけです。

2. どの AI アシスタントに対応していますか？

次のような、MCP 対応クライアントであればどれでも利用できます。

• Claude Desktop（Anthropic）
• Cursor（AI コードエディター）
• n8n（AI エージェントのワークフロー）
• Streamable HTTP トランスポートに対応する任意のアプリ

3. データは安全ですか？

はい。接続には、暗号化された HTTPS 経由で個人用 API キーを使用します。AI がアクセスできるのは、API キーで許可された範囲だけです。各ユーザーは自身のキーで認証し、MachFive が MCP サーバー上で API キーを保存または共有することはありません。

4. AI は MachFive で何ができますか？

AI では次のことができます。

• キャンペーンの一覧表示
• 個々のリード向けにパーソナライズされたコールドメールシーケンスの生成
• 一括生成用のリードの送信
• 一括処理ステータスの確認
• 完了した結果の CSV または JSON へのエクスポート

5. 利用料金はいくらですか？

MCP サーバーは MachFive のサブスクリプションに含まれており、無料で利用できます。メール生成には通常どおりアカウントのクレジットが使用されます。

6. 接続 URL は何ですか？

https://mcp.machfive.co/mcp

7. メールの生成にはどのくらい時間がかかりますか？

単一のリードの生成（generate_sequence）には、MachFive が見込み客を調査し、真にパーソナライズされたメールを作成するため、3〜10 分かかります。バッチ生成（generate_batch）はすぐに結果を返します。処理はバックグラウンドで行われ、完了するまでポーリングします。

8. 問題が発生した場合はどうなりますか？

生成処理は既存データに影響を与えず、新しいメールシーケンスを作成するだけです。バッチが失敗した場合は、新しいバッチを送信してください。

---

API エンドポイント

エンドポイント	URL
ヘルスチェック	https://mcp.machfive.co/
MCP プロトコル	https://mcp.machfive.co/mcp
API キー付き MCP	https://mcp.machfive.co/mcp/YOUR_API_KEY

---

サポートが必要ですか？ [email protected] までお問い合わせください。

MCP ドキュメント： modelcontextprotocol.io