Atlassian MCP Server

resmi

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

GitHub

Coba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Atlassian MCP?

Cari di seluruh produk Atlassian — Minta asisten Anda untuk menemukan isu Jira, halaman Confluence, atau konten Bitbucket menggunakan kueri bahasa alami.
Buat dan perbarui item kerja — Minta AI Anda membuat cerita Jira, memperbarui isu, atau membuat halaman Confluence dari instruksi Anda.
Pembuatan isu massal — Ubah catatan rapat atau spesifikasi menjadi beberapa tiket Jira sekaligus dengan satu permintaan.
Ringkas konten Confluence — Dapatkan ringkasan singkat dari halaman seperti dokumen perencanaan Q2 tanpa membuka Confluence.
Kueri komponen Compass — Tanyakan tentang dependensi layanan, seperti "Apa yang bergantung pada layanan api-gateway?"
Tautkan konten terkait — Hubungkan tiket Jira ke halaman Confluence, seperti menautkan tiga isu ke rencana rilis.

Dokumentasi

Atlassian

Atlassian Rovo MCP Server

Server Model Context Protocol (MCP) resmi untuk Atlassian: jembatan yang di-hosting 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, server ini memungkinkan alat-alat tersebut 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 yang sudah ada dari pengguna.

Dengan Atlassian Rovo MCP Server, Anda dapat:

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

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

Pengaturan satu klik

Pilih klien AI Anda di bawah 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
_{Rujuk isu dan catat pekerjaan di codebase Anda.}

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

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

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

Klien yang didukung

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

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

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

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

Kemasan plugin dan kompatibilitas

Repositori ini menerbitkan server MCP dan keterampilan yang sama dalam beberapa format paket sehingga klien dapat menggunakan alur penemuan dan instalasi asli mereka:

Format	Manifest dan konfigurasi	Komponen bersama
Agent Plugins v1	`plugin.json` dan `mcp.json`	`skills/`
Plugin Claude Code	`.claude-plugin/plugin.json` dan `.claude-plugin/marketplace.json`	`.mcp.json` dan `skills/`
Plugin Cursor	`.cursor-plugin/plugin.json`	`.mcp.json` dan `skills/`
Ekstensi Gemini	`gemini-extension.json`	Konfigurasi server MCP tertanam dalam manifest
MCP Registry	`server.json`	Metadata server jarak jauh

Baik mcp.json maupun .mcp.json disengaja. Agent Plugins memerlukan nama file mcp.json di root dan kosakata transport portabelnya; klien yang ada terus menggunakan .mcp.json dan kosakata konfigurasi asli mereka. Jaga agar pengaturan endpoint mereka tetap selaras saat mengubah salah satu file.

Paket root dapat diimpor oleh klien yang mengimplementasikan Agent Plugins, termasuk Kiro Powers. Manifest khusus klien tetap tersedia dan tidak digantikan oleh paket portabel.

Produk dan alat yang didukung

Alat diorganisir 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 lengkap dan terkini, lihat Alat yang didukung.

Sebelum Anda memulai

Periksa bahwa lingkungan Anda memenuhi persyaratan ini sebelum mengatur server.

Prasyarat

Persyaratan 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 Anda
Browser modern untuk menyelesaikan alur otorisasi OAuth 2.1, atau kredensial token API untuk autentikasi headless

Untuk IDE atau klien lokal (pengaturan desktop)

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

Data dan keamanan

Server memberlakukan beberapa kontrol keamanan:

Semua lalu lintas dienkripsi selama transmisi 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 allowlisting IP untuk produk Atlassian Cloud, panggilan alat yang dilakukan melalui Atlassian Rovo MCP Server juga menghormati aturan IP tersebut.

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

Cara kerjanya

Arsitektur dan komunikasi

