Kullanıcı Kılavuzu

Jira MCP Settings 

Jira MCP Settings 

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ı

  1. Kuika platformuna giriş yapın.
  2. Apps ekranından çalışacağınız projeyi seçin.
  3. Configuration Manager → App Settings sekmesine gidin.

  1. MCP →  Jira bölümünden ADD NEW seçeneğini tıklayın.
  2. 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

  1. Atlassian API Tokens adresine gidin.
  1. 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.
  2. Create butonuna tıklayın.
  1. Oluşturulan token ekranda görüntülenecektir → Copy ile kopyalayın.
Token yalnızca bir kez görüntülenir.
  1. 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
No items found.

İlişkili diğer içerikler

No items found.

Sözlük

No items found.

Alt Başlıklar