Atlassian MCP Server

Atlassian Rovo MCP Sunucusu

Atlassian için resmi Model Bağlam Protokolü (MCP) sunucusu: Yapay zeka araçlarınıza Jira, Confluence, Jira Service Management, Bitbucket ve Compass'a güvenli, gerçek zamanlı erişim sağlayan bulut tabanlı bir köprü.

Başlarken · Desteklenen araçlar · Güvenlik ve yönetim · Topluluk

---

Resmi Atlassian Rovo MCP Sunucusu, Atlassian Cloud siteniz ile uyumlu harici araçlar arasında bulut tabanlı bir köprüdür. Yapılandırıldıktan sonra, bu araçların Jira, Confluence, Jira Service Management, Bitbucket ve Compass verileriyle gerçek zamanlı olarak etkileşime girmesini sağlar. Kimlik doğrulama OAuth 2.1 veya API belirteçleri kullanır, böylece her eylem kullanıcının mevcut erişim kontrollerine uyar.

Atlassian Rovo MCP Sunucusu ile şunları yapabilirsiniz:

• Araçlar arasında geçiş yapmadan Jira, Confluence, Jira Service Management ve Bitbucket içeriğini özetleyin ve arayın.
• Doğal dil komutlarına dayalı olarak iş öğeleri veya sayfalar oluşturun ve güncelleyin.
• Toplantı notlarından veya şartnamelerden bilet oluşturmak gibi tekrarlayan işleri otomatikleştirin.

IDE'lerde veya yapay zeka araçlarında çalışan ve sürekli bağlam değiştirmeden Atlassian verilerini kullanmak isteyen geliştiriciler, içerik oluşturucular ve proje ekipleri için tasarlanmıştır.

Tek tıklamayla kurulum

Resmi Atlassian Rovo MCP Sunucusu'nu yüklemek için aşağıdan yapay zeka istemcinizi seçin. Her düğme, istemcinizin yerel yükleme bağlantısını kullanır, böylece herhangi bir JSON yapılandırmasını elle düzenlemeniz gerekmez.

Cursor'a Ekle Kod tabanınızdaki iş öğelerine referans verin ve çalışma kaydedin.

VS Code'a Ekle GitHub Copilot aracılığıyla Jira iş öğelerini arayın ve oluşturun.

ChatGPT'ye Ekle Doğrudan ChatGPT'den arayın, özetleyin ve oluşturun.

Claude'a Ekle Jira ve Confluence'ı Claude iş akışlarına getirin.

İçindekiler

• Tek tıklamayla kurulum
• Desteklenen istemciler
• Desteklenen ürünler ve araçlar
• Başlamadan önce
• Veri ve güvenlik
• Nasıl çalışır
• Örnek iş akışları
• İpuçları ve püf noktaları
• Yönetici notları: erişimi yönetme
• Güvenlik
• Destek ve geri bildirim
• Sorumluluk reddi

---

Desteklenen istemciler

Atlassian Rovo MCP Sunucusu, büyüyen bir MCP uyumlu istemci listesiyle çalışır:

İstemci	Kurulum referansı
OpenAI ChatGPT	Bağlayıcılar / MCP kılavuzu
Claude (Claude.ai, Masaüstü ve Code)	Claude MCP belgeleri
Cursor	Cursor pazar yerinde Atlassian
Visual Studio Code (GitHub Copilot)	VS Code MCP belgeleri
GitHub Copilot CLI	Copilot CLI Hakkında
Google Gemini CLI	Gemini CLI MCP belgeleri
Amazon Quick Suite	MCP entegrasyon kılavuzu

Atlassian Rovo MCP Sunucusu ayrıca localhost üzerinde çalışabilen ve mcp-remote proxy'si aracılığıyla sunucuya bağlanabilen tüm yerel MCP uyumlu istemcileri de destekler. Bu, MCP spesifikasyonunu takip eden özel veya üçüncü taraf entegrasyonlarına olanak tanır.

[!İPUCU] Desteklenen istemcilerin güncel, kanonik listesi ve adım adım kurulum için Atlassian Rovo MCP Sunucusu'na başlarken sayfasına bakın. Ayrıca istemcinizin kendi MCP belgelerine veya yerleşik asistanına da başvurabilirsiniz.