Klien yang didukung terhubung ke endpoint server. Endpoint yang direkomendasikan untuk sebagian besar klien adalah:
```
https://mcp.atlassian.com/v1/mcp/authv2
```
Endpoint https://mcp.atlassian.com/v1/mcp juga didukung (misalnya, untuk konfigurasi token API).
Tergantung pada pengaturan Anda, alur OAuth 2.1 berbasis browser 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] Endpoint Server-Sent Events lama (https://mcp.atlassian.com/v1/sse) masih didukung, tetapi kami menyarankan untuk memperbarui klien khusus 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 pengguna di Atlassian Cloud. Semua tindakan menghormati peran tingkat proyek atau ruang yang ada. Autentikasi OAuth dan token API sama-sama menghormati cakupan yang dikonfigurasi dan izin Atlassian.

Autentikasi token API (headless)

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

Aktivasi 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: Konfigurasi autentikasi melalui token API
Referensi pengaturan admin: Mengontrol pengaturan Atlassian Rovo MCP Server: Konfigurasi autentikasi

Contoh alur kerja

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

Alur kerja Jira

Cari: "Temukan semua bug yang terbuka di Project Alpha."
Buat/perbarui: "Buat cerita berjudul 'Redesign onboarding'."
Buat massal: "Buat lima issue Jira dari catatan ini."

Alur kerja Confluence

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

Alur kerja Compass

Buat: "Buat komponen layanan berdasarkan repositori saat ini."
Buat massal: "Impor komponen dan kolom 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 tertaut ke komponen Compass ini."

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

Tips dan trik

Tetapkan 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 menetapkan 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 yang berulang. Lihat keterampilan Rovo MCP default.

Untuk Cursor, keterampilan adalah bagian dari plugin marketplace.

Catatan admin: mengelola akses

Jika Anda seorang admin yang menyiapkan organisasi Anda untuk menggunakan Atlassian Rovo MCP Server, tinjau poin-poin di bawah ini. Untuk panduan admin yang lebih terperinci, 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 "lazy loading").
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 berikutnya: Setelah instalasi awal, pengguna dengan akses hanya ke satu aplikasi Atlassian (misalnya, hanya Jira atau hanya Confluence) juga dapat menyelesaikan alur 3LO untuk mengakses aplikasi tersebut melalui MCP.

Kelola, pantau, dan cabut 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 muncul di daftar Aplikasi terhubung situs Anda setelah persetujuan 3LO pertama yang berhasil.
Kontrol domain: Gunakan halaman pengaturan server Rovo MCP di Atlassian Administration untuk mengontrol alat AI eksternal dan domain mana yang diizinkan terhubung. Secara default, domain yang didukung Atlassian diizinkan; Anda dapat menambahkan domain tepercaya atau memblokir domain 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 Atlassian Administration di bawah Insights → Log audit (filter untuk Tindakan Pengguna Rovo MCP atau cari MCP). Untuk informasi lebih lanjut, lihat Pantau aktivitas server Atlassian Rovo MCP.

Pemecahan masalah umum

Kesalahan "Admin situs Anda harus mengotorisasi aplikasi ini": 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 admin Anda untuk akses." 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. Minta 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 Atlassian Administration.

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. Klien atau server MCP apa pun yang Anda aktifkan (misalnya, plugin IDE, aplikasi desktop, server MCP yang dihosting, atau integrasi "satu 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 keracunan alat). Serangan ini dapat menginstruksikan agen untuk mengeksfiltrasi data atau membuat perubahan yang tidak disengaja tanpa permintaan eksplisit.

Untuk mengurangi risiko, hanya gunakan klien dan server MCP tepercaya, tinjau dengan cermat alat dan data apa yang dapat diakses setiap agen, dan terapkan hak akses paling rendah (token dengan cakupan terbatas, akses proyek/ruang kerja minimal). Untuk tindakan berdampak tinggi atau destruktif, minta 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 risiko keamanan potensial.

Dukungan dan umpan balik

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

Kunjungi Portal Dukungan Atlassian untuk melaporkan masalah dan permintaan fitur.
Bagikan pengalaman dan pertanyaan Anda di Komunitas Atlassian, dan ajukan pertanyaan terkait pengembang di Komunitas Pengembang Atlassian.
Kunjungi Portal Pengembang Ekosistem kami jika Anda 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 akses paling rendah, tinjau perubahan berdampak tinggi sebelum mengonfirmasi, dan pantau log audit untuk aktivitas yang tidak biasa.

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