LINE Issue MCP

Ein System zum Empfangen von Kundenproblemen über LINE-Official-Accounts/Gruppen. Es führt eine KI-Triage der Nachrichten durch, prüft letzte Commits sowie die zugehörigen Routen/Pfade in GitLab und erstellt automatisch eine ClickUp-Aufgabe in der Liste Client Issues.

Ablauf

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

Klassifizierung: Bug, Feature Request, Q&A
Priorität: Low, Medium, High, Critical

Related MCP server: Kepler MCP GitLab Server

Erste Schritte

Erforderlich ist Node.js 20 oder höher.

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

Richte mindestens Folgendes in .env ein:

• LINE_CHANNEL_SECRET: von LINE Developers > Messaging-API-Kanal

• OPENAI_API_KEY: API-Schlüssel für die Responses API

• GITLAB_TOKEN: Token mit Lesezugriff auf das Repository

• GITLAB_PROJECT: namespace/project

• CLICKUP_API_TOKEN: persönliches Token oder OAuth-Token

• CLICKUP_LIST_ID: ID der Liste Client Issues (empfohlene Methode)

Falls CLICKUP_LIST_ID nicht gesetzt wird, ist CLICKUP_TEAM_ID zu setzen; das System sucht dann in jedem Space/Ordner des Workspace nach der Liste, deren Name mit CLICKUP_LIST_NAME=Client Issues übereinstimmt.

Setze die LINE-Webhook-URL auf eine öffentliche HTTPS-URL:

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

Der Health-Check ist unter GET /health erreichbar.

MCP-Tools

MCP-Server über stdio ausführen:

npm run mcp

Es gibt zwei Tools:

• analyze_client_issue: analysiert und ruft GitLab-Kontext ab, erstellt aber noch keine Aufgabe

• create_client_issue: führt den vollständigen Ablauf aus und erstellt die ClickUp-Aufgabe

Beispielkonfiguration für den MCP-Client:

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

Wichtige Verhaltensweisen

• x-line-signature aus dem rohen Request-Body prüfen, bevor das Event angenommen wird

• Sofort auf den LINE-Webhook antworten und dann im Hintergrund verarbeiten

• webhookEventId verwenden, um doppelte Events innerhalb desselben Prozesses zu verhindern

• Ein GitLab-Fehler verhindert das Erstellen der ClickUp-Aufgabe nicht; die Aufgabe enthält stattdessen eine Warnung

• Für Q&A wird standardmäßig eine Aufgabe erstellt; deaktivierbar mit CREATE_QA_TASKS=false

• OpenAI-Anfragen verwenden Structured Outputs und store: false

Vor der Produktion

Dieser MVP speichert die Event-Deduplizierung im Arbeitsspeicher und eignet sich für eine einzelne Instanz. Für die Produktion sollten eine dauerhafte Warteschlange, ein Idempotenzspeicher (z. B. Redis/Postgres), eine Retry-/Dead-Letter-Queue, ein Secret-Manager, Observability und eine Allowlist für Repository/ClickUp-Workspace hinzugefügt werden.