ClickFunnels MCP 框架

这是一个用于将 ClickFunnels 与 Claude Desktop 集成的 Model Context Protocol (MCP) 服务器。

设置说明

1. 克隆此仓库： bash git clone https://github.com/illGATESmusic/click-funnels-mcp-shared.git cd click-funnels-mcp-shared

2. 安装依赖项： bash npm install

3. 使用您的 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

1. 构建项目： bash npm run build

2. 更新您的 Claude Desktop 配置：

编辑您的 Claude Desktop 配置文件（在 Mac 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json 或者根据您的操作系统找到相应位置），以包含此服务器：

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

1. 重启 Claude Desktop 以应用更改。

故障排除

如果您遇到任何问题，请检查日志：

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

常见问题：

1. "No such file or directory" 错误：

   • 确保所有必需的目录存在（logs, tools, prompts, resources）
   • 确保 claude_desktop_config.json 中的路径与您的服务器绝对路径匹配
   • 配置中的 "cwd" 字段对于正确的路径解析至关重要

2. 服务器立即断开连接：

   • 检查配置中使用的服务器名称是否正确
   • 确认所有环境变量已正确设置
   • 确保日志目录存在且可写

3. API 连接错误：

   • 验证您的 ClickFunnels API 凭证是否正确
   • 检查是否达到了任何 API 速率限制

如果以上方法均无效，请运行 TROUBLESHOOTING.md 脚本来收集诊断信息。

可用工具

此 MCP 服务器提供以下工具：

• debug - 提供关于当前环境的调试信息
• list_funnels - 列出您 ClickFunnels 账户中的所有漏斗
• get_funnel - 通过 ID 获取特定漏斗
• list_contacts - 列出您 ClickFunnels 账户中的联系人

贡献

如果您遇到任何问题或有建议，请打开一个 issue 或提交 pull request。

许可证

MIT