Fluentcrm MCP Server

🚀 FluentCRM MCP Server

FluentCRM用のMCPサーバー - すべてのマーケティングオートメーションをCursorから直接管理できます！

---

📋 目次

• MCPサーバーとは？
• 必要条件
• インストール
• 設定
• 使用方法
• 利用可能なツール
• 使用例
• トラブルシューティング

---

MCPサーバーとは？

MCP（Model Context Protocol）は、AIモデル（Cursor内のClaudeを含む）が外部システムに接続できるようにする、Anthropicによる新しい標準です。

このMCPサーバーを使用すると、以下のことができます。

✅ タグの管理 - タグの作成、削除、連絡先への割り当て ✅ リストの編集 - リストの作成、連絡先の追加/削除 ✅ キャンペーンの作成 - ユーザーセグメントにメールを送信 ✅ オートメーション - ファネル（オートメーション）の管理 ✅ ウェブフック - FluentCRMへのウェブフックの設定 ✅ レポート - 統計情報とメトリクスの取得 ✅ スマートリンク - （APIが利用可能になった場合）スマートリンクの管理

すべてをCursorから直接、Claudeとの会話の中で行うことができます！

---

必要条件

• ✅ Node.js 18以上
• ✅ npmまたはyarn
• ✅ FluentCRM APIへのアクセス（WordPressドメイン）
• ✅ MCPをサポートするCursor
• ✅ FluentCRMからのAPIキー（設定 → REST APIで生成）

---

インストール

ステップ1: リポジトリをクローンするか、ファイルをコピーする

cd /path/to/your/fluentcrm-mcp-server

ステップ2: 依存関係をインストールする

npm install

ステップ3: TypeScriptをビルドする

npm run build

以下のように表示されるはずです。

✅ dist/fluentcrm-mcp-server.js (コンパイル済み)

ステップ4: 接続をテストする

export FLUENTCRM_API_USERNAME="your_username"
export FLUENTCRM_API_PASSWORD="your_password"
npm start

以下のように表示されるはずです。

🚀 FluentCRM MCP Serverがstdioで実行中
📡 API URL: https://your-domain.com/wp-json/fluent-crm/v2
👤 ユーザー名: your_username

CTRL+Cを押して停止します。

---

設定

1. FluentCRMからAPI資格情報を取得する

手順は以下の通りです。

1. WordPressにログインします: https://your-domain.com/wp-admin
2. FluentCRM → 設定 → マネージャーに移動します。
3. 新しいマネージャーを追加をクリックします。
4. 以下を入力します。
   • 名前: MCP Server（または他の名前）
   • 役割: サブスクライバー（十分です）
   • 権限: すべてのFluentCRM権限にチェックを入れます。
5. マネージャーを保存をクリックします。
6. FluentCRM → 設定 → REST APIに移動します。
7. 新しいキーを作成をクリックします。
8. 先ほど作成したマネージャーを選択します。
9. 確認をクリックします。
10. 以下をコピーします。
    • ユーザー名 (API_USERNAME)
    • アプリケーションパスワード (API_PASSWORD)

2. 環境変数を設定する

オプションA: .envファイルを編集する

# .env
FLUENTCRM_API_USERNAME=your_api_username
FLUENTCRM_API_PASSWORD=your_api_password
FLUENTCRM_API_URL=https://your-domain.com/wp-json/fluent-crm/v2

オプションB: ターミナルからエクスポートする

export FLUENTCRM_API_USERNAME="your_api_username"
export FLUENTCRM_API_PASSWORD="your_api_password"

3. Cursorの設定（MCP）

1. Cursorを開きます。
2. Cmd+Shift+P（macOS）またはCtrl+Shift+P（Windows/Linux）を押します。
3. "MCP設定" または "Preferences: Open MCP Settings" を検索します。
4. 設定ファイルを編集します。

{
  "mcpServers": {
    "fluentcrm": {
      "command": "node",
      "args": [
        "/path/to/your/fluentcrm-mcp-server/dist/fluentcrm-mcp-server.js"
      ],
      "env": {
        "FLUENTCRM_API_USERNAME": "your_api_username",
        "FLUENTCRM_API_PASSWORD": "your_api_password",
        "FLUENTCRM_API_URL": "https://your-domain.com/wp-json/fluent-crm/v2"
      }
    }
  }
}

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

---

使用方法

設定が完了したら、Cursorでチャットを開き、質問を始めましょう！

簡単な質問の例:

Show me all tags in FluentCRM

Claudeは自動的にMCPサーバーを使用し、タグのリストを返します。

---

利用可能なツール

👤 連絡先（サブスクライバー）

• fluentcrm_list_contacts - 連絡先のリストを取得する
• fluentcrm_get_contact - 連絡先の詳細を取得する
• fluentcrm_find_contact_by_email - メールアドレスで検索する
• fluentcrm_create_contact - 新しい連絡先を作成する
• fluentcrm_update_contact - 連絡先を更新する
• fluentcrm_delete_contact - 連絡先を削除する

