Atlassian MCP Server

resmi

Server MCP resmi Atlassian untuk menghubungkan agen AI ke Jira, Confluence, Opsgenie, dan produk Atlassian lainnya.

GitHub

871

Apa yang bisa Anda lakukan dengan Atlassian MCP?

Cari dan rangkum konten Jira, Confluence, atau Bitbucket — minta AI Anda untuk menemukan bug yang terbuka, merangkum halaman, atau mencari di seluruh proyek menggunakan alat search.
Buat dan perbarui isu Jira atau halaman Confluence — gunakan bahasa alami untuk menghasilkan cerita, tugas, atau dokumentasi melalui alat write.
Kueri dan kelola komponen Compass — cari dependensi layanan atau buat komponen dari repositori Anda dengan alat read dan write Compass.
Buat item massal dari catatan atau spesifikasi — ubah catatan rapat menjadi beberapa isu Jira atau impor komponen dari data terstruktur dalam satu langkah.
Tautkan pekerjaan terkait di seluruh produk — hubungkan tiket Jira ke halaman Confluence atau ambil dokumentasi yang tertaut ke komponen Compass.

Dokumentasi

Atlassian

Atlassian Rovo MCP Server

Server Model Context Protocol (MCP) resmi untuk Atlassian: jembatan yang dihosting di cloud yang memberikan alat AI Anda akses aman dan real-time ke Jira, Confluence, Jira Service Management, Bitbucket, dan Compass.

Memulai · Alat yang didukung · Keamanan & admin · Komunitas

Atlassian Rovo MCP Server resmi adalah jembatan berbasis cloud antara situs Atlassian Cloud Anda dan alat eksternal yang kompatibel. Setelah dikonfigurasi, ini memungkinkan alat-alat tersebut untuk berinteraksi dengan data Jira, Confluence, Jira Service Management, Bitbucket, dan Compass secara real time. Autentikasi menggunakan OAuth 2.1 atau token API, sehingga setiap tindakan menghormati kontrol akses pengguna yang ada.

Dengan Atlassian Rovo MCP Server, Anda dapat:

Meringkas dan mencari konten Jira, Confluence, Jira Service Management, dan Bitbucket tanpa berpindah alat.
Membuat dan memperbarui isu atau halaman berdasarkan perintah bahasa alami.
Mengotomatiskan pekerjaan berulang, seperti membuat tiket dari catatan rapat atau spesifikasi.

Ini dibangun untuk pengembang, pembuat konten, dan tim proyek yang bekerja di IDE atau alat AI dan ingin menggunakan data Atlassian tanpa terus-menerus berpindah konteks.

Penyiapan sekali klik

Pilih klien AI Anda di bawah ini untuk menginstal Atlassian Rovo MCP Server resmi. Setiap tombol menggunakan tautan instalasi asli klien Anda, sehingga Anda tidak perlu mengedit konfigurasi JSON secara manual.

Tambahkan ke Cursor
_{Referensikan isu dan catat pekerjaan di basis kode Anda.}

Tambahkan ke VS Code
_{Cari dan buat isu Jira melalui GitHub Copilot.}

Tambahkan ke ChatGPT
_{Cari, ringkas, dan buat langsung dari ChatGPT.}

Tambahkan ke Claude
_{Bawa Jira dan Confluence ke dalam alur kerja Claude.}

Klien yang didukung

Atlassian Rovo MCP Server bekerja dengan daftar klien yang kompatibel dengan MCP yang terus bertambah:

Klien	Referensi penyiapan
OpenAI ChatGPT	Panduan Konektor / MCP
Claude (Claude.ai, Desktop, dan Code)	Dokumentasi Claude MCP
Cursor	Atlassian di marketplace Cursor
Visual Studio Code (GitHub Copilot)	Dokumentasi VS Code MCP
GitHub Copilot CLI	Tentang Copilot CLI
Google Gemini CLI	Dokumentasi Gemini CLI MCP
Amazon Quick Suite	Panduan integrasi MCP

Atlassian Rovo MCP Server juga mendukung klien lokal yang kompatibel dengan MCP apa pun yang dapat berjalan di localhost dan terhubung ke server melalui proksi mcp-remote. Ini memungkinkan integrasi kustom atau pihak ketiga yang mengikuti spesifikasi MCP.

[!TIP] Untuk daftar kanonis terkini klien yang didukung dan penyiapan langkah demi langkah, lihat Memulai dengan Atlassian Rovo MCP Server. Anda juga dapat merujuk ke dokumentasi MCP klien Anda sendiri atau asisten bawaan.

Produk dan alat yang didukung

