convez.ai
MCP ServerIntegração & APIsIntermediário
UNTAG-LAB

LiteJira MCP

UNTAG-LAB/litejira-mcp

Integre LiteJira com IA para gerenciar tickets automaticamente

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite a assistentes de IA (Claude, Cursor, ChatGPT Desktop) ler e escrever diretamente no sistema de tickets LiteJira. Funciona como um wrapper de cliente puro que se comunica com a API do LiteJira, mantendo tokens de acesso localmente no seu computador.

Instalação

$npx convez-ai UNTAG-LAB/litejira-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
50%
Último commit
há 1 mês
Versão
v3.7.0
Issues abertas
5
Contribuidores
1

Casos de uso

  • Criar e atualizar tickets via comandos de linguagem natural
  • Buscar e filtrar tickets com IA como intermediária
  • Reatribuir e alterar status de tickets automaticamente
  • Adicionar comentários em tickets diretamente do assistente de IA

Veredito

MCP bem estruturado para integração com LiteJira, focado em produtividade técnica. Instalação simples, segurança respeitável (tokens locais) e suporte a múltiplos ambientes. Recomendado para equipes que já usam LiteJira e querem automatizar workflows com IA.

README

A tradução para o português deste README ainda está na fila.

litejira-mcp

讓你的 AI 助手(Claude Code / Cursor / ChatGPT Desktop)直接讀寫 LiteJira 工單系統。

這是一個 MCP server(純客戶端包裝)。它只負責「怎麼跟 LiteJira API 對話」,不含任何工單資料、後端邏輯或祕密——就像 chrome-devtools-mcp 不含 Chrome 的原始碼。你的存取權杖只存在你自己電腦上。


安裝(一句指令)

前提:Node.js 18 以上。

推薦:全域安裝(更新最穩,避開 npx 快取與多開 session 兩個已知坑)

npm install -g litejira-mcp
claude mcp add litejira --scope user -- litejira-mcp

快速:用 npx(免全域安裝,但多開 session 偶爾連不上、更新需清快取)

claude mcp add litejira --scope user -- npx -y litejira-mcp@latest

裝完設定一次權杖(見下),重啟 AI 工具即可用。


更新(一句指令)

全域安裝者:

npm update -g litejira-mcp

然後完全關閉並重新打開你的 AI 工具。沒有手動拉檔、不用清快取。

npx 安裝者:npx 會快取舊版,重啟未必更新到最新;要更新請跑 npx --cache-clear 後重啟,或改用上面的全域安裝。


設定權杖(一次性)

  1. 找 admin 在 LiteJira webapp「設定 → Token」幫你建一把 PAT(ltj_pat_xxxxx),順便要 LTJ_API_URL。
  2. 在你電腦的家目錄建檔 ~/.litejira/credentials.env:

Mac / Linux

mkdir -p ~/.litejira
cat > ~/.litejira/credentials.env << 'EOF'
LTJ_API_URL=<向 admin 索取>
LTJ_API_TOKEN=<貼你的 ltj_pat_ 權杖>
LTJ_MCP_ENABLE_WRITES=true
EOF

Windows(PowerShell)

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.litejira"
@"
LTJ_API_URL=<向 admin 索取>
LTJ_API_TOKEN=<貼你的 ltj_pat_ 權杖>
LTJ_MCP_ENABLE_WRITES=true
"@ | Set-Content "$env:USERPROFILE\.litejira\credentials.env"

權杖只存在你電腦上、不進 git。離職或不用了,找 admin 在 webapp 撤銷。


測試

跟 AI 說:「用 LiteJira 搜尋最新的 BUG」。看到工單列表 = 成功。

進階:dev / prod 雙環境(維護者用)

一般使用者忽略本段。若你要同時連正式與測試兩套 LiteJira,啟動器接受一個環境參數:

指令讀哪個 credentials
litejira-mcp~/.litejira/credentials.env(預設)
litejira-mcp dev~/.litejira/credentials.dev.txt(找不到再試 .dev.env)
litejira-mcp prod~/.litejira/credentials.prod.txt(找不到再試 .prod.env)

.mcp.json 範例(兩條並存):

"litejira":     { "command": "litejira-mcp", "args": ["prod"] },
"litejira-dev": { "command": "litejira-mcp", "args": ["dev"] }

能做什麼

你說AI 會做
「建一張 P1 BUG 給思源」建立新工單
「搜尋 login 相關的工單」搜尋篩選
「查 BUG-530 完整內容」讀工單詳情
「在 BUG-530 留言說已修好」發留言
「把 BUG-530 轉派給 Howard」轉派(帶通知)
「把 BUG-530 狀態改成自測中」改狀態(依工作流自動轉派)

AI 會自動載入成員清單、版本列表、工作流規則。


故障排除

症狀解法
AI 說找不到 litejira 工具重啟 AI 工具;確認 claude mcp add 跑成功
AUTH_FAILED確認 ~/.litejira/credentials.env 的權杖沒打錯
WRITES_DISABLEDcredentials.env 加 LTJ_MCP_ENABLE_WRITES=true
啟動拋 HTTP 401 + HTML(不是 JSON)server 端 API 部署存取設定漂移,不是你的問題 → 找 admin
多開 session 時連不上改用全域安裝(npm i -g),不要用 npx

零外部相依,只需 Node.js 18+。

License

MIT

Ver o original no GitHub

Bom para

Relacionados