MCP Atlassian

Model Context Protocol (MCP) sunucusu Atlassian ürünleri için (Confluence ve Jira). Hem Cloud hem de Server/Data Center dağıtımlarını destekler.

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

Confluence Demo

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

Hızlı Başlangıç

1. API Token'ınızı Alın

https://id.atlassian.com/manage-profile/security/api-tokens adresine gidip bir token oluşturun.

Server/Data Center için bunun yerine Personal Access Token kullanın. Bkz. Authentication.

2. IDE'nizi Yapılandırın

Claude Desktop veya Cursor MCP yapılandırmanıza ekleyin:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Server/Data Center kullanıcıları: JIRA_USERNAME + JIRA_API_TOKEN yerine JIRA_PERSONAL_TOKEN kullanın. Ayrıntılar için Authentication sayfasına bakın.

3. Kullanmaya Başlayın

AI asistanınızdan şunları isteyin:

• "PROJ projesinde bana atanmış sorunları bul"
• "Confluence'da onboarding dokümanlarını ara"
• "Login sorunu için bir bug ticket oluştur"
• "PROJ-123'ün durumunu Done olarak güncelle"

Dokumentasyon

Tam dokumentasyon mcp-atlassian.soomiles.com adresinde mevcuttur.

Dokumentasyon llms.txt formatında da bulunmaktadır; LLM'ler bunu kolayca tüketebilir:

• llms.txt — dokumentasyon site haritası
• llms-full.txt — tam dokumentasyon

Konu	Açıklama
Installation	uvx, Docker, pip, kaynaktan
Authentication	API token'ları, PAT, OAuth 2.0
Configuration	IDE kurulumu, ortam değişkenleri
HTTP Transport	SSE, streamable-http, çok kullanıcılı
Tools Reference	Tüm Jira ve Confluence araçları
Troubleshooting	Yaygın sorunlar ve hata ayıklama

Uyumluluk

Ürün	Dağıtım	Destek
Confluence	Cloud	Tam destekleniyor
Confluence	Server/Data Center	Destekleniyor (v6.0+)
Jira	Cloud	Tam destekleniyor
Jira	Server/Data Center	Destekleniyor (v8.14+)

Ana Araçlar

Jira	Confluence
jira_search - JQL ile ara	confluence_search - CQL ile ara
jira_get_issue - Sorun detaylarını al	confluence_get_page - Sayfa içeriğini al
jira_create_issue - Sorun oluştur	confluence_create_page - Sayfa oluştur
jira_update_issue - Sorunları güncelle	confluence_update_page - Sayfaları güncelle
jira_transition_issue - Durumu değiştir	confluence_add_comment - Yorum ekle

Toplam 72 araç — Tam liste için Tools Reference sayfasına bakın.

Güvenlik

API token'larını asla paylaşmayın. .env dosyalarını güvende tutun. Bkz. SECURITY.md.

Katkı Sağlama

Geliştirme kurulumu için CONTRIBUTING.md sayfasına bakın.

Lisans

MIT - Bkz. LICENSE. Resmi Atlassian ürünü değildir.