🏷️ タグ

• fluentcrm_list_tags - すべてのタグを取得する
• fluentcrm_create_tag - 新しいタグを作成する
• fluentcrm_delete_tag - タグを削除する
• fluentcrm_attach_tag_to_contact - タグを連絡先に割り当てる
• fluentcrm_detach_tag_from_contact - タグを連絡先から削除する

📋 リスト

• fluentcrm_list_lists - すべてのリストを取得する
• fluentcrm_create_list - 新しいリストを作成する
• fluentcrm_delete_list - リストを削除する
• fluentcrm_attach_contact_to_list - 連絡先をリストに追加する
• fluentcrm_detach_contact_from_list - 連絡先をリストから削除する

📧 キャンペーン

• fluentcrm_list_campaigns - キャンペーンを取得する
• fluentcrm_create_campaign - キャンペーンを作成する
• fluentcrm_pause_campaign - キャンペーンを一時停止する
• fluentcrm_resume_campaign - キャンペーンを再開する
• fluentcrm_delete_campaign - キャンペーンを削除する

📨 メールテンプレート

• fluentcrm_list_email_templates - テンプレートを取得する
• fluentcrm_create_email_template - テンプレートを作成する

🤖 オートメーション

• fluentcrm_list_automations - オートメーション（ファネル）を取得する
• fluentcrm_create_automation - オートメーションを作成する

🔗 ウェブフック

• fluentcrm_list_webhooks - ウェブフックを取得する
• fluentcrm_create_webhook - ウェブフックを作成する

📊 レポート

• fluentcrm_dashboard_stats - ダッシュボードの統計情報
• fluentcrm_custom_fields - カスタムフィールド

---

使用例

例1: すべてのタグを表示する

Cursor内で:

Show me all tags in FluentCRM

Claudeは以下を返します:

✅ FluentCRMからタグを取得中...

次のタグが見つかりました:
1. registered (ID: 1)
2. webinar-jit (ID: 2)
3. progress-75 (ID: 3)
4. participated (ID: 4)
... 他に47個

例2: 新しいタグを作成する

Cursor内で:

Create tag "hot-lead" with description "People who watched 75%+ and are interested"

Claudeは自動的に:

1. fluentcrm_create_tagツールを使用します。
2. 確認メッセージを返します。

例3: タグを連絡先に割り当てる

Cursor内で:

Assign tag "progress-75" to contact with email "jan@example.com"

Claudeは:

1. メールアドレスで連絡先を検索します。
2. タグを割り当てます。
3. 確認メッセージを返します。

例4: リストを作成する

Cursor内で:

Create new list "Hot-leads" with description "Participants who watched 75%+ of webinar"

Claudeがリストを作成します

例5: 連絡先をリストに追加する

Cursor内で:

Add all contacts with tag "progress-75" to list "Hot-leads"

---

トラブルシューティング

❌ エラー: "Authorization failed"

原因: APIユーザー名またはパスワードが間違っています。

解決策:

1. FluentCRM → 設定 → REST APIに移動します。
2. APIキーがアクティブであることを確認します。
3. 資格情報を再度コピーします。
4. .envファイルを更新します。

❌ エラー: "Connection refused"

原因: FluentCRM APIが利用できません。

解決策:

1. WordPressドメインがアクセス可能であることを確認します。
2. ping your-domain.comでpingを実行します。
3. WordPressが実行中であることを確認します。

❌ MCPサーバーが起動しません

原因: 依存関係が不足しています。

解決策:

npm install
npm run build

❌ CursorがMCPサーバーを認識できません

原因: ファイルパスが間違っているか、API資格情報が不足しています。

解決策:

1. MCP設定（~/.cursor/settings.json）内のパスを確認します。
2. dist/fluentcrm-mcp-server.jsファイルが存在することを確認します。
3. Cursorを再起動します。
4. ログを確認します: cat ~/.cursor/logs.txt

---

APIリファレンス

FluentCRM APIドキュメント: https://rest-api.fluentcrm.com/#introduction

---

セキュリティ

⚠️ 重要な注意事項

• ❌ 実際の資格情報を含む.envファイルを決してgitにコミットしないでください。
• ❌ APIキーを公開しないでください。
• ✅ ハードコーディングの代わりに環境変数を使用してください。
• ✅ APIキーを定期的に更新してください。

---

更新

MCPサーバーを更新するには、以下の手順を実行します。

cd fluentcrm-mcp-server
git pull  # または最新バージョンを手動でダウンロードする
npm install
npm run build

Cursorを再起動します。

---

サポート

問題が発生した場合は、以下の手順を試してください。

1. トラブルシューティングセクションを確認します。
2. FluentCRMのログを確認します: FluentCRM → ログ
3. Cursorのログを確認します: ~/.cursor/logs.txt
4. サポートに問い合わせます。

---

ライセンス

MIT

---

作者

Miłosz Zając
🌐 www.netfly.pl

日付: 2025-01-20
バージョン: 1.0.0

---

Miłosz Zającによって❤️で作られました