Atlassian MCP Server
resmiJira, Confluence, Opsgenie ve diğer Atlassian ürünlerine AI ajanlarını bağlamak için resmi Atlassian MCP sunucusu.
Atlassian MCP ile neler yapabilirsiniz?
- Atlassian ürünlerinde arama yapın — Asistanınızdan araç değiştirmeden Jira sorunlarını, Confluence sayfalarını, Bitbucket depolarını veya Projects’i bulmasını isteyin.
- İş öğeleri oluşturun ve güncelleyin — Asistanınıza doğal dil ile Jira hikayeleri oluşturmasını, sorunları güncellemesini veya Confluence sayfaları üretmesini talimat verin.
- İçerik özetleyin ve alın — Asistanınızın Confluence sayfalarını, Loom kayıtlarını veya Jira Service Management taleplerini özetlemesini sağlayın.
- Tekrarlayan iş akışlarını otomatikleştirin — Asistanınızdan toplantı notlarından toplu Jira sorunları oluşturmasını veya iş öğelerini ilgili dokümantasyona bağlamasını isteyin.
- Proje ve hedef durumunu sorgulayın — AI istemcinizde doğrudan Projects, Goals veya Compass bileşen bağımlılıkları hakkında gerçek zamanlı güncellemeler alın.
Barındırılan MCP Sunucusu
npx add-mcp 'https://mcp.atlassian.com/v1/mcp/authv2'Claude Code, Codex, Cursor ve daha fazlasına kurulur
Dokümantasyon
Atlassian MCP Server
Atlassian için resmi Model Context Protocol (MCP) sunucusu: AI araçlarınıza Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom ve daha geniş Atlassian platformuna güvenli, gerçek zamanlı erişim sağlayan bulut tabanlı bir köprü — Teamwork Graph'ınız tarafından desteklenir.
Başlarken · Desteklenen araçlar · Güvenlik ve yönetim · Topluluk
Resmi Atlassian MCP Server, 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, Compass, Loom ve Atlassian platform verileriyle (Projeler, Hedefler, Takımlar, Focus, Talent ve Teamwork Graph) gerçek zamanlı olarak etkileşime girmesini sağlar. Kimlik doğrulama, OAuth 2.1 veya API belirteçleri kullanır; böylece her işlem, kullanıcının mevcut erişim kontrollerine saygı gösterir.
Atlassian MCP Server ile şunları yapabilirsiniz:
- Özetleyin ve arayın — araç değiştirmeden Jira, Jira Service Management, Confluence, Bitbucket, Projeler, Hedefler ve daha fazlasında.
- Alın ve inceleyin — Loom'dan video ve toplantı kayıtlarını.
- Oluşturun ve güncelleyin — doğal dil komutlarına dayalı iş öğeleri veya sayfalar.
- Tekrarlayan işleri otomatikleştirin — toplantı notlarından veya şartnamelerden iş öğeleri oluşturma gibi.
Bir kez bağlanın, sonra ne istediğinizi tarif edin — sekme değiştirme ve kopyala-yapıştır yok. AI'nız doğru eylemleri seçer ve çalıştırır.
IDE'lerde veya AI 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.
[!IMPORTANT] v2 artık önerilen sürümdür. Yeni kurulumlar
https://mcp.atlassian.com/v2/mcpkullanmalıdır; bu sürüm daha fazla araç ve daha fazla ürün sunar. Mevcut v1 bağlantıları otomatik olarak v2 araçlarını kullanıma sunmaya ve kullanmaya başlar; uyumsuz istemcilerin kimlik doğrulamaya devam etmek için önbelleğe alınmış istemci kimliklerini veya.well-knownkimlik bilgilerini temizlemesi gerekebilir. Kurulum adımları için bkz. Atlassian MCP Server ile Başlarken.
Tek tıkla kurulum
Aşağıdan AI istemcinizi seçerek resmi Atlassian MCP Server'ı kurun. Her düğme, istemcinizin yerel kurulum bağlantısını kullanır; böylece herhangi bir JSON yapılandırmasını elle düzenlemenize gerek kalmaz.
|
Cursor'a Ekle Kod tabanınızda sorunlara referans verin ve iş günlüğü tutun. |
VS Code'a Ekle GitHub Copilot ile Jira sorunlarını 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. |
Aracınızın kurulumu yapmasına izin verin
Çoğu AI kodlama aracı, sunucuyu kendisi kurabilir, kimlik doğrulamasını yapabilir ve yapılandırabilir. Bu istemi kopyalayıp aracınıza yapıştırın:
Set up Atlassian MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.
Veya sunucuyu istemcinizin kendi komutuyla manuel olarak ekleyin:
| İstemci | Komut veya yapılandırma |
|---|---|
| Claude Code | claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp, ardından kimlik doğrulamak için bir oturumda /mcp komutunu çalıştırın |
| Codex | codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp |
| Claude Desktop | Ayarlar → Uzantılar → Uzantılara Gözat → Eklentiler, ardından Atlassian arayın |
| Codex Desktop | Eklentiler veya Bağlayıcılar, ardından Atlassian Rovo kurun |
| VS Code / GitHub Copilot | Uzantılar görünümü → @mcp Atlassian arayın → Kur |
| Cursor | MCP ile Cursor için Atlassian eklentisi → Cursor'a Ekle |
| Windsurf | Cascade → MCP sunucuları → Sunucu Ekle → Özel sunucu ekle, serverUrl değerini https://mcp.atlassian.com/v2/mcp olarak ayarlayın |
| Diğer tüm MCP istemcileri | https://mcp.atlassian.com/v2/mcp sunucu URL'sini kullanın |
İçindekiler
- Tek tıkla kurulum
- Desteklenen istemciler
- Eklenti paketleme ve uyumluluk
- Desteklenen ürünler ve araçlar
- Sunucu araçları nasıl sunar
- MCP ağ geçitleri
- 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 MCP Server, giderek büyüyen bir MCP uyumlu istemci listesiyle çalışır:
| İstemci | Kurulum referansı |
|---|---|
| OpenAI ChatGPT | Bağlayıcılar / MCP kılavuzu |
| OpenAI Codex (CLI ve Desktop) | Codex MCP belgeleri |
| Claude (Claude.ai, Desktop ve Code) | Claude MCP belgeleri |
| Cursor | Cursor pazarında Atlassian |
| Visual Studio Code (GitHub Copilot) | VS Code MCP belgeleri |
| GitHub Copilot CLI | Copilot CLI Hakkında |
| Google Gemini CLI | Gemini CLI MCP belgeleri |
| Windsurf | Windsurf MCP belgeleri |
| Docker | Docker MCP Kataloğu ve Araç Seti |
| Kiro ve diğer Agent Plugins istemcileri | Kiro Powers belgeleri |
| Amazon Quick Suite | MCP entegrasyon kılavuzu |
Atlassian MCP Server ayrıca localhost üzerinde çalışabilen ve sunucuya mcp-remote proxy üzerinden bağlanabilen herhangi bir yerel MCP uyumlu istemciyi de destekler. Bu, MCP spesifikasyonunu takip eden özel veya üçüncü taraf entegrasyonları mümkün kılar.
[!TIP] Desteklenen istemcilerin güncel ve resmi listesi ile adım adım kurulum için bkz. Atlassian MCP Server ile Başlarken. Ayrıca istemcinizin kendi MCP belgelerine veya yerleşik asistanına başvurabilirsiniz.
Eklenti paketleme ve uyumluluk
Bu depo, aynı MCP sunucusunu ve becerilerini, istemcilerin yerel keşif ve kurulum akışlarını kullanabilmesi için çeşitli paket formatlarında yayınlar:
| Format | Bildirim ve yapılandırma | Paylaşılan bileşenler |
|---|---|---|
| Agent Plugins v1 | plugin.json ve mcp.json | skills/ |
| Claude Code eklentisi | .claude-plugin/plugin.json ve .claude-plugin/marketplace.json | .mcp.json ve skills/ |
| Cursor eklentisi | .cursor-plugin/plugin.json | .mcp.json ve skills/ |
| Gemini uzantısı | gemini-extension.json | Bildirime gömülü MCP sunucu yapılandırması |
| MCP Kayıt Defteri | server.json | Uzak sunucu meta verileri |
skills/ içindeki beceriler /v2/mcp uç noktasını hedefler ve paketlenmiş her eklentinin kurduğu şeydir. Önceki nesil, hâlâ v1 uç noktasında olanlar için skills/v1/ içinde arşivlenmiştir; hiçbir eklenti tarafından kurulmaz ve manuel olarak ayarlanır. Farklar için bkz. skills/README.md.
Hem mcp.json hem de .mcp.json kasıtlıdır. Agent Plugins, kök mcp.json dosya adını ve taşınabilir taşıma sözlüğünü gerektirir; mevcut istemciler .mcp.json ve yerel yapılandırma sözlüklerini kullanmaya devam eder. Her iki dosyayı değiştirirken uç nokta ayarlarını uyumlu tutun.
Kök paket, Kiro Powers dahil Agent Plugins uygulayan istemciler tarafından içe aktarılabilir. İstemciye özel bildirimler kullanılabilir durumda kalır ve taşınabilir paketle değiştirilmez.
Desteklenen ürünler ve araçlar
Araçlar, ürüne ve amaca (okuma, yazma, arama, silme veya yönetme) göre düzenlenmiştir. 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_jira · write_jira · search_jira | ✅ | ✅ |
| Jira (yönetici etkin) | delete_jira · manage_jira | ✅ | ✅ |
| Confluence | read_confluence · write_confluence · search_confluence | ✅ | ✅ |
| Bitbucket Cloud | read_bitbucket · write_bitbucket | ✅ | ✅ |
| Jira Service Management | read_jsm · write_jsm | — | ✅ (yalnızca) |
| Atlassian platformu | read_teamwork_graph · write_teamwork_graph · search_atlassian | ✅ | ✅ |
| Loom | read_loom · write_loom | ✅ | ✅ |
| Hedefler | read_goals · write_goals | ✅ | ✅ |
| Projeler | read_projects · write_projects | ✅ | ✅ |
| Takımlar | read_teams · write_teams | ✅ | ✅ |
| Focus | read_focus · write_focus | ✅ | ✅ |
| Talent | read_talent · write_talent | ✅ | ✅ |
| Compass | read_compass · write_compass | ✅ (yalnızca) | — |
Ürüne özel koşullar:
delete_jiravemanage_jiravarsayılan olarak devre dışıdır ve kullanılabilmeleri için önce bir yönetici tarafından etkinleştirilmeleri gerekir.- Bitbucket Cloud araçları yalnızca Bitbucket çalışma alanınız bir kuruluşa bağlıysa kullanılabilir. Bir kuruluşa bağlı olmayan çalışma alanları kimlik doğrulama sırasında seçilemez.
- Jira Service Management araçları yalnızca API belirteciyle kimlik doğrulamayı destekler ve yalnızca bir kuruluş yöneticisi API belirteci kimlik doğrulamasını etkinleştirmişse kullanılabilir.
- Loom araçları yalnızca bir Atlassian sitesine bağlı Loom çalışma alanları için kullanılabilir.
- Teamwork Graph araçları, bağlı çekme istekleri, derlemeler ve dağıtımlar gibi Jira'ya bağlı üçüncü taraf hizmetlerden veri alabilir. GitHub for Atlassian için tam erişim, araçların GitHub verilerini kullanıcının GitHub izinlerine göre alması anlamına gelirken, sınırlı erişim verileri kullanıcının Jira izinlerine göre alması anlamına gelir. Azure DevOps, GitLab, Jenkins ve Spinnaker bağlayıcıları sınırlı erişim modelini izler.
[!NOTE] Her izin grubu için gereken kapsam dahil olmak üzere eksiksiz ve güncel araç referansı için bkz. Desteklenen araçlar.
Sunucu araçları nasıl sunar?
Atlassian MCP Server, bağlantı sırasında her araç tanımını AI istemcisine göndermek yerine en çok kullanılan araçların küçük bir kümesini sunar ve istemcinin geri kalanını isteğe bağlı olarak keşfetmesine olanak tanır. Birincil olarak işaretlenen araçlar aracılara doğrudan görünür.
Bunun iki faydası vardır:
- İstemcinizin bağlamı, araç tanımlarıyla doldurulmak yerine eldeki görev için boş kalır.
- İstemcinin yeniden bağlanmasına gerek kalmadan yeni araçlar kullanılabilir hale gelir.
MCP ağ geçitleri
Bir MCP ağ geçidi kullanıyorsanız veya keşif ve yürütme yöntemlerini kullanmak yerine tüm araçların önceden kullanılabilir olmasına ihtiyacınız varsa, tüm araçları sayfalanmış düz bir araç listesi olarak sunmak için tools=all geçersiz kılmasını kullanın:
https://mcp.atlassian.com/v2/mcp?tools=all
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 ürünlerinden bir veya daha fazlasını içeren bir Atlassian Cloud sitesi
- Seçtiğiniz 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
Kuruluş yöneticiniz API belirteciyle kimlik doğrulamayı devre dışı bıraktıysa, MCP istemcileri bir belirteçle bağlanamaz ve bunun yerine OAuth 2.1 kullanması gerekir.
IDE'ler veya yerel istemciler için (masaüstü kurulumu)
- Bir veya daha fazla desteklenen ürün içeren 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 oturum açmayı 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 birkaç güvenlik kontrolü uygular:
- Tüm trafik, Atlassian'ın güvenlik uygulamalarına göre 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, Compass ve Loom dahil olmak üzere bağlı her Atlassian ürününde kullanıcı izinlerine saygı gösterir.
- Kuruluşunuz Atlassian Cloud ürünleri için IP izin listesi kullanıyorsa, Atlassian MCP Server üzerinden yapılan araç çağrıları da bu IP kurallarına uyar.
Güvenlik modeli ve yönetici kontrolleri hakkında daha derin bir genel bakış için bkz.:
Nasıl çalışır?
Mimari ve iletişim
-
Desteklenen bir istemci sunucu uç noktasına bağlanır. Tüm istemciler için önerilen uç nokta şudur:
https://mcp.atlassian.com/v2/mcpv1 uç noktaları (
https://mcp.atlassian.com/v1/mcp/authv2vehttps://mcp.atlassian.com/v1/mcp) desteklenmeye devam eder ve mevcut v1 bağlantıları otomatik olarak v2 araçlarını sunmaya ve kullanmaya başlar. -
Kurulumunuza bağlı olarak, güvenli bir tarayıcı tabanlı OAuth 2.1 akışı tetiklenir veya API belirteci kimlik doğrulaması kullanılır.
-
Yetkilendirildikten sonra istemci, bağlı Atlassian ürünlerinizden bağlamsal verileri akışlar ve gerçek zamanlı yanıtlar alır.
[!WARNING] 30 Haziran 2026'dan sonra eski Server-Sent Events uç noktası (
https://mcp.atlassian.com/v1/sse) artık desteklenmeyecektir./ssekullanacak şekilde yapılandırılmış özel istemcileri/mcp— tercihenhttps://mcp.atlassian.com/v2/mcp— işaret edecek şekilde güncelleyin.
[!NOTE] v2 araçlarına geçişten sonra kimlik doğrulamayı tamamlayamayan istemcilerin önbelleğe alınmış istemci kimliklerini veya
.well-knownkimlik bilgilerini temizlemesi gerekebilir.
İ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 saygı gösterir. OAuth ve API belirteci kimlik doğrulaması, yapılandırılmış kapsamları ve Atlassian izinlerini onurlandırır.
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 araçları için gereklidir.
İki mekanizma desteklenir:
| Mekanizma | Başlık |
|---|---|
| Kişisel API belirteci (Temel kimlik doğrulama) | Authorization: Basic <base64(email:api_token)> |
| Hizmet hesabı API anahtarı (Taşıyıcı belirteç) | Authorization: Bearer <api_key> |
- Yönetici etkinleştirmesi gerekli: Bir kuruluş yöneticisi, Atlassian MCP Server 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 gereken kapsamlarla kişisel bir API belirteci oluşturun veya yöneticinizden bir hizmet hesabı API anahtarı isteyin.
- Yapılandırma kılavuzu: API belirteciyle kimlik doğrulamayı yapılandırın
- Yönetici ayarı referansı: Atlassian MCP Server 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örevler çalıştırabilirsiniz.
Jira iş akışları
- Arama: "Project Alpha'daki tüm açık hataları bul."
- Oluştur/güncelle: "'Yeniden işe alımı tasarla' başlıklı bir hikaye oluştur."
- Toplu oluştur: "Bu notlardan beş Jira sorunu oluştur."
Confluence iş akışları
- Özetle: "Q2 planlama sayfasını özetle."
- Oluştur: "'Q3 Takım Hedefleri' başlıklı bir sayfa oluştur."
- Gezin: "Hangi alanlara erişimim var?"
Compass iş akışları
- Oluştur: "Geçerli depoya dayalı bir hizmet bileşeni oluştur."
- Toplu oluştur: "Bu CSV/JSON'dan bileşenleri ve özel alanları içe aktar."
- Sorgula: "
api-gatewayhizmetine ne bağlı?"
Loom iş akışları
- Al: "Geçen haftaki tasarım incelemesinin Loom kaydını bul."
- Özetle: "Bu Loom anlatımını özetle ve eylem öğelerini listele."
Projeler ve Hedefler iş akışları
- Durum: "Checkout Revamp projesinin mevcut durumu nedir?"
- Özetle: "Bu çeyrekte hangi hedefler risk altında ve neden?"
Birleşik görevler
- İçerik bağla: "Bu üç Jira iş öğesini 'Sürüm Planı' sayfasına bağla."
- Dokümantasyon bul: "Bu Compass bileşenine bağlı Confluence dokümantasyon sayfasını getir."
- İşi ilerlet: "PROJ-456'yı 'İncelemede' durumuna taşı ve PR'ın yukarıda olduğuna dair bir yorum ekle."
[!NOTE] Gerçek yetenekler, izin düzeyinize 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 araç çağrılarını azaltmak, zaman ve belirteç tasarrufu sağlamak ve maksimum arama sonuçlarını ayarlamak için AGENTS.md dosyanızı aşağıdaki Markdown ile güncelleyin.
## Atlassian 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 Atlassian 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 MCP Server'ı kullanmaya hazırlayan bir yöneticiyseniz aşağıdaki noktaları inceleyin. Daha ayrıntılı yönetici rehberliği için bkz.:
- Atlassian MCP Server'ı Anlayın
- Atlassian MCP Server ayarlarını kontrol edin
- Atlassian MCP Server'ı yönetin
- Atlassian MCP Server etkinliğini izleyin
Erişimi yönetin, izleyin ve iptal edin
- Yönetici kontrolleri: Site ve kuruluş yöneticileri, MCP uygulamasının erişimini Kuruluşunuzun Marketplace ve üçüncü taraf uygulamalarını yönetin sayfasından yönetebilir, inceleyebilir veya iptal edebilir.
- Alan kontrolleri: Hangi harici AI araçlarının ve alanların bağlanmasına izin verildiğini kontrol etmek için Atlassian Yönetimi'ndeki Rovo MCP sunucusu ayarlar sayfasını kullanın. Varsayılan olarak, Atlassian destekli alanlara izin verilir; güvenilir alanlar ekleyebilir veya desteklenenleri engelleyebilirsiniz. Alan kontrolleri OAuth 2.1 bağlantıları için geçerlidir. Ayrıntılar için bkz. Kullanılabilir Atlassian MCP sunucu alanları.
- IP kontrolleri: Kuruluşunuz Atlassian Cloud uygulamaları için IP izin listesi kullanıyorsa, Atlassian MCP Server üzerinden yapılan istekler, ilgili uygulama için kuruluşunuzun IP izin listesinde izin verilen bir IP adresinden gelmelidir. Yapılandırma ayrıntıları için bkz. Ürün erişimi için IP adreslerini belirtin. Bitbucket Cloud IP kısıtlamaları, çalışma alanı yöneticileri tarafından Çalışma alanı ayarları → Erişim kontrolleri altında ayrı olarak yapılandırılır. Bkz. Bir çalışma alanında özel içeriğe erişimi kontrol edin.
- Son kullanıcı kontrolleri: Bireysel kullanıcılar, profil ayarlarından kendi uygulama yetkilendirmelerini iptal edebilir.
- Denetim günlüğü: Atlassian MCP Server üzerinden 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 arayın). Daha fazla bilgi için bkz. Atlassian MCP sunucu etkinliğini izleyin.
Yaygın sorunları giderme
-
"Bu IP adresinden bağlanma izniniz yok. Lütfen erişim için yöneticinize danışın." Bu genellikle IP izin listesinin etkin olduğunu ve isteğin kaynak IP adresinin ilgili uygulamaya Atlassian MCP Server üzerinden erişmesine izin verilmediğini gösterir. Site, kuruluş veya Bitbucket çalışma alanı yöneticinizden geçerli IP izin listesini incelemesini isteyin.
Barındırılan AI istemcileri, istekleri kullanıcının kurumsal ağı veya VPN'i yerine AI sağlayıcısının giden IP adreslerinden gönderebilir. Bu nedenle izin verilen bir VPN'de olmak yetersiz olabilir. Yöneticinizden sağlayıcının yayınlanan giden IP aralıklarını incelemesini ve gerekli erişimi onaylamasını isteyin. OpenAI tarafından barındırılan bağlayıcılar için bkz. OpenAI'nin IP çıkış rehberliği. Yerel MCP bağlantıları yerel ağın giden IP adresini kullanabilir. Bkz. IP izin listesinin Atlassian MCP ile nasıl çalıştığı.
-
OAuth oturum açma başarılı ancak araç çağrıları 403 döndürüyor. Başarılı oturum açma, araç çağrılarının IP kısıtlamalarını geçeceğini garanti etmez. 403 ayrıca yetersiz kapsamları, uygulama izinlerini veya başka bir erişim ilkesini gösterebilir. Bir IP izin listesini değiştirmeden önce reddetme nedenini doğrulayın.
Güvenlik
Model Context Protocol (MCP), AI aracılarının hesabınızın izinlerini kullanarak araçlara ve Atlassian verilerine bağlanmasına olanak tanır; bu, güçlü iş akışları oluşturur ancak aynı zamanda yapısal riskler de taşı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ıkla" entegrasyonlar), bir AI aracısının sizin adınıza eylemler gerçekleştirmesine neden olabilir.
Büyük dil modelleri (LLM'ler) istemci enjeksiyonuna ve ilgili saldırılara (dolaylı istemci enjeksiyonu ve araç zehirlenmesi gibi) karşı savunmasızdır. Bu saldırılar, aracıya açık istekler olmadan verileri dışarı sızdırmasını veya istenmeyen değişiklikler yapmasını talimat verebilir. Riski azaltmak için yalnızca güvenilir MCP istemcilerini ve sunucularını kullanın, her aracın ve verinin hangi aracıya erişebileceğini dikkatlice inceleyin ve en az ayrıcalık ilkesini uygulayın (kapsamlı token'lar, minimum proje/çalışma alanı erişimi). Yüksek etkili veya yıkıcı herhangi bir işlem için insan onayı isteyin ve olağandışı etkinlikler için denetim günlüklerini izleyin. Atlassian'ın MCP riskleri hakkındaki rehberini incelemenizi şiddetle öneririz: MCP İstemcileri: Potansiyel güvenlik risklerini anlama.
Destek ve geri bildirim
Atlassian MCP Sunucusu'nu iyileştirmek için geri bildiriminizi 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 paylaşın; geliştiriciyle ilgili sorularınızı ise Atlassian Geliştirici Topluluğu'nda paylaşın.
- Bir uygulama oluşturuyorsanız ve bir hata veya sorun bulduysanız ya da önerileriniz varsa Ekosistem Geliştirici Portalı'na gidin.
Sorumluluk reddi
MCP istemcileri, mevcut izinlerinizle Atlassian ürünleri genelinde işlemler 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: MCP İstemcileri: Potansiyel güvenlik risklerini anlama.