MCP Atlassian

Model Context Protocol (MCP)-Server für Atlassian-Produkte (Confluence und Jira). Diese Integration unterstützt sowohl Confluence & Jira Cloud- als auch Server-/Data Center-Bereitstellungen.

Beispielverwendung

Bitten Sie Ihren KI-Assistenten:

📝 Automatische Jira-Updates – „Aktualisieren Sie Jira aus unseren Besprechungsnotizen“
🔍 KI-gestützte Confluence-Suche – „Finden Sie unseren OKR-Leitfaden in Confluence und fassen Sie ihn zusammen“
🐛 Intelligente Jira-Problemfilterung – „Zeigen Sie mir dringende Fehler im PROJ-Projekt von letzter Woche“
📄 Inhaltserstellung und -verwaltung – „Erstellen Sie ein technisches Designdokument für die Funktion XYZ“

Funktionsdemo

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

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

Kompatibilität

Produkt	Bereitstellungstyp	Support-Status
Zusammenfluss	Wolke	✅ Vollständig unterstützt
Zusammenfluss	Server/Rechenzentrum	✅ Unterstützt (Version 6.0+)
Jira	Wolke	✅ Vollständig unterstützt
Jira	Server/Rechenzentrum	✅ Unterstützt (Version 8.14+)

Kurzanleitung

1. Authentifizierungs-Setup

MCP Atlassian unterstützt drei Authentifizierungsmethoden:

A. API-Token-Authentifizierung (Cloud)

Gehen Sie zu https://id.atlassian.com/manage-profile/security/api-tokens
Klicken Sie auf API-Token erstellen und benennen Sie es
Kopieren Sie das Token sofort

B. Persönlicher Zugriffstoken (Server/Rechenzentrum)

Gehen Sie zu Ihrem Profil (Avatar) → Profil → Persönliche Zugriffstoken
Klicken Sie auf „Token erstellen“ , benennen Sie es und legen Sie das Ablaufdatum fest
Kopieren Sie das Token sofort

C. OAuth 2.0-Authentifizierung (nur Cloud)

Erstellen Sie eine OAuth 2.0-Integration in Atlassian:
- Gehen Sie zu https://developer.atlassian.com/console/myapps/
- Klicken Sie auf „Erstellen“ und wählen Sie „OAuth 2.0-Integration“
- Folgen Sie dem Assistenten, um Ihre App zu erstellen
- Konfigurieren Sie nach Bedarf Berechtigungen für Jira und Confluence
- Fügen Sie eine Rückruf-URL hinzu (z. B. http://localhost:8080/callback )
Führen Sie den OAuth-Autorisierungshelfer aus:
uvx mcp-atlassian@latest --oauth-setup
Dies führt Sie durch den Einrichtungsprozess, indem es Sie zur Eingabe der erforderlichen Werte (Client-ID, Client-Geheimnis usw.) auffordert.Alternativ können Sie das Repository klonen und das Skript direkt ausführen:
# Clone the repository if you haven't already git clone https://github.com/sooperset/mcp-atlassian.git cd mcp-atlassian # Run the OAuth authorization script python scripts/oauth_authorize.py \ --client-id YOUR_CLIENT_ID \ --client-secret YOUR_CLIENT_SECRET \ --redirect-uri "http://localhost:8080/callback" \ --scope "read:jira-work write:jira-work read:confluence-space.summary write:confluence-content"
Folgen Sie der Browser-Eingabeaufforderung, um die Anwendung zu autorisieren
Nach erfolgreicher Autorisierung fügen Sie die angezeigten Umgebungsvariablen zu Ihrer .env-Datei hinzu

2. Installation

MCP Atlassian wird als Docker-Image bereitgestellt. Dies ist die empfohlene Ausführungsmethode für den Server, insbesondere für die IDE-Integration. Stellen Sie sicher, dass Docker installiert ist.

# Pull Pre-built Image
docker pull ghcr.io/sooperset/mcp-atlassian:latest

IDE-Integration

MCP Atlassian ist für die Verwendung mit KI-Assistenten durch IDE-Integration konzipiert.

[!TIP] Für Claude Desktop : Suchen und bearbeiten Sie die Konfigurationsdatei direkt:
Windows : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json
Für Cursor : Öffnen Sie Einstellungen → MCP → + Neuen globalen MCP-Server hinzufügen

Konfigurationsmethoden

Es gibt zwei Hauptansätze zum Konfigurieren des Docker-Containers:

Direktes Übergeben von Variablen (siehe Beispiele unten)
Verwenden einer Umgebungsdatei mit dem Flag --env-file (in einklappbaren Abschnitten angezeigt)

[!NOTE] Zu den gängigen Umgebungsvariablen gehören:
CONFLUENCE_SPACES_FILTER : Filtern nach Space-Schlüsseln (z. B. „DEV, TEAM, DOC“)
JIRA_PROJECTS_FILTER : Filtern nach Projektschlüsseln (z. B. „PROJ,DEV,SUPPORT“)
READ_ONLY_MODE : Auf „true“ setzen, um Schreibvorgänge zu deaktivieren
MCP_VERBOSE : Auf „true“ setzen für detailliertere Protokollierung
ENABLED_TOOLS : Kommagetrennte Liste der zu aktivierenden Toolnamen (z. B. „confluence_search,jira_get_issue“)
Alle verfügbaren Optionen finden Sie in der Datei .env.example .

Konfigurationsbeispiele

Methode 1 (Direkte Übergabe von Variablen):

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--env-file",
        "/path/to/your/mcp-atlassian.env",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ]
    }
  }
}

