ClickFunnels MCP 프레임워크

이는 ClickFunnels를 Claude Desktop과 통합하기 위한 MCP(Model Context Protocol) 서버입니다.

설치 지침

이 저장소를 복제하세요:

지엑스피1

종속성 설치:

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 구성을 업데이트하세요.

Mac에서는 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있고, OS에 맞는 적절한 위치에 있는 Claude Desktop 구성 파일을 편집하여 이 서버를 포함하세요.

{
  "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 계정의 연락처를 나열합니다.

기여하다

문제가 발생하거나 제안 사항이 있는 경우, 이슈를 개설하거나 풀 리퀘스트를 제출해 주세요.

특허

MIT