MCP 服务器

ClickFunnels MCP Framework

一个模型上下文协议（Model Context Protocol）服务器，它将 ClickFunnels 与 Claude Desktop 集成，允许用户通过自然语言列出和检索来自其 ClickFunnels 账户的漏斗和联系人。

README

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 Desktop 配置：

编辑您的 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

常见问题：

“No such file or directory” 错误：
- 确保所有必需的目录都存在（logs、tools、prompts、resources）
- 确保 claude_desktop_config.json 中的路径与服务器的绝对路径匹配
- 配置中的 "cwd" 字段对于正确的路径解析至关重要
服务器立即断开连接：
- 检查您在配置中使用的服务器名称是否正确
- 验证所有环境变量是否已正确设置
- 确保日志目录存在且可写
API 连接错误：
- 验证您的 ClickFunnels API 凭据是否正确
- 检查您是否已达到任何 API 速率限制