> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence Integration einrichten

> Confluence als integrierten Konnektor bereitstellen, damit Agenten Wiki-Seiten, Spaces und Kommentare durchsuchen, lesen und erstellen können.

Die Confluence Integration ist ein integrierter Konnektor, mit dem Agenten direkt aus dem Chat heraus Wiki-Seiten, Spaces und Kommentare durchsuchen, lesen und erstellen. Sie stellen die Integration einmalig auf Organisationsebene bereit; die Nutzer authentifizieren sich anschließend pro Person mit ihrem eigenen Confluence-Konto.

<Warning>
  Erfordert die Rolle **Org Admin**. Die Konfiguration erfolgt pro Organisation. Auch Instanz-Administratoren konfigurieren Integrationen nur innerhalb ihrer eigenen Organisation.
</Warning>

## Voraussetzungen

* Rolle **Org Admin** (oder Instanz-Administrator innerhalb der eigenen Organisation).
* Zugang zur **Atlassian Developer Console** ([developer.atlassian.com](https://developer.atlassian.com)) mit Administratorrechten für die Confluence-Instanz.
* Die Integration muss zuerst org-weit bereitgestellt werden, bevor sie über die [Library](/library/overview) in einem Space genutzt werden kann.

<Tip>
  Wenn Sie Jira und Confluence aus derselben Atlassian-Cloud nutzen, legen Sie für jeden Konnektor eine **eigene** OAuth-App mit den jeweils passenden Scopes an. So bleiben die Berechtigungen sauber getrennt und nachvollziehbar.
</Tip>

## 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.

<Steps>
  <Step title="Developer Console öffnen">
    Melden Sie sich bei [developer.atlassian.com](https://developer.atlassian.com) an und öffnen Sie **My Apps**.
  </Step>

  <Step title="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 Confluence Connector`.
  </Step>

  <Step title="Confluence API und Scopes hinzufügen">
    Fügen Sie unter **Permissions** die **Confluence API** hinzu und fordern Sie folgende Scopes an:

    * `read:confluence-content.all`
    * `read:confluence-space.summary`
    * `read:confluence-user`
    * `write:confluence-content`
    * `offline_access`

    <Note>
      `offline_access` ist erforderlich, damit Localmind die Sitzung über ein Refresh-Token erneuern kann, ohne dass sich Nutzer wiederholt anmelden müssen.
    </Note>
  </Step>

  <Step title="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/confluence/callback
    ```

    <Info>
      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.
    </Info>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Schritt 2: Konfiguration in Localmind hinterlegen

Hinterlegen Sie die Atlassian-Zugangsdaten in den [Zugangsdaten](/settings/organization/Zugangsdaten) Ihrer Organisation.

<Steps>
  <Step title="Zugangsdaten öffnen">
    Navigieren Sie zu **Einstellungen (Zahnrad-Icon unten links) → Org-Einstellungen → Sicherheit → Zugangsdaten** und klicken Sie auf die **Confluence**-Kachel.
  </Step>

  <Step title="Felder ausfüllen">
    Tragen Sie die in Schritt 1 kopierten Werte ein:

    | Feld              | Beschreibung                                            |
    | ----------------- | ------------------------------------------------------- |
    | **Client ID**     | OAuth Client ID aus der Atlassian Developer Console     |
    | **Client Secret** | OAuth Client Secret aus der Atlassian Developer Console |

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

Confluence verwendet ausschließlich **Per-User OAuth** – jeder Nutzer verbindet sein eigenes Confluence-Konto. Der Datenzugriff entspricht damit exakt den individuellen Confluence-Berechtigungen jedes Nutzers.

* Beim **ersten Aufruf des Confluence-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.

<Note>
  Aus Sicht der Endanwender ist dieser Schritt in [Integrationen nutzen](/integrations/Integrationen-Nutzen) beschrieben.
</Note>

## 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](/library/overview) in den jeweiligen Space freigeben.

1. Öffnen Sie die **Library** (Org-Navigation).
2. Wählen Sie die **Confluence**-Integration und geben Sie sie für den gewünschten Space frei.
3. Danach steht das Confluence-Tool den Agenten dieses Space zur Verfügung – siehe [Werkzeuge](/core-functions/Werkzeuge).

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Integrationen nutzen" icon="plug" href="/integrations/Integrationen-Nutzen">
    So verbinden Endanwender ihr Konto und rufen die Integration im Chat auf.
  </Card>

  <Card title="Zugangsdaten" icon="key" href="/settings/organization/Zugangsdaten">
    Client ID und Secret zentral und verschlüsselt verwalten.
  </Card>

  <Card title="Library" icon="library-big" href="/library/overview">
    Integrationen org-weit verfügbar machen und in Spaces freigeben.
  </Card>

  <Card title="Werkzeuge" icon="wrench" href="/core-functions/Werkzeuge">
    Wie Agenten Tools und Konnektoren im Chat einsetzen.
  </Card>
</CardGroup>