Jira senza browser
CLI potente e MCP server in C#/.NET 8 per interagire con Jira Cloud e Server/Data Center direttamente dal terminale — o tramite il tuo agente AI preferito.
$ jira context
{ "site": "myco", "url": "https://myco.atlassian.net" }
$ jira issue get PROJ-123
PROJ-123 Bug Open "Login non funziona" → mario.rossi
$ jira search --jql "project = PROJ AND status = Open"
12 issues found
$ jira mcp serve
🚀 MCP server ready — 68 tools available (stdio)
Perché jira-cli?
AI-Native
Oltre 68 tool MCP pronti per Claude Desktop, Copilot, Cursor e qualunque client compatibile. Output compatto ottimizzato per LLM.
Cloud & Server
Supporto completo per Jira Cloud (Basic Auth) e Jira Server/Data Center (Bearer PAT). Selezione automatica della versione API.
Multi-Sito
Configura più istanze Jira e passa dall'una all'altra con --site, env var JIRA_SITE o default nel config.
Single Binary
Un solo eseguibile standalone. Zero dipendenze runtime. Pubblicazione cross-platform: Linux, macOS, Windows.
Compact Output
Output ridotto rispetto alle API raw. Solo i campi essenziali, formato ottimizzato per il consumo da parte di LLM.
JQL Potente
Query JQL complete con paginazione classica e cursor-based. Supporto --fetch-all per iterare tutte le pagine.
Installazione
dotnet tool
dotnet tool install -g JiraCli-Mcp
Single Binary
# macOS
curl -L "https://github.com/LuPaLa-Coder/mcp_jira/raw/main/publish/mac/jira" -o jira
chmod +x jira && sudo mv jira /usr/local/bin/
# Linux
curl -L "https://github.com/LuPaLa-Coder/mcp_jira/raw/main/publish/linux/jira" -o jira
Windows
# Scarica jira.exe da publish/windows e aggiungilo alla PATH
curl.exe -L "https://github.com/LuPaLa-Coder/mcp_jira/raw/main/publish/windows/jira.exe" -o jira.exe
jira.exe --version
Verifica & Aggiornamento
jira --version
jira context
# Aggiornamento: riscarica il binario da publish/
Quick Setup
# 1. Registra il tuo sito Jira Cloud
jira config add --site myco \
--url https://myco.atlassian.net \
--email me@myco.com \
--token ATATT3xFfGF0...
# 2. Oppure Jira Server/Data Center (PAT)
jira config add --site eng \
--url https://jira.mycompany.com/jira \
--token <PersonalAccessToken> \
--auth-mode bearer
# 3. Verifica
jira context
# 4. Avvia MCP server
jira mcp serve
# 5. Oppure usa la CLI direttamente
jira issue get PROJ-123
jira search --jql "assignee = currentUser() ORDER BY updated DESC"
68 MCP Tools
Tutti i tool accettano --site come override. Rilevamento automatico dal config, env var o default.
🎫 Issue (13)
get_issue
create_issue
update_issue
delete_issue
assign_issue
transition_issue
add_comment
get_comments
add_worklog
get_issue_worklog
get_worklog
get_issue_transitions
get_remote_links
📎 Allegati & Sub-task (6)
add_attachment
list_attachments
download_attachment
download_all_attachments
get_attachment_metadata
list_subtasks
🔍 Search (2)
search_issues_jql
search_issues_jql_post
📁 Projects (12)
get_all_projects
get_project
create_project
update_project
delete_project
get_project_statuses
get_project_components
get_project_versions
get_project_roles
get_project_role
get_project_properties
get_project_features
🏷️ Issue Types & Status (6)
get_issue_types
get_issue_type
get_statuses
get_status
get_status_categories
get_project_types
📊 Board & Sprint (8)
get_all_boards
get_board
get_board_issues
get_sprints
get_sprint
create_sprint
update_sprint
move_issues_to_sprint
👤 Users (4)
get_current_user
get_user
get_users_assignable
get_user_groups
🔗 Links & Watchers (4)
create_issue_link
delete_issue_link
add_watcher
remove_watcher
🔧 Fields & Filters (6)
get_fields
get_field_contexts
create_custom_field
get_filters
get_filter
create_filter
⚙️ Config & Admin (7)
jira_context
jira_config_list
update_filter
delete_filter
create_webhook
get_webhooks
delete_webhook
Integrazioni AI
Aggiungi jira-cli come MCP server al tuo client AI preferito.
Claude Desktop
Aggiungi al claude_desktop_config.json:
{
"mcpServers": {
"jira": {
"command": "/usr/local/bin/jira",
"args": ["mcp", "serve"]
}
}
}
GitHub Copilot
Configura in mcp-servers.json:
{
"mcpServers": {
"jira": {
"command": "/usr/local/bin/jira",
"args": ["mcp", "serve"]
}
}
}
Debug Mode
Attiva il logging HTTP dettagliato su stderr:
jira --debug mcp serve
# Output su stderr:
[DBG] → GET https://jira.myco.com/rest/api/2/myself
[DBG] ← 200 OK (312 ms)
[DBG] Body: {"name":"jdoe",...}