Servidor MCP de ClickUp

Una implementación de servidor de protocolo de contexto de modelo para la integración de ClickUp, que permite que los asistentes de IA interactúen con los espacios de trabajo de ClickUp.

Inicio rápido

1. Configurar Claude para escritorio:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["@mcp/clickup-server"],
      "env": {
        "CLICKUP_CLIENT_ID": "your_client_id",
        "CLICKUP_CLIENT_SECRET": "your_client_secret",
        "CLICKUP_REDIRECT_URI": "http://localhost:3000/oauth/callback"
      }
    }
  }
}

2. Reiniciar Claude para escritorio

¡Listo! El servidor se descargará e iniciará automáticamente cuando sea necesario.

Instalación mediante herrería

Para instalar ClickUp MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude

Related MCP server: ClickUp MCP Sedrver

Variables de entorno

Variables de entorno requeridas:

• CLICKUP_CLIENT_ID : Su ID de cliente OAuth de ClickUp

• CLICKUP_CLIENT_SECRET : Su secreto de cliente OAuth de ClickUp

• CLICKUP_REDIRECT_URI : URI de redirección de OAuth (predeterminado: http://localhost:3000/oauth/callback )

Variables de entorno opcionales:

• PORT : Puerto del servidor (predeterminado: 3000)

• LOG_LEVEL : Nivel de registro (predeterminado: información)

Herramientas disponibles

Gestión de tareas

• clickup_create_task : Crea una nueva tarea en una lista de ClickUp

• clickup_update_task : Actualizar las propiedades de una tarea existente

Gestión de equipos y listas

• clickup_get_teams : Recuperar todos los equipos accesibles

• clickup_get_lists : Obtener todas las listas en una carpeta específica

Junta Directiva

• clickup_create_board : Crea un nuevo tablero en un espacio ClickUp

Desarrollo

1. Clonar el repositorio

2. Instalar dependencias:

npm install

3. Iniciar en modo de desarrollo:

npm run dev

4. Construir para producción:

npm run build

5. Ejecutar pruebas:

npm test

Seguridad

• Todos los tokens están encriptados en reposo

• Flujo OAuth2 para autenticación segura

• No se registran datos confidenciales

• Limitación de velocidad para evitar el abuso de la API

Solución de problemas

Problemas comunes

1. Errores de autenticación

   • Verifique sus credenciales de OAuth en las variables de entorno

   • Comprobar la caducidad del token

   • Asegúrese de que la URL de redirección sea correcta

2. Limitación de velocidad

   • El servidor implementa el manejo automático del límite de velocidad

   • Consulte los registros para ver las advertencias sobre el límite de velocidad

   • Considere implementar la agrupación de solicitudes

3. El servidor no se inicia

   • Compruebe que las variables de entorno estén configuradas correctamente

   • Verificar que el puerto 3000 esté disponible

   • Consulta los registros de Claude para el escritorio

Obteniendo registros

Los registros de Claude for Desktop se pueden encontrar en:

• Windows: %USERPROFILE%\AppData\Local\Claude\Logs\mcp*.log

• macOS: ~/Library/Logs/Claude/mcp*.log

Licencia

Licencia MIT: consulte el archivo de LICENCIA para obtener más detalles