Marco MCP de ClickFunnels

Este es un servidor de Protocolo de contexto de modelo (MCP) para integrar ClickFunnels con Claude Desktop.

Instrucciones de configuración

Clonar este repositorio:

git clone https://github.com/illGATESmusic/click-funnels-mcp-shared.git
cd click-funnels-mcp-shared

Instalar dependencias:

npm install

Actualice el archivo .env con sus credenciales de API de ClickFunnels:

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

Construir el proyecto:

npm run build

Actualice la configuración de Claude Desktop:

Edite el archivo de configuración de Claude Desktop (ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en Mac o en la ubicación adecuada para su sistema operativo) para incluir este servidor:

{
  "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"
    }
  ]
}

Reinicie Claude Desktop para aplicar los cambios.

Solución de problemas

Si encuentra algún problema, consulte los registros en:

/Users/username/Library/Logs/Claude/mcp-server-clickfunnels-mcp-framework.log

Problemas comunes:

Error "No existe el archivo o directorio":
- Asegúrese de que existan todos los directorios necesarios (registros, herramientas, indicaciones, recursos)
- Asegúrese de que la ruta en claude_desktop_config.json coincida con la ruta absoluta a su servidor
- El campo "cwd" en la configuración es fundamental para la correcta resolución de la ruta.
El servidor se desconecta inmediatamente:
- Comprueba que estás utilizando el nombre de servidor correcto en la configuración
- Verifique que todas las variables de entorno estén configuradas correctamente
- Asegúrese de que el directorio de registros exista y se pueda escribir en él
Errores de conexión API:
- Verifique que sus credenciales de API de ClickFunnels sean correctas
- Comprueba si has alcanzado algún límite de velocidad de API

Si todo lo demás falla, ejecute el script TROUBLESHOOTING.md para recopilar información de diagnóstico.

Herramientas disponibles

Este servidor MCP proporciona las siguientes herramientas:

debug : proporciona información de depuración sobre el entorno actual
list_funnels : enumera todos los embudos de su cuenta de ClickFunnels
get_funnel - Obtiene un embudo específico por ID
list_contacts : enumera los contactos de su cuenta de ClickFunnels

Contribuyendo

Si encuentra algún problema o tiene sugerencias, abra un problema o envíe una solicitud de extracción.

Licencia

Instituto Tecnológico de Massachusetts (MIT)