ClickFunnels MCP Framework

This is a Model Context Protocol (MCP) server for integrating ClickFunnels with Claude Desktop.

Setup Instructions

Clone this repository:

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

Install dependencies:

npm install

Update the .env file with your ClickFunnels API credentials:

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

Build the project:

npm run build

Update your Claude Desktop config:

Edit your Claude Desktop config file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on Mac or appropriate location for your OS) to include this server:

{
  "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"
    }
  ]
}

Restart Claude Desktop to apply the changes.

Troubleshooting

If you encounter any issues, check the logs at:

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

Common issues:

"No such file or directory" error:
- Make sure all required directories exist (logs, tools, prompts, resources)
- Ensure the path in claude_desktop_config.json matches the absolute path to your server
- The "cwd" field in the configuration is critical for proper path resolution
Server disconnects immediately:
- Check that you're using the correct server name in the configuration
- Verify all environment variables are correctly set
- Make sure logs directory exists and is writable
API connection errors:
- Verify your ClickFunnels API credentials are correct
- Check if you've reached any API rate limits

If all else fails, run the TROUBLESHOOTING.md script to collect diagnostic information.

Available Tools

This MCP server provides the following tools:

debug - Provides debugging information about the current environment
list_funnels - Lists all funnels from your ClickFunnels account
get_funnel - Gets a specific funnel by ID
list_contacts - Lists contacts from your ClickFunnels account

Contributing

If you encounter any issues or have suggestions, please open an issue or submit a pull request.

License

MIT