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
.envfile 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.jsonmatches 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 environmentlist_funnels- Lists all funnels from your ClickFunnels accountget_funnel- Gets a specific funnel by IDlist_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