Alat diatur berdasarkan produk dan tujuan (baca, tulis, atau cari). Admin organisasi memberikan atau mencabut akses di tingkat grup izin, dan setiap alat mewarisi akses dari grup induknya.

Produk	Grup izin	OAuth 2.1	Token API
Jira	`read` · `write` · `search`	✅	✅
Confluence	`read` · `write` · `search`	✅	✅
Jira Service Management	`read` · `write`	—	✅ (hanya)
Bitbucket Cloud	`read` · `write`	—	✅ (terbatas, hanya)
Compass	`read` · `write`	✅ (hanya)	—
Platform Atlassian	`read_teamwork_graph` · `search_atlassian`	✅	✅

[!NOTE] Alat Jira Service Management dan Bitbucket Cloud tersedia hanya melalui autentikasi token API, sementara alat Compass tersedia hanya melalui OAuth 2.1. Untuk referensi alat terkini yang lengkap, lihat Alat yang didukung.

Sebelum Anda memulai

Periksa apakah lingkungan Anda memenuhi persyaratan ini sebelum Anda menyiapkan server.

Prasyarat

Persyaratannya bergantung pada cara Anda terhubung:

Untuk klien yang didukung

Situs Atlassian Cloud dengan satu atau lebih dari Jira, Confluence, Jira Service Management, Bitbucket, atau Compass
Akses ke klien pilihan
Peramban modern untuk menyelesaikan alur otorisasi OAuth 2.1, atau kredensial token API untuk autentikasi headless

Untuk IDE atau klien lokal (penyiapan desktop)

Situs Atlassian Cloud dengan satu atau lebih produk yang didukung
IDE yang didukung (misalnya, Claude Desktop, VS Code, atau Cursor) atau klien kustom yang kompatibel dengan MCP
Node.js v18+ terinstal untuk menjalankan proksi MCP lokal (mcp-remote)
Peramban modern untuk menyelesaikan login OAuth, atau kredensial token API untuk autentikasi headless

Data dan keamanan

Server menerapkan beberapa kontrol keamanan:

Semua lalu lintas dienkripsi saat transit melalui HTTPS (TLS 1.2 atau lebih baru), sesuai praktik keamanan Atlassian.
Autentikasi OAuth 2.1 dan token API menyediakan kontrol akses yang aman.
Akses data menghormati izin pengguna Jira, Confluence, Jira Service Management, Bitbucket, dan Compass.
Jika organisasi Anda menggunakan daftar izin IP untuk produk Atlassian Cloud, panggilan alat yang dilakukan melalui Atlassian Rovo MCP Server juga mematuhi aturan IP tersebut.

Untuk gambaran lebih mendalam tentang model keamanan dan kontrol admin, lihat:

Cara kerjanya

Arsitektur dan komunikasi

Klien yang didukung terhubung ke titik akhir server. Titik akhir yang direkomendasikan untuk sebagian besar klien adalah:
```
https://mcp.atlassian.com/v1/mcp/authv2
```
Titik akhir https://mcp.atlassian.com/v1/mcp juga didukung (misalnya, untuk konfigurasi token API).
Tergantung pada penyiapan Anda, alur OAuth 2.1 berbasis peramban yang aman dipicu, atau autentikasi token API digunakan.
Setelah diotorisasi, klien mengalirkan data kontekstual dan menerima respons real-time dari produk Atlassian Anda yang terhubung.

