ClickFunnels MCP 框架

这是一个用于将 ClickFunnels 与 Claude Desktop 集成的模型上下文协议 (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 桌面配置：

编辑您的 Claude Desktop 配置文件（位于 Mac 上的~/Library/Application Support/Claude/claude_desktop_config.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"
    }
  ]
}

重新启动 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 帐户中的联系人

贡献

如果您遇到任何问题或有建议，请打开问题或提交拉取请求。

执照

麻省理工学院