LINE Issue MCP

Система принимает обращения клиентов из LINE Official Account/Group и использует AI для триажа сообщений, проверяет последние коммиты и связанные route/path в GitLab, после чего автоматически создаёт задачу ClickUp в списке 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: API-ключ для Responses API

• GITLAB_TOKEN: токен с правом чтения репозитория

• GITLAB_PROJECT: namespace/project

• CLICKUP_API_TOKEN: персональный токен или OAuth-токен

• CLICKUP_LIST_ID: ID списка Client Issues (рекомендуется)

Если CLICKUP_LIST_ID не задан, укажите CLICKUP_TEAM_ID; тогда система найдёт List, имя которого совпадает с CLICKUP_LIST_NAME=Client Issues, во всех Space/Folder Workspace.

Задайте URL вебхука LINE как публичный HTTPS URL:

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

Health check доступен по адресу GET /health.

Инструменты MCP

Запустите MCP-сервер через stdio:

npm run mcp

Доступно 2 инструмента:

• analyze_client_issue: выполняет анализ и поиск контекста в GitLab, но не создаёт задачу

• create_client_issue: выполняет весь процесс и создаёт задачу ClickUp

Пример конфигурации MCP-клиента:

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

Важные особенности поведения

• Проверяйте x-line-signature по исходному телу запроса (raw body) перед принятием события.

• Сразу отвечайте на LINE webhook, а затем выполняйте обработку в фоне.

• Используйте webhookEventId, чтобы исключить повторную обработку события в рамках одного процесса.

• Сбой GitLab не блокирует создание задачи ClickUp; вместо этого в задаче появится предупреждение.

• Q&A по умолчанию создаёт задачу; это можно отключить через CREATE_QA_TASKS=false.

• Запросы к OpenAI используют Structured Outputs и store: false.

Перед запуском production

Данный MVP хранит дедупликацию событий в памяти и подходит для одного инстанса. Для production следует добавить durable queue и idempotency store (например, Redis/Postgres), retry/dead-letter queue, secret manager, observability и allowlist репозитория/workspace ClickUp.