68 MCP Tools

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.

68MCP Tools
.NET 8C# 12
MITOpen Source
Cloud & DCJira Server
$ 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",...}