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