MCP Atlassian

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

Progressives Fork-Profil

Dieser Fork behält die direkte Atlassian-MCP-Oberfläche des Upstreams bei und fügt ein lokales progressives Profil hinzu, das über MCP_PROFILE=progressive gesteuert wird. Im progressiven Modus stellt der Server nur Discovery-/Schema-/Ausführungs-Wrapper wie jira_discover, jira_capability_schema, jira_execute_read und jira_execute_write_guarded bereit, anstatt der vollständigen direkten Tool-Oberfläche.

Das Upstream-sooperset/mcp-atlassian enthält diese progressive Schicht derzeit nicht, daher müssen Upstream-Updates selektiv abgeglichen werden. Führen Sie keine blinden Upstream-Merges durch, da sonst das progressive Paket/die Tests entfernt werden können. Siehe FORK_WORKFLOW.md.

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

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

Related MCP server: MCP Atlassian

Schnellstart

1. API-Token abrufen

Gehen Sie zu https://id.atlassian.com/manage-profile/security/api-tokens und erstellen Sie ein Token.

Verwenden Sie für Server/Data Center stattdessen ein persönliches Zugriffstoken. Siehe Authentifizierung.

2. Konfigurieren Sie Ihre IDE

Fügen Sie Folgendes zu Ihrer Claude-Desktop- oder Cursor-MCP-Konfiguration hinzu:

{
  "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-Benutzer: Verwenden Sie JIRA_PERSONAL_TOKEN anstelle von JIRA_USERNAME + JIRA_API_TOKEN. Details finden Sie unter Authentifizierung.

Autohand Code

Verwenden Sie denselben uvx-Server mit Ihren Atlassian-Anmeldeinformationen:

autohand mcp add 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 \
  uvx mcp-atlassian

Fügen Sie nach add --scope project hinzu, um die Konfiguration im aktuellen Projekt zu behalten. Aktuelle Installations- und CLI-Details finden Sie unter Autohand Code.

3. Loslegen

Bitten Sie Ihren KI-Assistenten:

• "Finde Issues, die mir im PROJ-Projekt zugewiesen sind"

• "Suche in Confluence nach Onboarding-Dokumenten"

• "Erstelle ein Bug-Ticket für das Login-Problem"

• "Aktualisiere den Status von PROJ-123 auf Done"

Dokumentation

Die vollständige Dokumentation ist unter mcp-atlassian.soomiles.com verfügbar.

Die Dokumentation ist auch im llms.txt-Format verfügbar, das LLMs leicht verarbeiten können:

• llms.txt — Dokumentations-Sitemap

• llms-full.txt — vollständige Dokumentation

Kompatibilität

Wichtige Tools

Insgesamt 98 Tools — Siehe Tools-Referenz für die vollständige Liste.

Sicherheit

Geben Sie API-Tokens niemals weiter. Halten Sie .env-Dateien sicher. Siehe SECURITY.md.

Mitwirken

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung.

Lizenz

MIT - Siehe LICENSE. Kein offizielles Atlassian-Produkt.