Administration & Konfiguration

LLM-Verbindungen einrichten

Diese Seite erklärt, wie Sie die LLM-Verbindungen (KI-Dienste, Endpoints, API-Keys, Modelllisten) einrichten, die AnyLLM verwendet: eine Verbindung anlegen, den Freigabe-Dialog von Atlassian bestätigen, die Verbindung testen, einen API-Key wechseln oder löschen und eine Verbindung entfernen.

Zweck

Eine Verbindung ist ein KI-Dienst, den Sie bereitstellen: eine Adresse (Endpoint), ein Provider-Typ, die Namen der Modelle, aus denen Ihre Nutzer:innen wählen dürfen, und ein API-Key. Möglich sind bis zu 5 Verbindungen mit je bis zu 20 Modellen pro Installation — eine gespeicherte Verbindung steht den Nutzer:innen von Jira und Confluence gleichermaßen zur Verfügung. Nur Verbindungen mit gespeichertem API-Key werden den Nutzer:innen angeboten; ihre Modelle erscheinen in der Modellauswahl des Chats, gruppiert unter dem Namen der Verbindung.

Berechtigung

Produkt-Administrator:innen (Jira- oder Confluence-Administration). Die Seite Verbindungen ist in beiden Produkten dieselbe.

Voraussetzungen

Sie haben die Adresse des Dienstes, den API-Key und die exakten Modellnamen vorliegen. Bei OpenAI-kompatiblen Diensten enthält die Adresse /v1, zum Beispiel https://llm.meine-firma.de/v1. Akzeptiert werden nur https-Adressen.
Das Speichern einer Verbindung mit neuer Adresse öffnet den Freigabe-Dialog von Atlassian — seine Zustimmung zählt nur für das Produkt, in dem Sie gerade arbeiten. Planen Sie ein, die Einstellungen anschließend im anderen Produkt zu öffnen und die Adresse auch dort freizugeben (siehe Endpoint-Freigaben verwalten).
Öffnen Sie Einstellungen → Verbindungen (Weg: Einstellungen öffnen und Ersteinrichtung).

Eine Verbindung anlegen

Zweck — einen KI-Dienst für alle Nutzer:innen der Installation verfügbar machen.

Schritte

Klicken Sie auf + Verbindung hinzufügen. Eine neue Karte erscheint (mit dem Titel Verbindung {n}, bis Sie einen Namen eintragen).
Füllen Sie die Felder der Karte aus:

Feld	Pflicht	Erläuterung
Name	ja	frei wählbar, bis zu 40 Zeichen; erscheint bei den Nutzer:innen als Gruppenname über den Modellen
Provider-Typ	vorbelegt	siehe Tabelle unten
Endpoint	ja	vollständige Adresse, nur `https`; bei OpenAI-kompatiblen Diensten einschließlich `/v1`. Beim Speichern wird die Adresse automatisch bereinigt: umgebende Leerzeichen und abschließende Schrägstriche werden entfernt, der Hostname wird kleingeschrieben; der Pfad bleibt wie eingegeben
API-Version (optional)	nein	erscheint nur bei Azure OpenAI, z. B. `2024-10-21`; bis zu 40 Zeichen
Modelle (kommagetrennt)	ja	exakt wie beim Dienst benannt, z. B. `gpt-4o, gpt-4o-mini`; bis zu 20 je Verbindung, jeder Name bis zu 100 Zeichen, nur Buchstaben, Ziffern und `. - _ / :`
API-Key	technisch nein	mindestens 8 Zeichen; wird verschlüsselt gespeichert und nie wieder angezeigt. Sie können ohne Key speichern, die Verbindung bleibt dann aber für Nutzer:innen unsichtbar

Klicken Sie auf Verbindungen speichern.
Bestätigen Sie den Bestätigungsdialog von Atlassian AnyLLM: selbst gehostete LLM-Endpoints (…) — er listet alle Adressen der Freigabe-Gruppe der App auf, auch wenn Sie nur eine hinzufügen.
Wechseln Sie mit dem Produkt-Knopf oben in den Einstellungen zum anderen Produkt und erteilen Sie die Freigabe auch dort: Jetzt freigeben in der Tabelle Freigabe-Status je Produkt auf der Seite Endpoint-Freigaben.

Provider-Typen

