Linear
Agenten mit Issues und Kommentaren in einem Linear-Team starten und ihre Ergebnisse als Kommentar oder neues Issue posten.
Auf dieser Seite
| Modi | Inbound, Outbound |
| YAML-Typ | linear |
| Zugangsdaten | Ein Kontozugang (Connection) vom Typ linear mit einem persönlichen API-Key von Linear |
| Bridge | Nicht unterstützt |
| Custom Domain | Nicht unterstützt |
| Verknüpfte Agenten | Einer oder mehrere. Jedes passende Event startet alle verknüpften Agenten. |
| Während der Pause | Events erhalten 200 und starten keine Runs. Outbound sendet nichts. |
Einrichtung
Öffne in Linear Settings → Account → Security & Access und erstelle einen persönlichen API-Key. Für Inbound-Verbindungen erstellst du ihn als Admin des Workspaces, weil connic für das Team einen Webhook anlegt. Verbindungen handeln als das Mitglied, dem der Key gehört; siehe API-Key und Mitglied.
Klicke in connic unter Projekt-Settings → Connections auf New connection und wähle Linear. Den Kontozugang kannst du auch im Formular der Verbindung über die Auswahl unter Connection anlegen. Gib einen Name ein, füge den Key unter API key ein und klicke auf Create connection. connic prüft den Key bei Linear.
Öffne den Agenten. Klicke im Connector Flow für Events zu Issues und Kommentaren auf Add inbound connector oder für Kommentare und Issues auf Add outbound connector. Klicke dann auf Create New Connector und wähle Linear.
Wähle den Modus, Inbound (Team events) oder Outbound (Comments and issues), und unter Connection den Kontozugang. Trag unter Team das Kürzel des Teams ein, mit dem seine Issue-IDs beginnen, etwa
ENG, und bei Inbound die Events. Klicke auf Create. Eine Inbound-Verbindung legt dabei ihren Webhook in Linear an. Bei Outbound legst du danach fest, wie der Agent die Verbindung nutzt, und klickst auf Link connector.
Konfiguration
Die Felder einer Linear-Verbindung, in connectors/*.yaml genauso wie in der REST API und connic MCP. Die Beschreibungen nennen die passende Einstellung im Dashboard. Verbindungen im Code beschreibt die Felder, die alle Verbindungen gemeinsam haben, etwa agents und environments.
| Feld | Typ | Status | Beschreibung |
|---|---|---|---|
| type | string | Required | linear. |
| mode | string | Required | inbound oder outbound. Dashboard: Mode. |
| connection | string | Required | Inbound und Outbound. Name oder ID eines Linear-Kontozugangs. Dashboard: Connection. |
| config | object | Required | Einstellungen der Linear-Verbindung. |
| team | string | Required | Inbound und Outbound. Das Kürzel des Teams, mit dem seine Issue-IDs beginnen, etwa ENG. Inbound-Verbindungen erhalten seine Events, Outbound-Verbindungen legen dort Issues an. Das Team muss im Workspace des API-Keys liegen; bei einem privaten Team muss das Mitglied des Keys dazugehören. Dashboard: Team. |
| events | string[] | Required | Inbound. Die Events, die Runs starten. Ein Eintrag ist entweder Issue oder Comment für neue und geänderte, oder für nur eine Aktion einer von Issue.create, Issue.update, Comment.create und Comment.update. Dashboard: Events, einer pro Zeile, vorausgefüllt mit Issue.create und Comment.create. |
Der API-Key gehört zum Kontozugang, nicht zur Verbindung.
Erzeugte Werte
connic setzt diese Werte, wenn du die Verbindung oder ihren Kontozugang speicherst.
| Wert | Modi | Beschreibung |
|---|---|---|
| Webhook | Inbound | Der Webhook der Verbindung in Linear, mit einem Signing Secret, das connic erzeugt. connic legt ihn beim Speichern der Verbindung an, du musst ihn also nicht in Linear einrichten. |
| Team-ID | Inbound, Outbound | Die ID, unter der Linear das Team führt, das du mit seinem Kürzel einträgst. |
| Mitglied und Workspace | Inbound, Outbound | Das Mitglied, dem der API-Key gehört, und der Name des Workspaces. connic speichert beides beim Speichern des Kontozugangs. |
Agent-Input
Modi: Inbound
Eine Inbound-Verbindung startet einen Run für jeden verknüpften Agenten, sobald in ihrem Team ein Issue oder Kommentar angelegt oder geändert wird und zu ihren Events passt. Der Run erhält:
{
"event": "Comment",
"action": "create",
"issue": "ENG-42",
"conversation_id": "linear:9b2f4c1e-6d3a-4f8b-a1c7-2e5d8f0b3a64",
"title": "Checkout schlägt bei EUR-Bestellungen fehl",
"text": "Passiert seit dem letzten Deploy immer noch.",
"url": "https://linear.app/acme/issue/ENG-42/checkout-schlagt-bei-eur-bestellungen-fehl#comment-5d1a2c3b",
"actor": "Jana Schmidt",
"raw": { ... }
}eventundactionsindIssueoderCommentundcreateoderupdate.issueist die ID des Issues, etwaENG-42, undtitlesein Titel, auch bei Kommentaren.conversation_idbleibt für alle Events eines Issues gleich. Soll dein Agent die früheren Kommentare als Verlauf kennen, setze in seiner YAMLsession.key: input.conversation_id. Von sich aus schaltet der Connector keine Sessions ein.textist die Beschreibung des Issues oder der Kommentar in Markdown undurlder Link dorthin.actorist der Name der Person, die das Event ausgelöst hat.rawenthält den vollständigen Webhook-Payload, so wie Linear ihn gesendet hat.
Kommentare zu Projekt-Updates und andere Kommentare außerhalb eines Issues starten keine Runs. Stellt Linear ein Event mit derselben Delivery-ID erneut zu, startet kein weiterer Run. Der Inbound-Modus antwortet nicht von selbst: Für einen Kommentar im Issue verknüpfst du den Agenten mit einer Outbound-Linear-Verbindung, die denselben Kontozugang nutzt; siehe Outbound-Zustellung.
API-Key und Mitglied
Ein persönlicher API-Key handelt als das Linear-Mitglied, das ihn erstellt hat. Kommentare und Issues deiner Agenten erscheinen unter diesem Mitglied, und Events, die es auslöst, ignoriert connic. So starten sich Agenten nicht mit ihren eigenen Kommentaren selbst. Gehört der Key einer Person, starten auch deren eigene Änderungen keine Runs. Ein eigenes Linear-Mitglied für deine Agenten vermeidet das.
Webhooks dürfen in Linear nur Admins des Workspaces anlegen, eine Inbound-Verbindung braucht also den Key eines Admins. Schränkst du Berechtigungen oder Teams des Keys in Linear ein, behalte das Team und das, was die Verbindung tut: Webhooks anlegen bei Inbound, Kommentare und Issues anlegen bei Outbound. Ob Mitglieder überhaupt API-Keys erstellen dürfen, legen Admins in Linear fest.
Linear-Webhook
Modi: Inbound
Beim Speichern einer Inbound-Verbindung legt connic in Linear für ihr Team einen Webhook namens connic an, je nach ihren Events für Issues, Kommentare oder beides. Jede Verbindung hat ihren eigenen Webhook, mehrere Verbindungen können also dasselbe Team beobachten, etwa eine pro Environment. Du findest die Webhooks in Linear unter Settings → Administration → API.
connic prüft die Signatur jeder Zustellung mit dem Secret des Webhooks und lehnt Zustellungen ab, die Linear vor mehr als einer Minute gesendet hat. Änderst du das Team, den Kontozugang oder ob die Verbindung Issues oder Kommentare erhält, legt connic einen neuen Webhook an und entfernt den alten. Löschst du die Verbindung, entfernt connic ihren Webhook.
Outbound-Zustellung
Modi: Outbound
Eine Outbound-Linear-Verbindung postet bei jeder Nutzung einmal: wenn der Run eines verknüpften Agenten abgeschlossen ist, wenn das Modell sie als Tool aufruft oder wenn Middleware sie aufruft, je nach Nutzung der Verknüpfung. Dabei gilt die erste zutreffende Regel:
- Nennt die Ausgabe oder der Payload eine
issue_id, etwaENG-42, kommentiert sie dieses Issue. - Kam der Run über eine Inbound-Linear-Verbindung mit demselben Kontozugang, kommentiert sie das Issue, aus dem er stammt. Hat ein Kommentar den Run gestartet, antwortet sie im Thread dieses Kommentars.
- Sonst legt sie ein neues Issue im Team der Verbindung an. Sein Titel ist
titleaus Ausgabe oder Payload, ohne ihn die erste Zeile des Texts, und der Text wird zur Beschreibung.
Automatische Ausgabe
Eine automatische Verknüpfung postet die finale Ausgabe des Runs. Klartext wird zum Text. Bei einem JSON-Objekt kommt der Text aus body, text, message, response oder output, in dieser Reihenfolge, und title und issue_id lassen sich mitgeben. Linear stellt den Text als Markdown dar.
{
"title": "EUR-Summen werden im Checkout doppelt gerundet",
"body": "Bestellungen in EUR liegen seit 2.14.0 einen Cent daneben. Die Summe wird im Warenkorb und noch einmal bei der Zahlung gerundet."
}Payload für Agent-Tool und Middleware
Das Modell oder die Middleware übergibt body, Pflicht und nicht leer, und optional title und issue_id. Andere Felder werden abgelehnt.
{
"body": "Nachgestellt: Die Summe wird im Warenkorb und noch einmal bei der Zahlung gerundet.",
"issue_id": "ENG-42"
}Zustellung und Wiederholungen
Bremst Linear einen Kommentar oder ein Issue per Rate Limit aus, wartet connic und sendet erneut. Die Runs der Verbindung zeigen jede Zustellung mit dem Link zum Kommentar oder Issue oder mit dem Fehler.
Limits und Fehler
| Limit | Wert |
|---|---|
| Antwort an Linear | Linear erwartet innerhalb von 5 Sekunden eine Antwort. connic antwortet sofort und startet die Agenten danach. |
| Alter einer Zustellung | connic nimmt eine Zustellung nur innerhalb einer Minute nach dem Versand durch Linear an, wie Linear es gegen Replays empfiehlt. |
| Fehlgeschlagene Zustellungen | Linear versucht eine Zustellung bis zu dreimal erneut, zuletzt nach 6 Stunden, und kann einen Webhook abschalten, der dauerhaft fehlschlägt. |
| API-Anfragen | 2.500 pro Stunde je Mitglied in Linear, geteilt von allen API-Keys dieses Mitglieds. Jeder Kommentar und jedes Issue braucht eine Anfrage. Bremst Linear per Rate Limit, wartet connic und stellt erneut zu. |
| Titel eines Issues | Ohne title die erste Zeile des Texts, gekürzt auf 255 Zeichen. |
Anfragen mit fehlender oder falscher Signatur oder solche, die vor mehr als einer Minute gesendet wurden, erhalten 401. Ein Kontozugang lässt sich nicht speichern, wenn Linear den API-Key ablehnt. Eine Verbindung lässt sich nicht speichern, wenn das Team nicht im Workspace des Keys liegt, und bei Inbound auch dann nicht, wenn das Mitglied des Keys keine Webhooks anlegen darf. Eine Zustellung schlägt fehl, wenn Linear sie ablehnt, etwa weil das Issue nicht existiert.