Zum Hauptinhalt springen
connic
Starte kostenlos

Linear

Lass connic-Agenten auf Issues und Kommentare in deinen Linear-Teams reagieren. Die Agenten antworten im Kommentar-Thread oder legen neue Issues an.

Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
Linear Docs
Publisher
Von connic

Reagiere auf Issues und Kommentare

Passt ein Issue oder Kommentar im Team zu den Events einer eingehenden Verbindung, startet jeder damit verknüpfte Agent. Eine ausgehende Verbindung mit derselben Connection postet das Ergebnis als Kommentar.

Events und Aktionen wählen
Issue reagiert auf neue und geänderte Issues, Issue.create nur auf neue. Bei Kommentaren funktioniert es genauso.
Mehrere Verbindungen pro Team
Jede Verbindung hat ihren eigenen Webhook. Beobachte Issues mit der einen und Kommentare mit der anderen, oder nutze eine pro Environment.
Keine Schleifen, keine doppelten Runs
Änderungen des Mitglieds, dem der API-Key gehört, werden ignoriert, und ein Event, das Linear erneut zustellt, startet keinen zweiten Run.
  1. Im Team passiert etwas

    Jemand legt ein Issue an, ändert es oder schreibt einen Kommentar.

    Issue.create
  2. connic prüft und bestätigt das Event

    connic prüft die Signatur mit dem Secret des Webhooks, lehnt Zustellungen ab, die älter als eine Minute sind, und antwortet Linear deutlich innerhalb der 5 Sekunden.

    Linear-Signature
  3. Verknüpfte Agenten starten

    Der Run bekommt Event und Aktion, ID und Titel des Issues, den Text in Markdown, einen Link und wer das Event ausgelöst hat.

    Comment.create
  4. Die Antwort landet im Thread

    Eine ausgehende Verbindung mit derselben Connection kommentiert im Issue, im Thread des Kommentars, der den Run gestartet hat.

Ein API-Key, den Webhook legt connic an

Du fügst einmal einen persönlichen API-Key ein. Beim Speichern einer eingehenden Verbindung legt connic für ihr Team einen signierten Webhook in Linear an, und beim Löschen entfernt connic ihn wieder.

Dein Key, dein Workspace
Der Key gehört einem Mitglied deines Linear-Workspaces, und du kannst ihn in Linear jederzeit widerrufen. Ob Mitglieder Keys erstellen dürfen, legen Admins fest.
Ein Team pro Verbindung
Trag das Team mit seinem Kürzel ein, etwa ENG. Private Teams funktionieren, wenn das Mitglied des Keys dazugehört.
Nichts zurückzukopieren
connic erzeugt das Secret des Webhooks und prüft damit jede Zustellung. Den Webhook findest du in den API-Einstellungen von Linear.
linear-webhook.json
{
  "url": "https://connect.connic.co/linear/<connector-id>",
  "teamId": "<ID of team ENG>",
  "resourceTypes": ["Issue", "Comment"],
  "secret": "<generated by connic>",
  "label": "connic"
}

Kommentiere Issues oder lege neue an

Eine ausgehende Linear-Verbindung postet den Output des Agenten, egal ob der Run auf ein Issue antwortet oder von einer anderen Verbindung oder einem Zeitplan kommt.

Routing
Eine issue_id im Output hat Vorrang. Ohne sie kommentiert ein Run, den ein Issue über dieselbe Connection gestartet hat, genau dort. Jeder andere Run legt ein Issue im Team der Verbindung an.
Drei Wege zu senden
Sende nach jedem abgeschlossenen Run, gib dem Modell ein Tool oder rufe send_connector aus Middleware auf, wenn dein Code entscheidet.
Rate Limits inklusive
Bremst Linear einen Kommentar oder ein Issue per Rate Limit aus, wartet connic und sendet erneut.
output.json
{
  "title": "EUR totals are rounded twice at checkout",
  "body": "Orders in EUR are one cent off since 2.14.0."
}
connector-payload.json
{
  "body": "Reproduced: the total is rounded twice.",
  "issue_id": "ENG-42"
}

Wo Linear passt

Wähle ein Szenario und sieh, was beim Agenten ankommt und was er in Linear postet.

Jemand legt ein Issue an, und der Agent fragt nach fehlenden Angaben und nennt den wahrscheinlich betroffenen Bereich.

Neues Issue
Inbound Linear
issue-triage
Kommentar im Issue
linear-payload.json
{
  "event": "Issue",
  "action": "create",
  "issue": "ENG-418",
  "title": "Refund button does nothing",
  "text": "Clicking Refund on an order shows no error and no refund.",
  "url": "https://linear.app/acme/issue/ENG-418/refund-button-does-nothing",
  "actor": "Jane Doe"
}
output.json
{
  "body": "Likely the refunds service. Which order ID and browser?"
}

Jemand stellt in einem Kommentar eine Frage, und der Agent antwortet im selben Thread.

Neuer Kommentar
Inbound Linear
codebase-helper
Antwort im Thread
linear-payload.json
{
  "event": "Comment",
  "action": "create",
  "issue": "ENG-421",
  "title": "Round EUR totals once",
  "text": "Which services still round on their own?",
  "url": "https://linear.app/acme/issue/ENG-421/round-eur-totals-once#comment-7f3e",
  "actor": "Jane Doe"
}
output.json
{
  "body": "The cart and invoice services. Both call round() before payment."
}

Dein Helpdesk sendet einen Bug-Report, und der Agent legt daraus ein Linear-Issue an.

Helpdesk
Inbound Webhook
bug-reporter
Neues Issue in ENG
ticket.json
{
  "ticket_id": "T-20931",
  "customer_id": "C-1042",
  "subject": "Invoice PDF shows the wrong VAT rate",
  "message": "Since Monday our invoices show 16% instead of 19%."
}
output.json
{
  "title": "Invoice PDF uses 16% VAT instead of 19%",
  "body": "Reported in T-20931: invoices since Monday use 16%."
}

Dein Monitoring meldet einen neuen Fehler, und der Agent legt ein Issue mit allem an, was er darüber weiß.

Error-Monitoring
Inbound Webhook
error-triage
Issue zum Fehler
alert.json
{
  "service": "checkout-api",
  "error": "Order ord_88412 has no currency",
  "first_seen": "2026-11-16T09:12:04Z",
  "events_last_hour": 214
}
output.json
{
  "title": "checkout-api: orders without a currency fail",
  "body": "214 errors in the last hour, first seen at 09:12 UTC."
}

FAQ zu Linear

Einen persönlichen API-Key von Linear, den du unter Settings, Account, Security & Access erstellst. Eingehende Verbindungen legen für ihr Team einen Webhook an, und das erlaubt Linear nur Admins des Workspaces. Sie brauchen also den Key eines Admins.

Vom Linear-Mitglied, dem der API-Key gehört. Events, die dieses Mitglied auslöst, ignoriert connic, damit sich ein Agent nicht selbst erneut startet. Erstelle den Key für ein eigenes Mitglied deiner Agenten, dann starten die Änderungen aller anderen weiterhin Runs.

Nein. Beim Speichern einer eingehenden Verbindung legt connic für ihr Team einen Webhook mit einem selbst erzeugten Secret an, und beim Löschen entfernt connic ihn wieder. Private Teams funktionieren, wenn das Mitglied des Keys dazugehört.

Ja, mit type: linear, dem Kürzel des Teams und dem Namen einer Linear-Connection, die den API-Key enthält.