LINE Issue MCP

LINE Official Account/Group から顧客の問題を受け取り、AI でメッセージをトリアージし、関連する recent commits とルート/パスを GitLab で調査したうえで、ClickUp の List Client Issues にタスクを自動作成します。

フロー

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 Issues と完全一致する名前の List を検索します。

LINE webhook URL には public な HTTPS URL を設定します:

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

ヘルスチェックは GET /health です。

MCP ツール

stdio 経由で MCP server を実行します:

npm run mcp

ツールは 2 つあります:

• analyze_client_issue: GitLab context を分析・調査しますが、task はまだ作成しません

• create_client_issue: フロー全体を実行して ClickUp task を作成します

MCP client の設定例:

{
  "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 はイベントの重複排除をメモリ内で保持するため、単一インスタンス向けです。本番環境では、durable queue と idempotency store（例: Redis/Postgres）、retry/dead-letter queue、secret manager、observability、および repository/ClickUp workspace の allowlist を追加してください。