LINE Issue MCP

ระบบรับปัญหาลูกค้าจาก LINE Official Account/Group แล้วใช้ AI triage ข้อความ ตรวจ recent commits และ route/path ที่เกี่ยวข้องใน GitLab ก่อนสร้าง ClickUp task ใน List Client Issues อัตโนมัติ

Flow

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

Classification: Bug, Feature Request, Q&A
Priority: Low, Medium, High, Critical

เริ่มใช้งาน

ต้องใช้ Node.js 20 ขึ้นไป

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

ตั้งค่า .env อย่างน้อย:

• LINE_CHANNEL_SECRET: จาก LINE Developers > Messaging API channel
• OPENAI_API_KEY: API key สำหรับ Responses API
• GITLAB_TOKEN: token ที่มีสิทธิ์อ่าน repository
• GITLAB_PROJECT: namespace/project
• CLICKUP_API_TOKEN: personal token หรือ OAuth token
• CLICKUP_LIST_ID: ID ของ List Client Issues (วิธีที่แนะนำ)

ถ้าไม่กำหนด CLICKUP_LIST_ID ให้กำหนด CLICKUP_TEAM_ID; ระบบจะค้นหา List ที่ชื่อตรงกับ CLICKUP_LIST_NAME=Client Issues ในทุก Space/Folder ของ Workspace

ตั้ง LINE webhook URL เป็น public HTTPS URL:

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

Health check อยู่ที่ GET /health

MCP tools

รัน MCP server ผ่าน stdio:

npm run mcp

มี 2 tools:

• analyze_client_issue: วิเคราะห์และค้น GitLab context แต่ยังไม่สร้าง task
• create_client_issue: ทำครบ flow และสร้าง ClickUp task

ตัวอย่าง config ของ MCP client:

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

พฤติกรรมสำคัญ

• ตรวจ x-line-signature จาก raw request body ก่อนรับ event
• ตอบ LINE webhook ทันที แล้วประมวลผลเบื้องหลัง
• ใช้ webhookEventId ป้องกัน event ซ้ำใน process เดียว
• GitLab ล้มเหลวไม่ขวางการสร้าง ClickUp task; task จะระบุ warning แทน
• Q&A จะสร้าง task โดยค่าเริ่มต้น ปิดได้ด้วย CREATE_QA_TASKS=false
• OpenAI request ใช้ Structured Outputs และ store: false

ก่อนขึ้น production

MVP นี้เก็บ event deduplication ใน memory เหมาะกับ instance เดียว สำหรับ production ควรเพิ่ม durable queue และ idempotency store (เช่น Redis/Postgres), retry/dead-letter queue, secret manager, observability และ allowlist repository/ClickUp workspace