ClickUp MCP Server

Servidor MCP de ClickUp con Supergateway

Esta integración ejecuta el servidor MCP de ClickUp a través de Supergateway, exponiéndolo como un punto final SSE que puede ser utilizado por nodos n8n u otros clientes.

Prerrequisitos

• Node.js 18 o superior
• Docker y Docker Compose (para implementación en contenedores)
• Clave API de ClickUp e ID de equipo

Desarrollo local

Ejecutando con Node.js

1. Instalar dependencias:
   npm install -g supergateway @taazkareem/clickup-mcp-server
2. Establecer variables de entorno:
   export CLICKUP_API_KEY=pk_94547006_D8DFEXXFDOX7RUOJBBPLM2BSVRFXPZE9 export CLICKUP_TEAM_ID=2357720
3. Ejecute el script de integración:
   ./run-clickup-mcp.sh
4. Personalizar configuración (opcional):
   ./run-clickup-mcp.sh --port 9000 --base-url http://example.com --cors "http://localhost:8080,http://localhost:3000"

Ejecutar con Docker Compose

1. Cree un archivo .env basado en .env.example :
   cp .env.example .env
2. Edite el archivo .env con su clave API de ClickUp y el ID del equipo.
3. Iniciar el contenedor:
   docker-compose up -d
4. Ver registros:
   docker-compose logs -f

Despliegue en el ferrocarril

1. Crea un nuevo proyecto en Ferrocarril.
2. Conecte su repositorio de GitHub o use la CLI de Railway para implementar.
3. Establezca las siguientes variables de entorno en Railway:
   • CLICKUP_API_KEY : Su clave API de ClickUp
   • CLICKUP_TEAM_ID : Su ID de equipo de ClickUp
   • PORT : 8000 (o su puerto preferido)
   • BASE_URL : la URL de su aplicación ferroviaria (por ejemplo, https://your-app-name.up.railway.app )
   • SSE_PATH : /sse (o su ruta preferida)
   • MESSAGE_PATH : /mensaje (o su ruta preferida)
   • LOG_LEVEL : información (o depuración para un registro más detallado)
   • DOCUMENT_SUPPORT : falso (o verdadero si es necesario)
   • CORS_ORIGINS : * (o una lista separada por comas de orígenes permitidos)
4. Implementar la aplicación.

Uso con n8n

1. En n8n, agregue un nuevo nodo "MCP".
2. Configure el nodo con las siguientes configuraciones:
   • URL del servidor: la URL de su aplicación ferroviaria + ruta SSE (por ejemplo, https://your-app-name.up.railway.app/sse )
   • Ruta del mensaje: su ruta del mensaje (por ejemplo, /mensaje)
3. Seleccione la herramienta ClickUp deseada de las herramientas disponibles.
4. Configure los parámetros de la herramienta según sea necesario.
5. Conecte el nodo a su flujo de trabajo.

Puntos finales de API

• Punto final de SSE : {BASE_URL}{SSE_PATH} (por ejemplo, http://localhost:8000/sse )
  • Método: GET
  • Descripción: Suscribirse a eventos enviados por el servidor
• Punto final del mensaje : {BASE_URL}{MESSAGE_PATH} (por ejemplo, http://localhost:8000/message )
  • Método: POST
  • Descripción: Envía mensajes al servidor
  • Tipo de contenido: aplicación/json
  • Cuerpo: mensaje con formato JSON-RPC 2.0
• Punto final de comprobación de estado : {BASE_URL}/healthz (por ejemplo, http://localhost:8000/healthz )
  • Método: GET
  • Descripción: Comprueba si el servicio se está ejecutando correctamente
  • Respuesta: "ok" si el servicio está en buen estado

Solución de problemas

• Problemas de conexión : asegúrese de que su firewall permita conexiones al puerto especificado.
• Errores de autenticación : verifique que su clave API de ClickUp y el ID del equipo sean correctos.
• Errores de CORS : configure la variable de entorno CORS_ORIGINS para incluir el origen de su cliente.