Serwer Atlassian Rovo MCP -- szczegółowy przewodnik

Pracujesz nad implementacją funkcji od trzech godzin, gdy okazuje się, że strona Confluence powiązana ze zgłoszeniem Jira została zaktualizowana od czasu, gdy ostatnio ją czytałeś. Kryteria akceptacji się zmieniły. Kontrakt API w dokumencie architektury został zrewidowany. Budowałeś w oparciu o nieaktualne wymagania i teraz połowa implementacji wymaga przerobienia. Gdyby tylko twoje AI przeczytało aktualne dokumenty przed rozpoczęciem kodowania.

Serwer Atlassian Rovo MCP daje twojemu AI bezpośredni dostęp do zgłoszeń Jira, stron Confluence i komponentów Compass przez jeden zdalny endpoint MCP. AI odczytuje bieżące zgłoszenie, pobiera powiązaną dokumentację i pracuje z najnowszą wersją każdego wymagania — bez ręcznego przełączania kontekstu.

Czego się nauczysz

• Pełna konfiguracja serwera Atlassian Rovo MCP z uwierzytelnianiem OAuth 2.1
• Prompty do pracy opartej na zgłoszeniach, wyszukiwania dokumentacji i przepływów między narzędziami
• Zrozumienie dostępnych narzędzi: zgłoszenia Jira, strony Confluence, komponenty Compass
• Rozwiązywanie problemów z przepływem OAuth, błędami uprawnień i wymaganiami administratora witryny

Jak działa Rovo MCP

W przeciwieństwie do większości serwerów MCP, które działają lokalnie na twoim komputerze, serwer Atlassian MCP jest serwerem zdalnym hostowanym przez Atlassian pod adresem https://mcp.atlassian.com/v1/mcp. Uwierzytelnianie odbywa się przez OAuth 2.1 — przy pierwszym połączeniu otwiera się okno przeglądarki, w którym autoryzujesz dostęp do swojej witryny Atlassian. Po autoryzacji klient MCP zapisuje twoje poświadczenia w pamięci podręcznej.

Serwer udostępnia narzędzia dla trzech produktów Atlassian:

Produkt	Możliwości
Jira	Wyszukiwanie zgłoszeń za pomocą JQL, odczyt szczegółów zgłoszeń, tworzenie zgłoszeń, aktualizacja statusu, dodawanie komentarzy, zarządzanie sprintami
Confluence	Wyszukiwanie stron, odczyt zawartości stron, tworzenie stron, aktualizacja istniejących stron
Compass	Przeglądanie komponentów, odczyt metadanych komponentów, zrozumienie zależności między usługami

Konfiguracja

Cursor

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/mcp"]
    }
  }
}

Gdy Cursor po raz pierwszy się połączy, otwiera się karta przeglądarki z autoryzacją OAuth. Wybierz swoją witrynę Atlassian, przyznaj żądane uprawnienia, a połączenie zostanie zakończone automatycznie.

Claude Code

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.atlassian.com/v1/mcp"]
    }
  }
}

Dodaj to do .claude/settings.json lub użyj CLI:

claude mcp add atlassian -- npx -y mcp-remote https://mcp.atlassian.com/v1/mcp

Przepływ OAuth otwiera się w domyślnej przeglądarce przy pierwszym użyciu.

Codex

[mcp.atlassian]
transport = "http"
url = "https://mcp.atlassian.com/v1/mcp"

Notatka

Pierwszy użytkownik w twojej witrynie Atlassian musi mieć dostęp zarówno do Jira, jak i Confluence, aby ukończyć początkową zgodę OAuth. Jeśli widzisz komunikat “Your site admin must authorize this app”, poproś administratora Atlassian o przeprowadzenie pierwszej autoryzacji.

Przepływy pracy z Jira

Czytanie i zrozumienie zgłoszeń

Najbardziej bezpośrednią wartością jest pozwolenie AI na odczytanie pełnego kontekstu zgłoszenia przed rozpoczęciem kodowania. Koniec z przełączaniem się do przeglądarki, żeby ponownie przeczytać wymagania.

Wskazówka

Gotowy prompt do implementacji opartej na zgłoszeniach:

“Search Jira for ticket PLATFORM-1234. Read its description, acceptance criteria, and any linked issues. Also fetch any Confluence pages linked in the ticket. Based on all of this context, outline the implementation approach and identify any ambiguities I should clarify with the PM before coding.”

Tworzenie i aktualizowanie zgłoszeń

AI może również zapisywać dane w Jira — tworzyć raporty błędów z analizy kodu, aktualizować status zgłoszeń podczas pracy lub dodawać notatki z implementacji jako komentarze.

Wskazówka

Gotowy prompt do automatycznego raportowania błędów:

“I just found a race condition in src/lib/auth/session.ts where two concurrent requests can invalidate each other’s sessions. Create a Jira bug ticket in the AUTH project with priority High. Include the file path, line numbers, a description of the race condition, steps to reproduce, and a suggested fix. Assign it to me.”