---

Desteklenen ürünler ve araçlar

Araçlar ürün ve amaca göre düzenlenmiştir (okuma, yazma veya arama). Kuruluş yöneticileri izin grubu düzeyinde erişim verir veya iptal eder ve her araç, üst grubunun erişimini devralır.

Ürün	İzin grupları	OAuth 2.1	API belirteci
Jira	read · write · search	✅	✅
Confluence	read · write · search	✅	✅
Jira Service Management	read · write	—	✅ (yalnızca)
Bitbucket Cloud	read · write	—	✅ (kapsamlı, yalnızca)
Compass	read · write	✅ (yalnızca)	—
Atlassian platformu	read_teamwork_graph · search_atlassian	✅	✅

[!NOT] Jira Service Management ve Bitbucket Cloud araçları yalnızca API belirteci kimlik doğrulamasıyla kullanılabilirken, Compass araçları yalnızca OAuth 2.1 ile kullanılabilir. Eksiksiz, güncel araç referansı için Desteklenen araçlar sayfasına bakın.

---

Başlamadan önce

Sunucuyu kurmadan önce ortamınızın bu gereksinimleri karşıladığını kontrol edin.

Ön koşullar

Gereksinimler nasıl bağlandığınıza bağlıdır:

Desteklenen istemciler için

• Jira, Confluence, Jira Service Management, Bitbucket veya Compass'tan bir veya daha fazlasına sahip bir Atlassian Cloud sitesi
• Seçilen istemciye erişim
• OAuth 2.1 yetkilendirme akışını tamamlamak için modern bir tarayıcı veya başsız kimlik doğrulama için API belirteci kimlik bilgileri

IDE'ler veya yerel istemciler için (masaüstü kurulumu)

• Bir veya daha fazla desteklenen ürüne sahip bir Atlassian Cloud sitesi
• Desteklenen bir IDE (örneğin, Claude Desktop, VS Code veya Cursor) veya özel bir MCP uyumlu istemci
• Yerel MCP proxy'sini çalıştırmak için Node.js v18+ yüklü (mcp-remote)
• OAuth oturumunu tamamlamak için modern bir tarayıcı veya başsız kimlik doğrulama için API belirteci kimlik bilgileri

---

Veri ve güvenlik

Sunucu çeşitli güvenlik kontrolleri uygular:

• Tüm trafik, Atlassian'ın güvenlik uygulamaları uyarınca HTTPS (TLS 1.2 veya üzeri) üzerinden aktarım sırasında şifrelenir.
• OAuth 2.1 ve API belirteci kimlik doğrulaması güvenli erişim kontrolü sağlar.
• Veri erişimi, Jira, Confluence, Jira Service Management, Bitbucket ve Compass kullanıcı izinlerine uyar.
• Kuruluşunuz Atlassian Cloud ürünleri için IP izin listesi kullanıyorsa, Atlassian Rovo MCP Sunucusu aracılığıyla yapılan araç çağrıları da bu IP kurallarına uyar.

Güvenlik modeli ve yönetici kontrollerine daha derinlemesine bir genel bakış için bkz:

• Atlassian Rovo MCP Sunucusu'nu anlayın
• Atlassian Rovo MCP Sunucusu ayarlarını kontrol edin

---

Nasıl çalışır

Mimari ve iletişim

1. Desteklenen bir istemci sunucu uç noktasına bağlanır. Çoğu istemci için önerilen uç nokta şudur:

   https://mcp.atlassian.com/v1/mcp/authv2
   

   https://mcp.atlassian.com/v1/mcp uç noktası da desteklenir (örneğin, API belirteci yapılandırmaları için).

2. Kurulumunuza bağlı olarak, güvenli tarayıcı tabanlı bir OAuth 2.1 akışı tetiklenir veya API belirteci kimlik doğrulaması kullanılır.

3. Yetkilendirildikten sonra, istemci bağlamsal verileri akışa alır ve bağlı Atlassian ürünlerinizden gerçek zamanlı yanıtlar alır.

