ClickFunnels MCP 프레임워크
이는 ClickFunnels를 Claude Desktop과 통합하기 위한 MCP(Model Context Protocol) 서버입니다.
설치 지침
- 이 저장소를 복제하세요:
지엑스피1
- 종속성 설치:
- 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
- 프로젝트를 빌드하세요:
- 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