Skip to main content
Die Jira Integration ist ein integrierter Konnektor, mit dem Agenten direkt aus dem Chat heraus Issues, Sprints und Backlogs durchsuchen, erstellen und verwalten. Sie stellen die Integration einmalig auf Organisationsebene bereit; die Nutzer authentifizieren sich anschließend pro Person mit ihrem eigenen Jira-Konto.
Nur Org-Admins können Integrationen auf Org-Ebene konfigurieren. Instance-Admins nur in der eigenen Organisation. Die Berechtigung wird von der Instanz- an die Organisationsebene vererbt – die eigentliche Konfiguration findet immer org-weit statt.

​
Voraussetzungen

  • Rolle Org Admin (oder Instance-Admin innerhalb der eigenen Organisation).
  • Zugang zur Atlassian Developer Console (developer.atlassian.com) mit Administratorrechten für die Jira-Instanz.
  • Die Integration muss zuerst org-weit bereitgestellt werden, bevor sie über die Library in einem Space genutzt werden kann.

​
Schritt 1: OAuth-App in Atlassian anlegen

Legen Sie zunächst eine OAuth 2.0 (3LO) Integration in der Atlassian Developer Console an. Daraus erhalten Sie die Client ID und das Client Secret, die Sie in Localmind hinterlegen.
1

Developer Console öffnen

Melden Sie sich bei developer.atlassian.com an und öffnen Sie My Apps.
2

OAuth 2.0 (3LO) Integration erstellen

Erstellen Sie eine neue OAuth 2.0 (3LO) Integration und vergeben Sie einen aussagekräftigen Namen, z.B. Localmind Jira Connector.
3

Jira API und Scopes hinzufügen

Fügen Sie unter Permissions die Jira API hinzu und fordern Sie folgende Scopes an:
  • read:jira-work
  • write:jira-work
  • read:jira-user
  • offline_access
offline_access ist erforderlich, damit Localmind die Sitzung über ein Refresh-Token erneuern kann, ohne dass sich Nutzer wiederholt anmelden müssen.
4

Callback-URL setzen

Setzen Sie unter Authorization die Callback-URL auf die OAuth-Redirect-URL Ihrer Instanz:
https://<deine-instanz>-api.localmind.ai/v1/oauth/jira/callback
Die exakte URL wird nach dem Speichern auf dem Konfigurationsbildschirm in Localmind angezeigt. Ersetzen Sie <deine-instanz> durch den Host Ihrer Localmind-Instanz und übernehmen Sie die dort angezeigte URL.
5

Client ID und Client Secret kopieren

Öffnen Sie die App-Einstellungen und kopieren Sie die Client ID und das Client Secret. Sie benötigen beide Werte im nächsten Schritt.

​
Schritt 2: Konfiguration in Localmind hinterlegen

Hinterlegen Sie die Atlassian-Zugangsdaten in den Zugangsdaten Ihrer Organisation.
1

Zugangsdaten öffnen

Navigieren Sie zu Einstellungen (Zahnrad-Icon unten links) → Org-Einstellungen → Zugangsdaten und klicken Sie auf die Jira-Kachel.
2

Felder ausfüllen

Tragen Sie die in Schritt 1 kopierten Werte ein:
FeldBeschreibung
Client IDOAuth Client ID aus der Atlassian Developer Console
Client SecretOAuth Client Secret aus der Atlassian Developer Console
Geben Sie das Client Secret niemals in Prompts, Variablen oder externen Notizen weiter. Localmind speichert das Secret verschlüsselt und zeigt es nach dem Speichern nicht erneut an.
3

Konfiguration speichern

Klicken Sie auf Konfiguration speichern. Localmind zeigt anschließend die exakte Callback-URL für Ihre Instanz an. Gleichen Sie diese mit der in Schritt 1 hinterlegten URL ab.

​
Schritt 3: Nutzer-Authentifizierung (Per-User OAuth)

Jira verwendet ausschließlich Per-User OAuth – jeder Nutzer verbindet sein eigenes Jira-Konto. Der Datenzugriff entspricht damit exakt den individuellen Jira-Berechtigungen jedes Nutzers.
  • Beim ersten Aufruf des Jira-Tools im Chat erscheint ein OAuth-Popup mit der Aufforderung zur Anmeldung.
  • Nach erfolgreicher Anmeldung wird das Token gecacht – ein erneutes Login ist nicht erforderlich.
  • Es gibt keinen Service-Account-Modus: Aktionen werden immer im Namen des angemeldeten Nutzers ausgeführt.
Aus Sicht der Endanwender ist dieser Schritt in Integrationen nutzen beschrieben.

​
Verwendung in Spaces

Nach dem org-weiten Bereitstellen ist die Integration noch nicht automatisch in jedem Space sichtbar. Ein Admin oder ein berechtigter Nutzer muss sie aus der Library in den jeweiligen Space freigeben.
  1. Öffnen Sie die Library (Org-Navigation).
  2. Wählen Sie die Jira-Integration und geben Sie sie für den gewünschten Space frei.
  3. Danach steht das Jira-Tool den Agenten dieses Space zur Verfügung – siehe Werkzeuge.

​
Nächste Schritte

Integrationen nutzen

So verbinden Endanwender ihr Konto und rufen die Integration im Chat auf.

Zugangsdaten

Client ID und Secret zentral und verschlüsselt verwalten.

Library

Integrationen org-weit verfügbar machen und in Spaces freigeben.

Werkzeuge

Wie Agenten Tools und Konnektoren im Chat einsetzen.