[!NOTE] Titik akhir Server-Sent Events lama (https://mcp.atlassian.com/v1/sse) masih didukung, tetapi kami menyarankan untuk memperbarui klien kustom apa pun yang dikonfigurasi untuk menggunakan /sse agar sekarang mengarah ke /mcp (atau /mcp/authv2).

Manajemen izin

Akses hanya diberikan ke data yang sudah diizinkan untuk dilihat oleh pengguna di Atlassian Cloud. Semua tindakan menghormati peran tingkat proyek atau ruang yang ada. Autentikasi OAuth dan token API keduanya mematuhi cakupan yang dikonfigurasi dan izin Atlassian.

Autentikasi token API (headless)

Autentikasi token API tersedia untuk penyiapan klien headless, gaya layanan, atau non-interaktif (misalnya, sistem backend atau otomatisasi). Ini juga diperlukan untuk alat Jira Service Management dan Bitbucket Cloud.

Pengaktifan admin diperlukan: Admin organisasi harus mengaktifkan autentikasi token API untuk Rovo MCP Server (Administrasi Atlassian → Rovo → Server Rovo MCP → Autentikasi).
Token terbatas diperlukan: Buat token API pribadi dengan cakupan yang diperlukan untuk alat dan data yang perlu Anda akses.
Panduan konfigurasi: Mengonfigurasi autentikasi melalui token API
Referensi pengaturan admin: Mengontrol pengaturan Atlassian Rovo MCP Server: Mengonfigurasi autentikasi

Contoh alur kerja

Setelah terhubung, Anda dapat menjalankan tugas seperti ini dari klien Anda.

Alur kerja Jira

Cari: "Temukan semua bug terbuka di Project Alpha."
Buat/perbarui: "Buat story berjudul 'Desain ulang onboarding'."
Buat massal: "Buat lima isu Jira dari catatan ini."

Alur kerja Confluence

Ringkas: "Ringkas halaman perencanaan Q2."
Buat: "Buat halaman berjudul 'Tujuan Tim Q3'."
Navigasi: "Ruang apa yang dapat saya akses?"

Alur kerja Compass

Buat: "Buat komponen layanan berdasarkan repositori saat ini."
Buat massal: "Impor komponen dan bidang kustom dari CSV/JSON ini."
Kueri: "Apa yang bergantung pada layanan api-gateway?"

Tugas gabungan

Tautkan konten: "Tautkan tiga tiket Jira ini ke halaman 'Rencana Rilis'."
Temukan dokumentasi: "Ambil halaman dokumentasi Confluence yang ditautkan ke komponen Compass ini."

[!NOTE] Kemampuan aktual bervariasi tergantung pada tingkat izin dan platform klien Anda.

Tips dan trik

Atur CloudId default, proyek Jira, dan ruang Confluence

Perbarui AGENTS.md Anda dengan Markdown di bawah ini untuk mengurangi panggilan alat penemuan, menghemat waktu dan token, serta mengatur hasil pencarian maksimum.

## 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.

Gunakan keterampilan

Jika Anda menggunakan klien desktop seperti Claude, Anda dapat membuat atau menggunakan kembali keterampilan untuk tugas berulang. Lihat keterampilan Rovo MCP default.

Untuk Cursor, keterampilan adalah bagian dari plugin marketplace.

Catatan admin: mengelola akses

Jika Anda seorang admin yang mempersiapkan organisasi Anda untuk menggunakan Atlassian Rovo MCP Server, tinjau poin-poin di bawah ini. Untuk panduan admin yang lebih rinci, lihat:

Instalasi dan akses

Bukan aplikasi Marketplace: Atlassian Rovo MCP Server tidak diinstal melalui Atlassian Marketplace atau layar Kelola aplikasi. Sebaliknya, server ini diinstal secara otomatis saat pertama kali pengguna menyelesaikan alur persetujuan OAuth 2.1 (3LO) (instalasi just-in-time, atau "pemuatan malas").
Persyaratan instalasi pertama kali: Pengguna pertama yang menyelesaikan alur persetujuan 3LO untuk situs Anda harus memiliki akses ke aplikasi Atlassian yang diminta oleh cakupan MCP (misalnya, Jira dan/atau Confluence). Ini memastikan aplikasi MCP terdaftar dengan izin yang benar untuk situs Anda.
Akses pengguna selanjutnya: Setelah instalasi awal, pengguna yang hanya memiliki akses ke satu aplikasi Atlassian (misalnya, hanya Jira atau hanya Confluence) juga dapat menyelesaikan alur 3LO untuk mengakses aplikasi tersebut melalui MCP.

Mengelola, memantau, dan mencabut akses

Kontrol admin: Admin situs dan organisasi dapat mengelola, meninjau, atau mencabut akses aplikasi MCP dari Kelola aplikasi Marketplace dan pihak ketiga organisasi Anda. Aplikasi ini muncul di daftar Aplikasi terhubung situs Anda setelah persetujuan 3LO pertama yang berhasil.
Kontrol domain: Gunakan halaman pengaturan Server Rovo MCP di Administrasi Atlassian untuk mengontrol alat AI eksternal dan domain mana yang diizinkan untuk terhubung. Secara default, domain yang didukung Atlassian diizinkan; Anda dapat menambahkan domain tepercaya atau memblokir yang didukung. Kontrol domain berlaku untuk koneksi OAuth 2.1. Untuk detailnya, lihat Domain server Atlassian Rovo MCP yang tersedia.
Kontrol IP: Jika organisasi Anda menggunakan daftar izin IP untuk aplikasi Atlassian Cloud, permintaan yang dibuat melalui Atlassian Rovo MCP Server harus berasal dari alamat IP yang diizinkan oleh daftar izin IP organisasi Anda untuk aplikasi yang relevan. Untuk detail konfigurasi, lihat Tentukan alamat IP untuk akses produk.
Kontrol pengguna akhir: Pengguna individu dapat mencabut otorisasi aplikasi mereka sendiri dari pengaturan profil mereka.
Pencatatan audit: Setiap kali alat digunakan melalui Atlassian Rovo MCP Server, sebuah peristiwa dicatat dalam log audit organisasi Anda. Admin dapat meninjaunya di Administrasi Atlassian di bawah Wawasan → Log audit (filter untuk Tindakan Pengguna Rovo MCP atau cari MCP). Untuk informasi lebih lanjut, lihat Memantau aktivitas server Atlassian Rovo MCP.

Memecahkan masalah umum

Kesalahan "Admin situs Anda harus mengotorisasi aplikasi ini": Seorang admin situs harus menyelesaikan alur persetujuan 3LO sebelum orang lain dapat menggunakan aplikasi MCP. Lihat Kesalahan "Admin situs Anda harus mengotorisasi aplikasi ini" di aplikasi Atlassian Cloud untuk detail lebih lanjut.
"Anda tidak memiliki izin untuk terhubung dari alamat IP ini. Silakan minta akses kepada admin Anda." Ini biasanya menunjukkan bahwa daftar izin IP diaktifkan dan alamat IP pengguna saat ini tidak diizinkan untuk mengakses Jira, Confluence, Jira Service Management, Bitbucket, atau Compass melalui Atlassian Rovo MCP Server. Mintalah admin situs atau organisasi Anda untuk meninjau konfigurasi daftar izin IP dan menambahkan rentang IP jaringan atau VPN yang relevan jika sesuai.
Aplikasi tidak muncul di Aplikasi terhubung: Pastikan pengguna menggunakan akun dan situs Atlassian yang benar, dan konfirmasikan bahwa aplikasi meminta cakupan aplikasi Atlassian yang benar (misalnya, cakupan Jira). Jika masalah berlanjut, periksa Kelola aplikasi Marketplace dan pihak ketiga organisasi Anda atau hubungi Dukungan Atlassian. Juga verifikasi izin produk pengguna di Administrasi Atlassian.

Keamanan

Model Context Protocol (MCP) memungkinkan agen AI terhubung ke alat dan data Atlassian menggunakan izin akun Anda, yang menciptakan alur kerja yang kuat tetapi juga risiko struktural. Setiap klien atau server MCP yang Anda aktifkan (misalnya, plugin IDE, aplikasi desktop, server MCP yang dihosting, atau integrasi "sekali klik") dapat menyebabkan agen AI melakukan tindakan atas nama Anda.

Model bahasa besar (LLM) rentan terhadap injeksi prompt dan serangan terkait (seperti injeksi prompt tidak langsung dan peracunan alat). Serangan ini dapat menginstruksikan agen untuk mengeksfiltrasi data atau membuat perubahan yang tidak diinginkan tanpa permintaan eksplisit.

Untuk mengurangi risiko, hanya gunakan klien dan server MCP tepercaya, tinjau dengan cermat alat dan data mana yang dapat diakses setiap agen, dan terapkan hak istimewa terendah (token terlingkup, akses proyek/ruang kerja minimal). Untuk tindakan berdampak tinggi atau destruktif, perlukan konfirmasi manusia dan pantau log audit untuk aktivitas yang tidak biasa. Kami sangat menyarankan untuk meninjau panduan Atlassian tentang risiko MCP di Klien MCP: Memahami potensi risiko keamanan.

Dukungan dan umpan balik

Kami menggunakan umpan balik Anda untuk meningkatkan Atlassian Rovo MCP Server. Jika Anda menemukan bug atau batasan, atau memiliki saran:

Kunjungi Portal Dukungan Atlassian untuk melaporkan masalah dan permintaan fitur.
Bagikan pengalaman dan pertanyaan Anda di Komunitas Atlassian, dan pertanyaan terkait pengembang di Komunitas Pengembang Atlassian.
Kunjungi Portal Pengembang Ekosistem kami jika Anda sedang membangun aplikasi dan menemukan bug atau masalah, atau memiliki saran.

Penyangkalan

Klien MCP dapat melakukan tindakan di Jira, Confluence, Jira Service Management, Bitbucket, dan Compass dengan izin Anda yang ada. Gunakan hak istimewa terendah, tinjau perubahan berdampak tinggi sebelum mengonfirmasi, dan pantau log audit untuk aktivitas yang tidak biasa.

Pelajari lebih lanjut: Klien MCP: Memahami potensi risiko keamanan.