Auswahl	Wann	Hinweis unter dem Feld Endpoint
OpenAI-kompatibel (Standard, LiteLLM, OpenRouter …)	Regelfall	Endpoint inkl. /v1, Auth via Bearer-Token.
Self-hosted (OpenAI-kompatibel: vLLM, Ollama, LM Studio …)	eigener Server	Endpoint inkl. /v1 deines self-hosted Servers, Bearer-Token.
Azure OpenAI	Azure	Endpoint = Ressourcen-URL (https://<name>.openai.azure.com); „Modelle" = Deployment-Namen.
Anthropic (native /v1/messages)	Anthropic direkt	Endpoint = https://api.anthropic.com; „Modelle" = z. B. claude-sonnet-4-20250514.

Ergebnis — die Meldung Gespeichert. neben dem Knopf. Die Beschriftung des Feldes API-Key lautet jetzt API-Key (gesetzt — leer lassen zum Behalten, neuer Wert rotiert), und die Adresse erscheint unter Endpoint-Freigaben für dieses Produkt als freigegeben. Nutzer:innen sehen die Modelle der Verbindung in ihrer Modellauswahl; Anfragen gelingen, sobald die Freigabe in ihrem Produkt vorliegt.

Hinweise

Wird der Dialog abgelehnt, wird nichts gespeichert: Die Seite meldet Netzfreigabe für … wurde abgelehnt oder ist fehlgeschlagen — es wurde nichts gespeichert. (ein technischer Fehler des Dialogs sieht genauso aus). Erneut speichern und bestätigen.
Die Freigabe zählt nur für dieses Produkt. Bis Sie die Adresse auch im anderen Produkt freigeben, antwortet der Chat dort mit Der Endpoint {host} ist in {p} noch nicht freigegeben — Endpoint-Freigaben gelten je Produkt. …
Fünf Verbindungen sind das Maximum: Sobald fünf Karten existieren, verschwindet + Verbindung hinzufügen (ein Import behält nur die ersten fünf Karten). Entfernen Sie eine Verbindung, um Platz zu schaffen.
Speichern auf anderen Seiten speichert auch Ihre Karten: Die Knöpfe Speichern auf Module und Allgemein übermitteln die gesamte Konfiguration, einschließlich bearbeiteter Verbindungskarten und dort eingetippter Keys.
Automatisches Aufräumen: Nach einem erfolgreichen Speichern entzieht die App Freigaben, die keine gespeicherte Verbindung und kein Such-Dienst mehr nutzt.
Meldet die Seite in Rot Gespeichert, aber die Netzfreigabe konnte nicht angefragt werden — Customer-managed Egress ist für diese Installation nicht verfügbar. …, wurde die Konfiguration gespeichert, aber die Freigabefunktion von Atlassian fehlt — siehe Endpoint-Freigaben verwalten.

Eine Verbindung testen

Voraussetzung — die Verbindung ist gespeichert und hat einen Key. Bis die Karte gespeichert ist, steht dort Neu — Test nach dem Speichern möglich.; Verbindung testen bleibt gesperrt, solange die Verbindung nicht gespeichert ist oder keinen Key hat.

Schritte

Klicken Sie auf der Karte auf Verbindung testen. Während der Test läuft, zeigt die Karte Teste Verbindung ….
Lesen Sie die Rückmeldung:

Rückmeldung	Bedeutung
Verbindung ok — {n} Modell(e) am Endpoint.	Adresse und Key funktionieren; der Dienst hat eine Modellliste gemeldet
Verbindung ok.	Adresse und Key funktionieren; der Dienst meldet keine Modellliste
Für diesen Key sichtbar: …	die Modelle, die der Dienst für diesen Key meldet (höchstens 50 Namen)
Nicht in der Liste (kann trotzdem funktionieren): …	ein eingetragenes Modell wurde nicht gemeldet. Wird rot angezeigt, obwohl der Test erfolgreich war — viele Dienste listen nur einen Ausschnitt; erst ein Chatversuch gibt Gewissheit
Test fehlgeschlagen. — allein oder gefolgt von einer technischen Meldung	der Test konnte gar nicht ausgeführt werden (zum Beispiel ist die Anfrage an die App gescheitert). Die dienstbezogenen Gründe in den folgenden Zeilen erscheinen für sich, ohne diesen Vorsatz
Endpoint rejects the API key (401/403).	Key falsch oder abgelaufen (Endpoint weist den API-Key ab)
Endpoint responded with HTTP {status}.	der Dienst hat mit einem anderen Fehlerstatus als 401/403 geantwortet
Timeout after 10s.	der Dienst hat nicht innerhalb von 10 Sekunden geantwortet
Connection failed: … This endpoint needs a network approval: check that an administrator has approved it under Settings → Endpoint approvals.	die Anfrage hat den Dienst nicht erreicht — typischerweise ist die Adresse nicht freigegeben oder nicht erreichbar
Der Request wurde innerhalb von Atlassian geblockt, bevor er {host} erreicht hat — der Endpoint ist in {p} noch nicht freigegeben. Freigaben gelten je Produkt; erteilen Sie sie auf der {p}-Admin-Seite unter Endpoint-Freigaben. Erscheint die Adresse dort bereits als freigegeben, nutzen Sie „Freigabe in diesem Produkt erneuern" — die Liste wird installationsweit angezeigt, die Admin-Zustimmung zählt aber je Produkt.	die Freigabe für das Produkt, in dem Sie sind, fehlt; dieser Test hinterlegt außerdem einen „blockiert"-Eintrag für das Produkt
Connection not found — please save first. / No API key saved — please set a key and save.	die Karte ist nicht gespeichert oder hat keinen Key (selten, weil der Knopf in diesem Zustand gesperrt ist)

eine Verbindungskarte nach erfolgreichem Test mit Verbindung ok und der Modellliste — Verbindungskarte nach Verbindung testen: das grüne Ergebnis listet die Modelle, die der Endpoint für diesen API-Key liefert.

Ergebnis — ein erfolgreicher Test in einem Produkt räumt auf der Seite Endpoint-Freigaben auch einen „blockiert"-Eintrag dieses Produkts ab. Der Test funktioniert unabhängig vom Abonnementstatus.

API-Key wechseln oder löschen

Wechseln: Tragen Sie den neuen Key in das Feld API-Key ein — das Feld ist leer, seine Beschriftung trägt (gesetzt — leer lassen zum Behalten, neuer Wert rotiert) — und klicken Sie auf Verbindungen speichern. Der neue Key wird sofort verwendet; ein leeres Feld behält den alten Key.

Löschen:

Klicken Sie auf der Karte auf Key löschen. Der Knopf wechselt zu Wirklich löschen?.
Klicken Sie zur Bestätigung auf Wirklich löschen?. Ein weiteres Speichern ist nicht nötig.

Ergebnis — die Karte meldet API-Key gelöscht — Verbindung ist deaktiviert, bis ein neuer Key gespeichert wird. Bei einem Fehler zeigt sie Löschen fehlgeschlagen. oder Connection not found. (Verbindung nicht gefunden).

⚠️ Warnung: Ohne Key ist die Verbindung sofort deaktiviert. Ihre Modelle verschwinden aus der Auswahl aller Nutzer:innen. War eines davon das Default-Modell, erhalten Nutzer:innen automatisch das erste verfügbare Modell einer anderen Verbindung. Bleibt keine nutzbare Verbindung übrig, meldet der Chat Noch nicht konfiguriert …, und das Eingabefeld ist gesperrt.

Eine Verbindung entfernen

Klicken Sie auf der Verbindungskarte auf Entfernen (nur sichtbar, solange mehr als eine Karte existiert).
Klicken Sie auf Verbindungen speichern.

Ergebnis — Gespeichert. Die Verbindung und ihr gespeicherter Key sind weg; Nutzer:innen verlieren die Modelle dieser Verbindung. Bereits gespeicherte Unterhaltungen bleiben erhalten; beim Fortsetzen wird ein verfügbares Modell verwendet. Eine Freigabe, die keine andere gespeicherte Verbindung und kein Such-Dienst nutzt, wird nach dem Speichern automatisch entzogen.

Häufige Probleme

Server-Meldungen erscheinen auf Englisch neben dem Knopf Verbindungen speichern.

Meldung	Ursache	Lösung
Add at least one connection.	alle Karten sind leer	mindestens eine Karte ausfüllen
„X“: name missing or longer than 40 characters.	Name leer oder zu lang	einen Namen mit bis zu 40 Zeichen eintragen
„X“: endpoint is not a valid URL.	die Adresse lässt sich nicht lesen	vollständige Adresse einschließlich `https://` eingeben
„X“: endpoint must use https://.	`http://` eingegeben	`https` verwenden
„X“: specify at least one model.	Modellliste leer	mindestens einen Modellnamen eintragen
„X“: at most 20 models.	mehr als 20 Modelle	Liste kürzen
„X“: invalid model name „…“	ein Name enthält andere Zeichen als Buchstaben, Ziffern und `. - _ / :` oder ist länger als 100 Zeichen	Namen korrigieren
"X": API key seems too short (at least 8 characters).	Key kürzer als 8 Zeichen	vollständigen Key einfügen
Default model must belong to one of the connections.	das Default-Modell auf Allgemein zeigt auf ein Modell, das es nicht mehr gibt	auf Allgemein ein anderes Default-Modell wählen
Netzfreigabe für … wurde abgelehnt oder ist fehlgeschlagen — es wurde nichts gespeichert.	Dialog abgelehnt, abgebrochen oder fehlgeschlagen	erneut speichern und den Dialog bestätigen
Gespeichert, aber die Netzfreigabe konnte nicht angefragt werden — Customer-managed Egress ist für diese Installation nicht verfügbar. …	die Freigabefunktion von Atlassian fehlt für die Site	Anbieter (maplee) kontaktieren; siehe Endpoint-Freigaben verwalten
Speichern fehlgeschlagen.	der Server hat die Anfrage ohne Details abgelehnt	Seite neu laden und erneut versuchen
+ Verbindung hinzufügen fehlt	fünf Verbindungen existieren	zuerst eine Verbindung entfernen
Nutzer:innen sehen Noch nicht konfiguriert …, obwohl Verbindungen existieren	keine Verbindung hat einen gespeicherten Key	Key eintragen und speichern
Der Chat im anderen Produkt meldet Der Endpoint {host} ist in {p} noch nicht freigegeben …	die Freigabe wurde nur in einem Produkt erteilt	im anderen Produkt freigeben
Ein Modell wird nicht gefunden	der Modellname weicht vom Dienst ab	Verbindung testen zeigt die sichtbaren Modellnamen