LINE Issue MCP

Sistema que recibe las incidencias de los clientes desde LINE Official Account/Group, realiza un triaje con IA de los mensajes, revisa los commits recientes y las rutas asociadas (route/path) en GitLab antes de crear automáticamente una tarea de ClickUp en la lista Client Issues.

Flujo

LINE OA / Group
      │ webhook + signature
      ▼
HTTP /webhooks/line
      │
      ▼
OpenAI Responses API
  classify + priority + summarize + search terms
      │
      ▼
GitLab recent commits + commit diffs
  rank related commits + paths + routes
      │
      ▼
ClickUp / Client Issues
  task + tag + priority + GitLab evidence

Clasificación: Bug, Feature Request, Q&A
Prioridad: Low, Medium, High, Critical

Related MCP server: Kepler MCP GitLab Server

Cómo empezar

Se requiere Node.js 20 o superior.

Clave y variables de entorno

npm install
copy .env.example .env
npm run dev

Configura el archivo .env como mínimo:

• LINE_CHANNEL_SECRET: obtenido de LINE Developers > Messaging API channel

• OPENAI_API_KEY: clave de API para Responses API

• GITLAB_TOKEN: token con permiso de lectura del repositorio

• GITLAB_PROJECT: namespace/project

• CLICKUP_API_TOKEN: token personal o token OAuth

• CLICKUP_LIST_ID: ID de la lista Client Issues (método recomendado)

Si no se define CLICKUP_LIST_ID, define CLICKUP_TEAM_ID; el sistema buscará la lista cuyo nombre coincida con CLICKUP_LIST_NAME=Client Issues en todos los espacios/carpetas del Workspace.

Configura la URL del webhook de LINE como una URL HTTPS pública:

https://your-domain.example/webhooks/line

La comprobación de estado está en GET /health.

Herramientas MCP

Ejecuta el servidor MCP a través de stdio:

npm run mcp

Hay 2 herramientas (tools):

• analyze_client_issue: analiza y busca el contexto en GitLab, pero no crea la tarea.

• create_client_issue: completa todo el flujo y crea la tarea de ClickUp.

Ejemplo de configuración del cliente MCP:

{
  "mcpServers": {
    "line-issue": {
      "command": "npm",
      "args": ["run", "mcp"],
      "cwd": "C:/absolute/path/to/line-issue-mcp"
    }
  }
}

Comportamientos clave

• Verifica x-line-signature en el cuerpo de la solicitud (raw request body) antes de aceptar el evento.

• Responde al webhook de LINE inmediatamente y procesa en segundo plano.

• Usa webhookEventId para evitar eventos duplicados en el mismo proceso.

• Un fallo de GitLab no bloquea la creación de la tarea de ClickUp; la tarea mostrará una advertencia en su lugar.

• Las Q&A crearán una tarea por defecto; se puede desactivar con CREATE_QA_TASKS=false.

• La solicitud a OpenAI usa Structured Outputs y store: false.

Antes de la producción

Este MVP guarda la deduplicación de eventos en memoria, por lo que es adecuado para una sola instancia. Para producción, se recomienda añadir una cola persistente y un almacén de idempotencia (p. ej., Redis/Postgres), colas de reintento y de mensajes fallidos (dead-letter queue), un gestor de secretos, observabilidad y una lista de permitidos del repositorio/espacio de trabajo de ClickUp.