[!NOT] Eski Sunucu Tarafından Gönderilen Olaylar uç noktası (https://mcp.atlassian.com/v1/sse) hala desteklenmektedir, ancak /sse kullanmak üzere yapılandırılmış özel istemcileri, artık /mcp (veya /mcp/authv2) işaret edecek şekilde güncellemenizi öneririz.

İzin yönetimi

Erişim, yalnızca kullanıcının Atlassian Cloud'da görüntüleme iznine sahip olduğu verilere verilir. Tüm eylemler, mevcut proje veya alan düzeyindeki rollere uyar. OAuth ve API belirteci kimlik doğrulaması, yapılandırılmış kapsamlara ve Atlassian izinlerine uyar.

API belirteci kimlik doğrulaması (başsız)

API belirteci kimlik doğrulaması, başsız, hizmet tarzı veya etkileşimli olmayan istemci kurulumları (örneğin, arka uç sistemleri veya otomasyonlar) için kullanılabilir. Ayrıca Jira Service Management ve Bitbucket Cloud araçları için gereklidir.

• Yönetici etkinleştirmesi gerekli: Bir kuruluş yöneticisi, Rovo MCP Sunucusu için API belirteci kimlik doğrulamasını etkinleştirmelidir (Atlassian Yönetimi → Rovo → Rovo MCP sunucusu → Kimlik Doğrulama).
• Kapsamlı belirteç gerekli: Erişmeniz gereken araçlar ve veriler için gerekli kapsamlara sahip kişisel bir API belirteci oluşturun.
• Yapılandırma kılavuzu: API belirteci ile kimlik doğrulamayı yapılandırın
• Yönetici ayar referansı: Atlassian Rovo MCP Sunucusu ayarlarını kontrol edin: Kimlik doğrulamayı yapılandırın

---

Örnek iş akışları

Bağlandıktan sonra, istemcinizden aşağıdaki gibi görevleri çalıştırabilirsiniz.

Jira iş akışları

• Arama: "Alfa Projesi'ndeki tüm açık hataları bul."
• Oluşturma/Güncelleme: "'Yeniden tasarım katılımı' başlıklı bir hikaye oluştur."
• Toplu oluşturma: "Bu notlardan beş Jira iş öğesi oluştur."

Confluence iş akışları

• Özetleme: "2. çeyrek planlama sayfasını özetle."
• Oluşturma: "'Takım Hedefleri 3. Çeyrek' başlıklı bir sayfa oluştur."
• Gezinme: "Hangi alanlara erişimim var?"

Compass iş akışları

• Oluşturma: "Mevcut depoya dayalı bir hizmet bileşeni oluştur."
• Toplu oluşturma: "Bu CSV/JSON'dan bileşenleri ve özel alanları içe aktar."
• Sorgulama: "api-gateway hizmetine ne bağlı?"

Birleşik görevler

• İçerik bağlama: "Bu üç Jira biletini 'Sürüm Planı' sayfasına bağla."
• Belge bulma: "Bu Compass bileşenine bağlı Confluence belge sayfasını getir."

[!NOT] Gerçek yetenekler, izin seviyenize ve istemci platformunuza bağlı olarak değişir.

---

İpuçları ve püf noktaları

Varsayılan CloudId, Jira projesi ve Confluence alanını ayarlayın

Keşif aracı çağrılarını azaltmak, zamandan ve belirteçlerden tasarruf etmek ve maksimum arama sonuçlarını ayarlamak için AGENTS.md dosyanızı aşağıdaki Markdown ile güncelleyin.

## Atlassian Rovo MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

Becerileri kullanın

Claude gibi bir masaüstü istemcisi kullanıyorsanız, tekrarlanan görevler için beceriler oluşturabilir veya yeniden kullanabilirsiniz. Varsayılan Rovo MCP becerilerine bakın.

Cursor için beceriler, pazar yeri eklentisinin bir parçasıdır.

---

Yönetici notları: erişimi yönetme

Kuruluşunuzu Atlassian Rovo MCP Sunucusu'nu kullanmaya hazırlayan bir yöneticiyseniz, aşağıdaki noktaları gözden geçirin. Daha ayrıntılı yönetici rehberliği için bkz:

• Atlassian Rovo MCP Sunucusunu Anlama
• Atlassian Rovo MCP Sunucusu ayarlarını kontrol etme
• Atlassian Rovo MCP Sunucusunu Yönetme
• Atlassian Rovo MCP Sunucusu etkinliğini izleme

Kurulum ve erişim

• Marketplace uygulaması değildir: Atlassian Rovo MCP Sunucusu, Atlassian Marketplace veya Uygulamaları yönet ekranı üzerinden yüklenmez. Bunun yerine, bir kullanıcı OAuth 2.1 (3LO) onay akışını ilk kez tamamladığında otomatik olarak yüklenir (tam zamanında veya "tembel yükleme" kurulumu).
• İlk kurulum gereksinimleri: Siteniz için 3LO onay akışını tamamlayan ilk kullanıcının, MCP kapsamları tarafından talep edilen Atlassian uygulamalarına (örneğin, Jira ve/veya Confluence) erişimi olmalıdır. Bu, MCP uygulamasının siteniz için doğru izinlerle kaydedilmesini sağlar.
• Sonraki kullanıcı erişimi: İlk kurulumdan sonra, yalnızca bir Atlassian uygulamasına (örneğin, yalnızca Jira veya yalnızca Confluence) erişimi olan kullanıcılar da MCP aracılığıyla bu uygulamaya erişmek için 3LO akışını tamamlayabilir.

Erişimi yönetme, izleme ve iptal etme

• Yönetici kontrolleri: Site ve kuruluş yöneticileri, Kuruluşunuzun Marketplace ve üçüncü taraf uygulamalarını yönetme bölümünden MCP uygulamasının erişimini yönetebilir, inceleyebilir veya iptal edebilir. Uygulama, ilk başarılı 3LO onayından sonra sitenizin Bağlı uygulamalar listesinde görünür.
• Alan adı kontrolleri: Hangi harici yapay zeka araçlarının ve alan adlarının bağlanmasına izin verileceğini kontrol etmek için Atlassian Yönetimi'ndeki Rovo MCP sunucusu ayarları sayfasını kullanın. Varsayılan olarak Atlassian tarafından desteklenen alan adlarına izin verilir; güvenilir alan adları ekleyebilir veya desteklenenleri engelleyebilirsiniz. Alan adı kontrolleri OAuth 2.1 bağlantıları için geçerlidir. Ayrıntılar için Kullanılabilir Atlassian Rovo MCP sunucusu alan adları bölümüne bakın.
• IP kontrolleri: Kuruluşunuz Atlassian Cloud uygulamaları için IP izin listesi kullanıyorsa, Atlassian Rovo MCP Sunucusu üzerinden yapılan istekler, ilgili uygulama için kuruluşunuzun IP izin listesi tarafından izin verilen bir IP adresinden gelmelidir. Yapılandırma ayrıntıları için Ürün erişimi için IP adreslerini belirtme bölümüne bakın.
• Son kullanıcı kontrolleri: Bireysel kullanıcılar, profil ayarlarından kendi uygulama yetkilendirmelerini iptal edebilir.
• Denetim günlüğü: Atlassian Rovo MCP Sunucusu aracılığıyla bir araç her kullanıldığında, kuruluşunuzun denetim günlüğüne bir olay kaydedilir. Yöneticiler bunları Atlassian Yönetimi'nde İçgörüler → Denetim günlüğü altında inceleyebilir (Rovo MCP Kullanıcı Eylemleri için filtreleyin veya MCP araması yapın). Daha fazla bilgi için Atlassian Rovo MCP sunucusu etkinliğini izleme bölümüne bakın.

Sık karşılaşılan sorunları giderme

• "Site yöneticiniz bu uygulamayı yetkilendirmeli" hatası: Başka birinin MCP uygulamasını kullanabilmesi için önce bir site yöneticisinin 3LO onay akışını tamamlaması gerekir. Daha fazla ayrıntı için Atlassian Cloud uygulamalarında "Site yöneticiniz bu uygulamayı yetkilendirmeli" hatası bölümüne bakın.
• "Bu IP adresinden bağlanma izniniz yok. Lütfen yöneticinizden erişim isteyin." Bu genellikle IP izin listesinin etkin olduğunu ve kullanıcının mevcut IP adresinin Atlassian Rovo MCP Sunucusu aracılığıyla Jira, Confluence, Jira Service Management, Bitbucket veya Compass'a erişmesine izin verilmediğini gösterir. Site veya kuruluş yöneticinizden IP izin listesi yapılandırmasını gözden geçirmesini ve uygunsa ilgili ağ veya VPN IP aralıklarını eklemesini isteyin.
• Uygulama Bağlı uygulamalarda görünmüyor: Kullanıcının doğru Atlassian hesabını ve sitesini kullandığından emin olun ve uygulamanın doğru Atlassian uygulama kapsamlarını (örneğin, Jira kapsamları) talep ettiğini onaylayın. Sorunlar devam ederse Kuruluşunuzun Marketplace ve üçüncü taraf uygulamalarını yönetme bölümünü kontrol edin veya Atlassian Destek ile iletişime geçin. Ayrıca Atlassian Yönetimi'nde kullanıcının ürün izinlerini doğrulayın.

---

Güvenlik

Model Bağlam Protokolü (MCP), yapay zeka aracılarının hesabınızın izinlerini kullanarak araçlara ve Atlassian verilerine bağlanmasına olanak tanır; bu da güçlü iş akışları oluştururken aynı zamanda yapısal riskler de yaratır. Etkinleştirdiğiniz herhangi bir MCP istemcisi veya sunucusu (örneğin, IDE eklentileri, masaüstü uygulamaları, barındırılan MCP sunucuları veya "tek tıklamalı" entegrasyonlar), bir yapay zeka aracısının sizin adınıza eylemler gerçekleştirmesine neden olabilir.

Büyük dil modelleri (LLM'ler), istem enjeksiyonu ve ilgili saldırılara (dolaylı istem enjeksiyonu ve araç zehirleme gibi) karşı savunmasızdır. Bu saldırılar, aracıya açık talepler olmadan veri sızdırması veya istenmeyen değişiklikler yapması talimatını verebilir.

Riski azaltmak için yalnızca güvenilir MCP istemcileri ve sunucuları kullanın, her aracının hangi araçlara ve verilere erişebileceğini dikkatlice inceleyin ve en az ayrıcalık ilkesini uygulayın (kapsam belirteçleri, minimum proje/çalışma alanı erişimi). Yüksek etkili veya yıkıcı herhangi bir eylem için insan onayı isteyin ve olağandışı etkinlikler için denetim günlüklerini izleyin. Atlassian'ın MCP riskleri hakkındaki rehberliğini MCP İstemcileri: Olası güvenlik risklerini anlama adresinde incelemenizi şiddetle tavsiye ederiz.

---

Destek ve geri bildirim

Atlassian Rovo MCP Sunucusunu iyileştirmek için geri bildirimlerinizi kullanıyoruz. Bir hata veya sınırlamayla karşılaşırsanız ya da bir öneriniz varsa:

• Sorunları ve özellik isteklerini bildirmek için Atlassian Destek Portalı'nı ziyaret edin.
• Deneyimlerinizi ve sorularınızı Atlassian Topluluğu'nda, geliştiriciyle ilgili sorularınızı ise Atlassian Geliştirici Topluluğu'nda paylaşın.
• Bir uygulama geliştiriyorsanız ve bir hata veya sorun bulduysanız ya da önerileriniz varsa Ekosistem Geliştirici Portalı'na gidin.

---

Yasal Uyarı

MCP istemcileri, mevcut izinlerinizle Jira, Confluence, Jira Service Management, Bitbucket ve Compass'ta eylemler gerçekleştirebilir. En az ayrıcalık ilkesini kullanın, onaylamadan önce yüksek etkili değişiklikleri inceleyin ve olağandışı etkinlikler için denetim günlüklerini izleyin.

Daha fazla bilgi edinin: MCP İstemcileri: Olası güvenlik risklerini anlama.