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

# Linear

> Auf @Erwähnungen in Linear-Issue-Kommentaren antworten

Linear lässt den Assistenten antworten, wenn jemand ihn in einem Issue-Kommentar mit @ erwähnt. Eine Support-Leitung kann den Assistenten direkt im Issue nach dem nächsten Schritt, einer Zusammenfassung oder einem Antwortentwurf fragen. Die Antwort bleibt an diesem Issue.

## Wann du ihn nutzt

Nutze ihn, wenn die Arbeit schon in Linear liegt: Fehlersichtung, Kundenissues oder eine interne Warteschlange. Der Assistent schreibt in den Kommentar-Thread. Er ersetzt nicht die Linear-Inbox und legt Issues nicht von selbst an.

## Was der Assistent hört

Der Assistent erhält die Kommentare, die du im Webhook abonnierst. Im Produkt sind das Issue-Kommentare. Erwähne den gespeicherten Bot-Handle, damit die Antwort an den Assistenten geht. Andere Linear-Ereignisse, die du nicht abonnierst, werden ignoriert.

## Woher die Schlüssel kommen

Die verlinkte Anbieter-Anleitung zeigt die Bildschirme zu diesen Klicks. Folge den Klicks unten zusammen mit diesen Bildern.

Melde dich auf [linear.app](https://linear.app) an. Einen persönlichen API-Key legst du unter **Settings → Account → Security & access** an. Er beginnt mit `lin_api_` und wird einmal angezeigt. Ein Workspace-Admin kann unter **Settings → Administration → API** einschränken, wer Keys anlegen darf. Das Webhook-Signing-Secret entsteht mit dem Webhook und beginnt mit `lin_wh_`. Offizielle Anleitungen mit den Bildschirmen dieser Menüs: [API and webhooks](https://linear.app/docs/api-and-webhooks) und [Webhooks](https://linear.app/developers/webhooks).

## Beim Anbieter anlegen

1. Öffne Linear und gehe zu **Settings → Account → Security & access**.
2. Lege einen persönlichen API-Key an, benenne ihn und kopiere ihn sofort.
3. Öffne als Workspace-Admin **Settings → Administration → API → New webhook**.
4. Abonniere **Comment**. In die URL kannst du vorübergehend eine HTTPS-Adresse setzen; Linear erlaubt, die URL später zu ändern.
5. Öffne den Webhook und kopiere das Signing-Secret.

## In Famulor verbinden

Dein Plan enthält diesen Kanal. Öffne **Settings → Channels**, wähle die Karte, benenne die Verbindung, wähle einen Assistenten und speichere. Die gemeinsamen Konversationseinstellungen — Antwortverzögerung (Standard 5 Sekunden) und Inaktivitätszeit (Standard 30 Minuten) — stehen auf der Seite [Messaging-Kanäle](https://docs.famulor.io/de/channels/messaging.md).

Füge auf der Karte **Linear** den **Linear API key** und das **Webhook signing secret** ein. **Bot @handle / display name** ist optional; nimm den Handle, den Personen tippen.

Öffne nach dem Speichern das Menü der Verbindung und wähle **Copy webhook URL**. Füge genau diese Adresse beim Anbieter ein. Eine verifizierte eigene Domain ist in der angezeigten Adresse bereits enthalten.

## Den Anbieter auf Famulor zeigen lassen

1. Kopiere die Famulor-Webhook-URL aus dem Verbindungsmenü.
2. Bearbeite den Linear-Webhook und ersetze die URL durch diese Adresse.
3. Speichere den Webhook. Ein neuer Kommentar, der den Assistenten mit @ erwähnt, erscheint im Verlauf.

## Verlauf

Öffne den [Verlauf](https://docs.famulor.io/de/monitoring/history.md) und filtere nach **Linear**. Der Thread, die Antwort des Assistenten und eine vorhandene Auswertung erscheinen dort. Du kannst den Assistenten pausieren und selbst antworten.

## API, MCP und Kommandozeile

Dieselbe Verbindung lässt sich über die öffentliche API, das MCP-Tool `create_messaging_connector` oder die Kommandozeile anlegen. Ersetze die Platzhalter durch deine eigenen Werte.

```bash theme={null}
famulor create-messaging-connector --platform linear --name "Support" \
  --assistant-id ASSISTANT_UUID --api-key lin_api_… --webhook-secret lin_wh_… --bot-username famulor-bot
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.