ClickFunnels MCPフレームワーク

これは、ClickFunnels と Claude Desktop を統合するための Model Context Protocol (MCP) サーバーです。

セットアップ手順

このリポジトリをクローンします:

git clone https://github.com/illGATESmusic/click-funnels-mcp-shared.git
cd click-funnels-mcp-shared

依存関係をインストールします:

npm install

ClickFunnels API 資格情報を使用して.envファイルを更新します。

PORT=3002
CLICKFUNNELS_API_BASE=https://your-domain.myclickfunnels.com/api/v2
CLICKFUNNELS_WORKSPACE_ID=123456
CLICKFUNNELS_API_TOKEN=YOUR_API_TOKEN_HERE
CLICKFUNNELS_WORKSPACE_SUBDOMAIN=your-subdomain
NODE_ENV=production

プロジェクトをビルドします。

npm run build

Claude Desktop の設定を更新します。

Claude Desktop 構成ファイル (Mac の場合は~/Library/Application Support/Claude/claude_desktop_config.json 、OS の場合は適切な場所) を編集して、次のサーバーを追加します。

{
  "mcpServers": {
    "clickfunnels-mcp-framework": {
      "command": "node",
      "args": ["/absolute/path/to/click-funnels-mcp-shared/dist/index.js"],
      "env": {
        "PORT": "3002",
        "CLICKFUNNELS_API_BASE": "https://your-domain.myclickfunnels.com/api/v2",
        "CLICKFUNNELS_WORKSPACE_ID": "123456",
        "CLICKFUNNELS_API_TOKEN": "YOUR_API_TOKEN_HERE",
        "CLICKFUNNELS_WORKSPACE_SUBDOMAIN": "your-subdomain",
        "NODE_ENV": "production",
        "MCP_LOG_LEVEL": "debug",
        "MCP_LOG_TO_CONSOLE": "true",
        "MCP_LOG_TO_FILE": "true",
        "MCP_LOG_DIR": "/absolute/path/to/click-funnels-mcp-shared/logs",
        "NODE_OPTIONS": "--max-old-space-size=256"
      },
      "cwd": "/absolute/path/to/click-funnels-mcp-shared"
    }
  },
  "mcpServerConnections": [
    {
      "url": "http://localhost:3002/sse"
    }
  ]
}

変更を適用するには、Claude Desktop を再起動します。

トラブルシューティング

問題が発生した場合は、次のログを確認してください。

/Users/username/Library/Logs/Claude/mcp-server-clickfunnels-mcp-framework.log

よくある問題:

「そのようなファイルまたはディレクトリはありません」というエラー:
- 必要なディレクトリ（ログ、ツール、プロンプト、リソース）がすべて存在することを確認します。
- claude_desktop_config.jsonのパスがサーバーの絶対パスと一致していることを確認します。
- 設定の「cwd」フィールドは適切なパス解決に重要です。
サーバーは直ちに切断されます:
- 設定で正しいサーバー名を使用していることを確認してください
- すべての環境変数が正しく設定されていることを確認する
- ログディレクトリが存在し、書き込み可能であることを確認してください
API 接続エラー:
- ClickFunnels APIの認証情報が正しいことを確認してください
- APIレート制限に達していないか確認する

それでも問題が解決しない場合は、 TROUBLESHOOTING.mdスクリプトを実行して診断情報を収集します。

利用可能なツール

この MCP サーバーは次のツールを提供します。

debug - 現在の環境に関するデバッグ情報を提供します
list_funnels - ClickFunnelsアカウントのすべてのファネルを一覧表示します
get_funnel - IDで特定のファネルを取得する
list_contacts - ClickFunnelsアカウントの連絡先をリストします

貢献

問題が発生した場合や提案がある場合は、問題を開くか、プルリクエストを送信してください。

ライセンス

マサチューセッツ工科大学