LINE Issue MCP

LINE Official Account/Group에서 고객 이슈를 수신하고, AI가 메시지를 triage(분류)한 다음 GitLab에서 최근 커밋과 관련 route/path를 확인한 뒤 ClickUp List Client Issues에 task를 자동으로 생성하는 시스템입니다.

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

분류: Bug, Feature Request, Q&A
우선순위: Low, Medium, High, Critical

Related MCP server: Kepler MCP GitLab Server

시작하기

Node.js 20 이상이 필요합니다.

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

.env를 최소한 다음과 같이 설정하세요:

• LINE_CHANNEL_SECRET: LINE Developers > Messaging API channel에서 획득

• OPENAI_API_KEY: Responses API용 API key

• GITLAB_TOKEN: repository를 읽을 권한이 있는 token

• GITLAB_PROJECT: namespace/project

• CLICKUP_API_TOKEN: personal token 또는 OAuth token

• CLICKUP_LIST_ID: List Client Issues의 ID (권장)

CLICKUP_LIST_ID를 지정하지 않으면 CLICKUP_TEAM_ID를 지정하세요. 그러면 시스템은 Workspace의 모든 Space/Folder에서 CLICKUP_LIST_NAME=Client 와 이름이 정확히 일치하는 List를 검색합니다.

LINE webhook URL을 공개 HTTPS URL로 설정하세요:

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

Health check는 GET /health에 있습니다.

MCP 도구

MCP server를 stdio로 실행합니다:

npm run mcp

도구가 2개 있습니다:

• analyze_client_issue: GitLab context를 분석하고 검색하지만 task는 생성하지 않습니다.

• create_client_issue: 전체 flow를 수행한 뒤 ClickUp task를 생성합니다.

MCP 클라이언트 설정 예시:

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

주요 동작

• 이벤트를 수락하기 전에 원본 요청 본문(raw request body)에서 x-line-signature를 검증합니다.

• LINE webhook에 즉시 응답한 다음 백그라운드에서 처리합니다.

• webhookEventId를 사용하여 단일 프로세스 내 중복 이벤트를 방지합니다.

• GitLab이 실패해도 ClickUp task 생성을 막지 않으며, 대신 해당 task에 warning을 표시합니다.

• 'Q&A' 는 기본적으로 task를 생성하며, CREATE_QA_TASKS=false로 비활성화할 수 있습니다.

• OpenAI 요청은 Structured Outputs와 store: false를 사용합니다.

코드 프로덕션 배포 전

이 MVP는 event deduplication을 메모리에 저장하므로 단일 인스턴스에 적합합니다. 프로덕션에서는 durable queue와 idempotency store(예: Redis/Postgres), retry/dead-letter queue, secret manager, observability, repository/ClickUp workspace allowlist를 추가해야 합니다.