Genel Bakış
Jira MCP, Kuika uygulamanızın Jira API’si ile doğrudan etkileşime geçmesini sağlar. Bu sayede issue yönetimi, kullanıcı bilgisi, worklog ve proje bazlı sorgular MCP aracılığıyla standartlaştırılmış şekilde yapılabilir.
Configuration Manager Üzerinden Ayarların Yapılması
Kuika platformuna giriş yapın. Apps ekranından çalışacağınız projeyi seçin. Configuration Manager → App Settings sekmesine gidin.
MCP → Jira bölümünden ADD NEW seçeneğini tıklayın.Açılan pencerede: Name: Entegrasyona verilecek ayırt edici ad.Email: Jira (Atlassian) hesabınıza bağlı e-posta adresi.API Token: Atlassian üzerinden oluşturulan token.Host: Jira URL’si (örn: https://your-domain.atlassian.net). Jira API Token Oluşturma
Atlassian API Tokens adresine gidin.Create API token seçeneğini tıklayın. Name: Token için açıklayıcı bir ad girin.Expires on: Token’in geçerlilik süresini belirleyin. Create butonuna tıklayın.Oluşturulan token ekranda görüntülenecektir → Copy ile kopyalayın. Token yalnızca bir kez görüntülenir. Kuika’daki Jira MCP Settings ekranına yapıştırın. Action Türleri
Jira Delete Issue
Bir issue’yu siler.
Input
settings → Jira ayarı issue_key → Silinecek issue (örn: "TEST-123") Output
"ok": true, "message": "Issue TEST-123 has been deleted successfully." Hata durumları: 404 (bulunamadı), 403 (yetki yok), 400 (geçersiz input). Jira Get Issue
Belirli bir issue’nun bilgilerini getirir.
Input
settings → Jira ayarı issue_key → Issue key (örn: "PROJ-45") update_history → true → değişiklik geçmişi (changelog) de gelir. Output
summary → Kısa başlık description → Açıklama assignee → Atanan kullanıcı bilgileri (display_name, email, avatar_url, name) reporter → Raporlayan kullanıcı bilgileri status → Güncel durum (name, category, color) priority → Öncelik bilgisi (id, name, icon_url) labels → Eklenmiş etiketler created, updated → Tarihler id, key → Issue ID ve Key Jira Get Issues
JQL (Jira Query Language) ile issue listesi getirir.
Input
settings → Jira ayarı jql → Örn: project = KOA AND assignee = currentUser() ORDER BY created DESC limit → Maksimum sonuç (default 50, max 100) start_at → Pagination başlangıcı projects_filter → Örn: ["APP", "HR"] Output
Her issue için:
key, summary, description status → (id, name, category, color_name, icon_url) priority → (id, name, icon_url) issue_type → (id, name, description, icon_url) assignee, reporter → Kullanıcı bilgileri (display_name, email, avatar_url) labels → Eklenen etiketler custom_fields → Özel Jira alanları (customfield_XXXXX) created, updated → Tarihler url → Issue linki Jira Get Project Issues
Belirli bir projenin tüm issue’larını getirir.
Input
settings → Jira ayarı project_key → Proje key (örn: "APP") limit, start_at → Sonuç sayısı ve sayfalama Output
Get Issues ile aynı yapıya sahiptir (summary, key, status, priority, assignee, reporter vb.). Jira Get Transitions
Belirli bir issue’nun geçebileceği workflow durumlarını listeler.
Input
settings → Jira ayarı issue_key → Örn: "TEST-123" Output
transitions listesi (her bir geçişin id, name, to status bilgisi). Jira Get User
Kullanıcı bilgilerini döndürür.
Input
settings → Jira ayarı user_identifier → accountId, username veya email Output
success → true/false user → Kullanıcı bilgileri: display_name, email, avatar_url, name Jira Get Worklog
Bir issue’ya ait worklog bilgisini getirir.
Input
settings → Jira ayarı issue_key → Örn: "PROJ-45" Output
id → Worklog ID comment → Açıklama author → Kullanıcı bilgisi timeSpent, timeSpentSeconds → Harcanan süre created, updated, started → Tarih bilgileri Kuika’da Kullanım
Configuration Manager’da oluşturulan Jira ayarları , projedeki Jira Action içinde settings parametresine bağlanarak kullanılabilir.
Örnek senaryolar:
Belirli bir issue detayını görüntüleme → Get Issue Proje bazlı issue listesi getirme → Get Project Issues Kullanıcıya atanmış task’ları sorgulama → Get Issues (JQL) Issue workflow geçişlerini kontrol etme → Get Transitions Worklog raporu oluşturma → Get Worklog