Zarządzanie sprintami

Wskazówka

Gotowy prompt do analizy sprintu:

“Search Jira for all issues in the current sprint of the PLATFORM project. Group them by status (To Do, In Progress, In Review, Done). For any ticket that has been In Progress for more than 3 days, read its description and comments to identify potential blockers. Summarize the sprint health.”

Przepływy pracy z Confluence

Wyszukiwanie dokumentacji

Wyszukiwanie Confluence przez MCP jest szybsze niż korzystanie z interfejsu webowego Confluence, ponieważ AI przetwarza wyniki natychmiast, zamiast wymagać od ciebie klikania i czytania każdej strony.

Wskazówka

Gotowy prompt do badania architektury:

“Search Confluence for pages related to our payment processing architecture. Read the top 3 most relevant results. Summarize the current architecture, identify any recent changes, and note any documented decisions about error handling in the payment flow.”

Tworzenie dokumentacji

AI może również tworzyć strony Confluence — przydatne do generowania ADR-ów, runbooków lub specyfikacji technicznych na podstawie analizy kodu.

Wskazówka

Gotowy prompt do generowania dokumentacji:

“Analyze the database migration files in src/db/migrations/ from the last month. Create a Confluence page in the Engineering space titled ‘Database Schema Changes - February 2026’ that documents each migration: what changed, why (based on commit messages and linked tickets), and any breaking changes for downstream services.”

Integracja z Compass

Jeśli twoja organizacja korzysta z Atlassian Compass do zarządzania katalogiem usług, serwer MCP może odczytywać metadane komponentów, informacje o właścicielach i mapy zależności.

Jest to szczególnie przydatne przy pracy nad mikroserwisem, gdy potrzebujesz zrozumieć, jakie inne usługi od niego zależą, kto jest ich właścicielem i jakie mają SLA.

Łączenie Atlassian MCP z innymi serwerami

Najlepsze przepływy pracy łączą Atlassian MCP z kontrolą wersji:

1. Przeczytaj zgłoszenie. AI pobiera zgłoszenie Jira, jego kryteria akceptacji i wszelkie powiązane dokumenty Confluence.
2. Utwórz gałąź. Za pomocą GitHub MCP, AI tworzy gałąź nazwaną po ID zgłoszenia (np. feature/PLATFORM-1234).
3. Zaimplementuj zmianę. AI pisze kod oparty na faktycznych wymaganiach zgłoszenia — nie na sparafrazowanym streszczeniu.
4. Otwórz PR. Za pomocą GitHub MCP, AI tworzy pull request, który odwołuje się do zgłoszenia Jira w opisie.
5. Zaktualizuj zgłoszenie. AI przenosi zgłoszenie Jira do statusu “In Review” i dodaje komentarz z linkiem do PR.

Kiedy coś się psuje

Przepływ OAuth nigdy się nie kończy. Zdalny proxy MCP przekierowuje na localhost w celu wywołania zwrotnego OAuth. Jeśli korzystasz z VPN lub korporacyjnego proxy, które blokuje wywołania zwrotne localhost, przepływ będzie wisieć w nieskończoność. Tymczasowo odłącz się od VPN, zakończ przepływ OAuth, a następnie połącz ponownie. Zapisane poświadczenia przetrwają ponowne połączenia VPN.

Błąd “Your site admin must authorize this app”. Ten komunikat pojawia się, gdy żaden administrator w twojej witrynie Atlassian nie przeprowadził początkowej zgody OAuth. Pierwsza autoryzacja musi zostać wykonana przez użytkownika z dostępem na poziomie administratora zarówno do Jira, jak i Confluence. Po tym zwykli użytkownicy mogą autoryzować się normalnie.

AI nie może znaleźć zgłoszenia. AI wyszukuje za pomocą JQL, które wymaga klucza projektu, a nie nazwy projektu. “Find bugs in PLATFORM” działa, ponieważ PLATFORM to klucz projektu. “Find bugs in Platform Engineering” nie zadziała, ponieważ to jest nazwa projektu.

Odmowa uprawnień przy aktualizacjach. Serwer MCP respektuje twoje uprawnienia Atlassian. Jeśli nie możesz edytować zgłoszenia w interfejsie webowym Jira, AI również nie może go edytować przez MCP. To jest funkcja, nie błąd.

Nieaktualne tokeny OAuth. Jeśli połączenie działało wczoraj, ale dzisiaj zawodzi, twój token OAuth mógł wygasnąć. Usuń i ponownie dodaj serwer MCP, aby uruchomić nowy przepływ OAuth.

Co dalej

MCP do zarządzania projektami Szersza integracja zarządzania projektami, w tym Linear.

MCP do kontroli wersji Integracja z GitHub i GitLab, aby zamknąć pętlę od zgłoszenia do PR.