Atlassian MCP

Ein benutzerdefinierter Model Context Protocol-Server, der KI-Agenten die Interaktion mit Jira und Confluence in der Atlassian Cloud ermöglicht. Er führt im Hintergrund einfache REST-Aufrufe über die Jira REST API v3 und die Confluence REST API v2 aus.

Einrichtung

1. Abhängigkeiten installieren und bauen:

   npm install
   npm run build

2. Den Server als globalen Befehl bereitstellen, damit er aus jedem Arbeitsbereich gestartet werden kann (verwendet den bin-Eintrag in package.json):

   npm link

   Dadurch wird ein atlassian-mcp-Befehl in deinen PATH aufgenommen. Führe npm run build nach Codeänderungen erneut aus; der verknüpfte Befehl zeigt immer auf das aktuelle dist.

3. Erstelle einen API-Token unter https://id.atlassian.com/manage-profile/security/api-tokens.

4. Gib Anmeldedaten über Umgebungsvariablen an (siehe .env.example):

Related MCP server: jira-mcp

Einen Client verbinden

VS Code (empfohlen)

Dieses Repository enthält eine standardmäßige .vscode/mcp.json. Es startet den Server über eine interaktive Login-zsh-Shell (zsh -lic), sodass er die Atlassian-Anmeldedaten erbt, die in deiner ~/.zshrc (oder ~/.zshenv) exportiert sind — keine Geheimnisse in der Konfiguration — und ruft den global verknüpften Befehl atlassian-mcp auf, sodass er funktioniert, unabhängig davon, welches Repository gerade geöffnet ist:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec atlassian-mcp"]
    }
  }
}

Vermeide hier ${workspaceFolder}: Es wird zu dem Repository aufgelöst, das gerade geöffnet ist, und würde daher nicht mehr funktionieren, wenn der Server aus anderen Arbeitsbereichen verwendet wird. Der Befehlsname von npm link wird stattdessen über den PATH deiner Shell aufgelöst.

Um den Server in jedem Arbeitsbereich verfügbar zu machen, füge denselben servers-Block zu deiner MCP-Konfiguration auf Benutzerebene hinzu (Befehlspalette → MCP: Benutzerkonfiguration öffnen).

Alternative: node mit einem absoluten Pfad ausführen

Wenn du npm link lieber nicht verwendest, verweise mit node direkt auf die gebaute Einstiegsdatei über einen absoluten Pfad (nicht ${workspaceFolder}, das sich pro Arbeitsbereich ändert). Die Variable ${userHome} von VS Code hält es über Maschinen hinweg portabel:

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "zsh",
      "args": ["-lic", "exec node \"${userHome}/Sites/atlassian-mcp/dist/index.js\""]
    }
  }
}

Passe den Pfad an, falls du das Repository woanders geklont hast. Der zsh -lic-Wrapper stellt die Anmeldedaten weiterhin aus deinem Shell-Profil bereit.

Exportiere die Variablen in deinem Shell-Profil anstelle der Konfigurationsdatei:

export ATLASSIAN_SITE_URL="https://your-domain.atlassian.net"
export ATLASSIAN_EMAIL="you@example.com"
export ATLASSIAN_API_TOKEN="your-api-token"

Lade das VS-Code-Fenster nach Änderungen an deinem Shell-Profil neu, damit die neuen Werte übernommen werden.

Andere Clients (Claude Desktop, Cline, Cursor)

Clients, die nicht über deine Shell laufen, können entweder denselben zsh -lic-Wrapper verwenden oder die Variablen explizit setzen:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp",
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Ohne npm link verwendest du node mit einem absoluten Pfad zur gebauten Einstiegsdatei:

{
  "mcpServers": {
    "atlassian": {
      "command": "node",
      "args": ["/absolute/path/to/atlassian-mcp/dist/index.js"],
      "env": {
        "ATLASSIAN_SITE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "you@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Für die lokale Entwicklung kannst du den Server direkt mit npm run dev ausführen.

Werkzeuge

Jira

Confluence

Hinweise

• Jira-Rich-Text-Felder (Beschreibungen, Kommentare) akzeptieren Klartext, der automatisch in das Atlassian Document Format (ADF) konvertiert wird.

• Die Inhalte von Confluence-Seiten und -Kommentaren verwenden das Speicherformat (XHTML), z. B. <p>Hi</p>.

• Dein API-Token erbt alle Berechtigungen deines Kontos. Halte ihn geheim und committe ihn niemals.