Verwenden Sie für Server-/Data-Center-Bereitstellungen die direkte Variablenübergabe:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_PERSONAL_TOKEN",
        "-e", "CONFLUENCE_SSL_VERIFY",
        "-e", "JIRA_URL",
        "-e", "JIRA_PERSONAL_TOKEN",
        "-e", "JIRA_SSL_VERIFY",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_confluence_pat",
        "CONFLUENCE_SSL_VERIFY": "false",
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_jira_pat",
        "JIRA_SSL_VERIFY": "false"
      }
    }
  }
}

[!NOTE] Setzen Sie CONFLUENCE_SSL_VERIFY und JIRA_SSL_VERIFY nur dann auf „false“, wenn Sie über selbstsignierte Zertifikate verfügen.

Für Atlassian Cloud mit OAuth 2.0:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "JIRA_URL",
        "-e", "ATLASSIAN_OAUTH_CLIENT_ID",
        "-e", "ATLASSIAN_OAUTH_CLIENT_SECRET",
        "-e", "ATLASSIAN_OAUTH_REDIRECT_URI",
        "-e", "ATLASSIAN_OAUTH_SCOPE",
        "-e", "ATLASSIAN_OAUTH_CLOUD_ID",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_URL": "https://your-company.atlassian.net",
        "ATLASSIAN_OAUTH_CLIENT_ID": "your_client_id",
        "ATLASSIAN_OAUTH_CLIENT_SECRET": "your_client_secret",
        "ATLASSIAN_OAUTH_REDIRECT_URI": "http://localhost:8080/callback",
        "ATLASSIAN_OAUTH_SCOPE": "read:jira-work write:jira-work read:confluence-space.summary write:confluence-content",
        "ATLASSIAN_OAUTH_CLOUD_ID": "your_cloud_id"
      }
    }
  }
}

[!TIP] Führen Sie das Skript scripts/oauth_authorize.py aus, um Ihr Zugriffstoken und Ihre Cloud-ID abzurufen. Die OAuth 2.0-Authentifizierung hat Vorrang vor anderen Authentifizierungsmethoden, sofern konfiguriert.

MCP Atlassian unterstützt das Routing von API-Anfragen über Standard-HTTP/HTTPS/SOCKS-Proxys. Konfigurieren Sie mithilfe von Umgebungsvariablen:

Unterstützt Standard HTTP_PROXY , HTTPS_PROXY , NO_PROXY , SOCKS_PROXY .
Es sind dienstspezifische Überschreibungen verfügbar (z. B. JIRA_HTTPS_PROXY , CONFLUENCE_NO_PROXY ).
Dienstspezifische Variablen überschreiben globale Variablen für diesen Dienst.

Fügen Sie die relevanten Proxy-Variablen zu den Abschnitten args (mit -e ) und env Ihrer MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "... existing Confluence/Jira vars",
        "-e", "HTTP_PROXY",
        "-e", "HTTPS_PROXY",
        "-e", "NO_PROXY",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "... existing Confluence/Jira vars": "...",
        "HTTP_PROXY": "http://proxy.internal:8080",
        "HTTPS_PROXY": "http://proxy.internal:8080",
        "NO_PROXY": "localhost,.your-company.com"
      }
    }
  }
}

Anmeldeinformationen in Proxy-URLs werden in Protokollen maskiert. Wenn Sie NO_PROXY festlegen, wird dies bei Anfragen an übereinstimmende Hosts berücksichtigt.

Nur für Confluence Cloud:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Verwenden Sie für Confluence Server/DC:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_PERSONAL_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://confluence.your-company.com",
        "CONFLUENCE_PERSONAL_TOKEN": "your_personal_token"
      }
    }
  }
}

Nur für Jira Cloud:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token"
      }
    }
  }
}

Verwenden Sie für Jira Server/DC:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "JIRA_URL",
        "-e", "JIRA_PERSONAL_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "JIRA_URL": "https://jira.your-company.com",
        "JIRA_PERSONAL_TOKEN": "your_personal_token"
      }
    }
  }
}

SSE-Transportkonfiguration

Starten Sie den Server manuell in einem Terminal:
docker run --rm -p 9000:9000 \ --env-file /path/to/your/.env \ ghcr.io/sooperset/mcp-atlassian:latest \ --transport sse --port 9000 -vv
Konfigurieren Sie Ihre IDE so, dass sie über die URL eine Verbindung zum laufenden Server herstellt:
{ "mcpServers": { "mcp-atlassian-sse": { "url": "http://localhost:9000/sse" } } }

Werkzeuge

Wichtige Werkzeuge

Confluence-Tools

confluence_search : Durchsuchen Sie Confluence-Inhalte mit CQL
confluence_get_page : Inhalt einer bestimmten Seite abrufen
confluence_create_page : Eine neue Seite erstellen
confluence_update_page : Eine vorhandene Seite aktualisieren

Jira-Tools

jira_get_issue : Details zu einem bestimmten Problem abrufen
jira_search : Probleme mit JQL suchen
jira_create_issue : Ein neues Problem erstellen
jira_update_issue : Ein bestehendes Problem aktualisieren
jira_transition_issue : Überführen eines Problems in einen neuen Status
jira_add_comment : Einen Kommentar zu einem Problem hinzufügen

Mit * gekennzeichnete Tools sind nur in Jira Cloud verfügbar.

Confluence-Tools	Jira-Tools
`confluence_search`	`jira_get_issue`
`confluence_get_page`	`jira_search`
`confluence_get_page_children`	`jira_get_project_issues`
`confluence_get_comments`	`jira_create_issue`
`confluence_create_page`	`jira_batch_create_issues`
`confluence_update_page`	`jira_update_issue`
`confluence_delete_page`	`jira_delete_issue`
`confluence_get_labels`	`jira_get_transitions`
`confluence_add_label`	`jira_transition_issue`
	`jira_add_comment`
	`jira_add_worklog`
	`jira_get_worklog`
	`jira_batch_get_changelogs` *
	`jira_download_attachments`
	`jira_link_to_epic`
	`jira_get_agile_boards`
	`jira_get_board_issues`
	`jira_get_sprints_from_board`
	`jira_get_sprint_issues`
	`jira_create_sprint`
	`jira_update_sprint`
	`jira_get_issue_link_types`
	`jira_create_issue_link`
	`jira_remove_issue_link`

Werkzeugfilterung und Zugriffskontrolle

Der Server bietet zwei Möglichkeiten zur Steuerung des Toolzugriffs:

Werkzeugfilterung : Verwenden Sie das Flag --enabled-tools oder die Umgebungsvariable ENABLED_TOOLS , um anzugeben, welche Werkzeuge verfügbar sein sollen:
# Via environment variable ENABLED_TOOLS="confluence_search,jira_get_issue,jira_search" # Or via command line flag docker run ... --enabled-tools "confluence_search,jira_get_issue,jira_search" ...
Lese-/Schreibsteuerung : Tools werden als Lese- oder Schreibvorgänge kategorisiert. Wenn READ_ONLY_MODE aktiviert ist, sind unabhängig von der Einstellung ENABLED_TOOLS nur Lesevorgänge verfügbar.

Fehlerbehebung und Debugging

Häufige Probleme

Authentifizierungsfehler :
- Für die Cloud: Überprüfen Sie Ihre API-Token (nicht Ihr Kontopasswort)
- Für Server/Rechenzentrum: Überprüfen Sie, ob Ihr persönliches Zugriffstoken gültig und nicht abgelaufen ist
- Für ältere Confluence-Server: Einige ältere Versionen erfordern eine grundlegende Authentifizierung mit CONFLUENCE_USERNAME und CONFLUENCE_API_TOKEN (wobei Token Ihr Passwort ist).
Probleme mit SSL-Zertifikaten : Wenn Sie Server/Data Center verwenden und SSL-Fehler auftreten, setzen Sie CONFLUENCE_SSL_VERIFY=false oder JIRA_SSL_VERIFY=false
Berechtigungsfehler : Stellen Sie sicher, dass Ihr Atlassian-Konto über ausreichende Berechtigungen für den Zugriff auf die Bereiche/Projekte verfügt

Debugging-Tools

# Using MCP Inspector for testing
npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version
npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs
# macOS
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# Windows
type %APPDATA%\Claude\logs\mcp*.log | more

Sicherheit

Geben Sie niemals API-Token weiter
Halten Sie .env-Dateien sicher und privat
Best Practices finden Sie unter SECURITY.md

Beitragen

Wir freuen uns über Beiträge zu MCP Atlassian! Wenn Sie mitmachen möchten:

Ausführliche Anweisungen zur Einrichtung der Entwicklung finden Sie in unserem CONTRIBUTING.md- Handbuch.
Nehmen Sie Änderungen vor und senden Sie eine Pull-Anfrage.

Wir verwenden Pre-Commit-Hooks für die Codequalität und folgen der semantischen Versionierung für Releases.

Lizenz

Lizenziert unter MIT (siehe LICENSE- Datei). Dies ist kein offizielles Atlassian-Produkt.

MCP Atlassian

Integrations

MCP Atlassian

Beispielverwendung

Funktionsdemo

Kompatibilität

Kurzanleitung

1. Authentifizierungs-Setup

A. API-Token-Authentifizierung (Cloud)

B. Persönlicher Zugriffstoken (Server/Rechenzentrum)

C. OAuth 2.0-Authentifizierung (nur Cloud)

2. Installation

IDE-Integration

Konfigurationsmethoden

Konfigurationsbeispiele

SSE-Transportkonfiguration

Werkzeuge

Wichtige Werkzeuge

Confluence-Tools

Jira-Tools

Werkzeugfilterung und Zugriffskontrolle

Fehlerbehebung und Debugging

Häufige Probleme

Debugging-Tools

Sicherheit

Beitragen

Lizenz

Tools

Related MCP Servers

Vercel MCP Server

MCP Atlassian

JIRA MCP Tools

MCP Atlassian

Appeared in Searches

New MCP Servers