Linear MCP einrichten: KI-Zugriff mit klaren Berechtigungen

Linear MCP: Server-URL und Authentifizierung

Die Adresse lautet https://mcp.linear.app/mcp. Die Verbindung zum gehosteten Server läuft über Streamable HTTP. Bei der interaktiven Einrichtung kommt OAuth 2.1 mit dynamischer Clientregistrierung zum Einsatz: Darüber werden der Client registriert und der Zugriff durch den Nutzer autorisiert. Alternativ lässt sich ein OAuth-Token oder ein Linear-API-Schlüssel mit Authorization: Bearer <yourtoken> übermitteln. Linear MCP einrichten

MCP lässt sich als gemeinsame Anlaufstelle für Anfragen verstehen. Der Assistent fordert eine benannte Aktion an, etwa das Suchen eines Issues oder das Speichern einer Änderung. Der Linear-Server führt sie aus, soweit die Verbindung dazu berechtigt ist. Der Prompt beschreibt das Ziel; zusätzliche Zugriffsrechte erteilt er nicht.

Diese Varianten begrenzen den Zugriff auf unterschiedliche Weise. Ein Prompt wie „Nichts bearbeiten“ ist eine Anweisung an den Assistenten. Ein Endpunkt oder Zugangsschlüssel mit reinen Leserechten schränkt dagegen seine tatsächlichen Handlungsmöglichkeiten ein. Zugriffsoptionen von Linear

Den passenden Client mit Linear verbinden

Claude und Claude Code

In der Browser- oder Desktop-App von Claude unter Settings → Connectors den Eintrag Linear verbinden. Diesen Weg beschreibt Linear auf seiner Integrationsseite für Claude.

Für Claude Code:

1. Im Terminal claude mcp add --transport http linear-server https://mcp.linear.app/mcp ausführen.
2. Eine Claude-Code-Sitzung öffnen.
3. /mcp ausführen und die Authentifizierung abschließen.

Sowohl der Befehl als auch der anschließende Schritt stammen aus Linears Anleitung für Claude.

Cursor

Die zentrale Anleitung von Linear enthält einen Installationslink und verweist auf den Linear-Eintrag auf Cursors Seite für MCP-Tools. Der Installationseinstieg steht im Cursor-Abschnitt von Linear.

Die eigene Integrationsseite für Cursor beschreibt außerdem diesen manuellen Weg:

1. Mit Ctrl/Cmd + Shift + J die Cursor-Einstellungen öffnen.
2. MCP auswählen.
3. Add new global MCP server auswählen.
4. Diese Konfiguration einfügen:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

Dabei kommt mcp-remote zum Einsatz, eine Brücke zwischen Client und gehostetem Server. So ist die Konfiguration auf Linears Integrationsseite für Cursor veröffentlicht.

Codex CLI und IDE-Erweiterung

Laut Linear verwenden CLI und IDE-Erweiterung dieselbe MCP-Konfiguration.

1. codex mcp add linear --url https://mcp.linear.app/mcp ausführen.
2. Der Aufforderung zur Linear-Anmeldung folgen, die in der Einrichtungsanleitung beschrieben ist.
3. Bei manueller Konfiguration sieht Linear nach dem Bearbeiten von ~/.codex/config.toml die Authentifizierung mit codex mcp login linear vor.

Vor dem Übernehmen einer Konfiguration lohnt sich ein Blick auf einen Widerspruch in der Dokumentation:

Auf der Codex-Seite lautet der manuelle Servereintrag [mcp_servers.linear] mit url = "https://mcp.linear.app/mcp". Die Angaben sind hier so wiedergegeben, wie sie veröffentlicht wurden. Die widersprüchlichen Feature-Schalter sollten jedoch nicht als allgemein gültige, aktuelle Voraussetzung verstanden werden. Codex-Integration von Linear, zentrale MCP-Anleitung

Empfehlenswert ist der oben beschriebene Weg über Hinzufügen und Anmeldung. Die aktuelle MCP-Anleitung von OpenAI dokumentiert die Konfiguration von HTTP-Servern und codex mcp login <server-name>, ohne einen dieser Feature-Schalter vorauszusetzen. Offizielle MCP-Dokumentation von OpenAI

ChatGPT

Der von Linear dokumentierte Weg sieht so aus:

1. Die Connector-Einstellungen von ChatGPT über den Link auf Linears ChatGPT-Integrationsseite öffnen.
2. Linear verbinden.
3. Linear in Deep Research als Quelle hinzufügen.

Linear beschreibt diese Verbindung als Möglichkeit, Issues, Projekte und Diskussionen einzubeziehen, wobei die bestehenden Berechtigungen der einzelnen Nutzer erhalten bleiben. Das Erstellen oder Aktualisieren von Issues ist für diese Einrichtung nicht dokumentiert. Sie eignet sich damit für Recherchen und Zusammenfassungen. Für die folgenden Bearbeitungsbeispiele ist ein MCP-Client mit dokumentiertem Schreibzugriff vorgesehen. Diese Abgrenzung bezieht sich auf die beschriebene Verbindung und ist keine pauschale Aussage über sämtliche ChatGPT-Integrationen.

Welche MCP-Tools nennt Linear öffentlich?

Entscheidend ist die Unterscheidung zwischen dem Abrufen von Kontext und dem Speichern von Änderungen. Die folgende Tabelle enthält die exakten Bezeichner aus Linears veröffentlichter Liste häufig verwendeter Tools und erläutert ihren Zweck. Die Liste steht auf der Slack-Integrationsseite im Abschnitt zur Verbindung desselben Linear-MCP-Servers mit Slackbot. Tool-Liste von Linear

Im Änderungsprotokoll nennt Linear außerdem list_cycles, list_issue_labels, list_comments, save_project und save_document. Dokumentiert sind Zyklusdetails, seitenweise abrufbare Labels und Kommentare, Projektänderungen sowie das Erstellen oder Umhängen von Dokumenten unter Initiativen oder Zyklen. Das ist eine Übersicht öffentlich beschriebener, relevanter Tools. Daraus folgt nicht, dass jeder Client denselben Katalog mit einer festen Anzahl von Tools bereitstellt. Tools für Zyklen und Labels, Kommentar-Tools, Projekt- und Dokument-Tools

In älteren Beispielen stehen möglicherweise noch getrennte Aufrufe von create_issue und update_issue. Linear hat beide in save_issue zusammengeführt. Das ist beim Übernehmen alter Prompts und beim Entwickeln mit festen Tool-Namen zu berücksichtigen. Änderung der Linear-Tools

Welche Zugriffsrechte gelten, und was können Administratoren steuern?

Die Verbindung eröffnet einen autorisierten Zugang zu Workspace-Daten. In Linears OAuth-Terminologie bedeutet read „Lesezugriff auf das Konto des Nutzers“ und write „Schreibzugriff auf das Konto des Nutzers“. Standardmäßig erstellt die Anwendung Ressourcen im Namen der Person, die sie autorisiert hat. OAuth-Berechtigungen bei Linear

Für API-Schlüssel spricht Linear von „vollem Zugriff auf die Daten, auf die der Nutzer zugreifen kann“. Berechtigungen und Teams lassen sich jedoch einschränken. Ein entsprechend begrenzter Schlüssel unterscheidet sich daher wesentlich von einem persönlichen Schlüssel mit weitreichenden Rechten. Berechtigungen für API-Schlüssel

Welche Kontrollen greifen, hängt von der Authentifizierung ab:

Laut Linear sollen App-Freigaben steuern, „welche Anwendungen auf den Workspace und seine Daten zugreifen können“. Mitglieder können die Freigabe während der Installation beantragen. Die Kontrollen für Schlüssel betreffen die Authentifizierung per API-Schlüssel; die Verwaltung von OAuth-App-Verbindungen ersetzen sie nicht. Freigaben für Anwendungen, API-Verwaltung

Für unterstützte Anthropic-Clients können Enterprise-Workspaces mit Okta SAML eine zentral verwaltete Autorisierung nutzen. Dabei werden laut Linear „die bestehenden Linear-Berechtigungen angewendet“. Administratoren verwalten den Zugriff über Okta, statt für jede Verbindung eine gesonderte Autorisierung durch den Nutzer zu verlangen. Zentral verwaltete Autorisierung

Für reine Statusberichte genügt Lesezugriff. Für Triage und das Erstellen von Issues werden die nötigen Schreibrechte erteilt; die vorgeschlagenen Änderungen sollten vor dem Anwenden sichtbar sein. Diese Prüfung ist eine Empfehlung für den Arbeitsablauf, keine Behauptung, dass jeder Client dieselbe Freigabe erzwingt.

Drei Arbeitsabläufe, die sich lohnen

Ein Zyklusbericht ist ein guter Einstieg, weil er ohne Schreibzugriff auskommt. Danach bietet sich Triage an, wenn sich die Bearbeitung eingehender Meldungen oft wiederholt. Die Umwandlung von Spezifikationen lohnt sich, sobald eine verantwortliche Person viel Zeit damit verbringt, bereits beschlossene Anforderungen in Tickets zu übertragen.

Die folgenden Beispiele sind fiktiv und dienen der Veranschaulichung. Sie zeigen Prompts und erwartete Ergebnisse, keine Resultate eines Tests mit angemeldetem Nutzerkonto.

Neue Issues sichten und Änderungen zur Prüfung vorlegen

Eine technische Teamleitung könnte den Assistenten bitten, neue Meldungen zu prüfen, ähnliche vorhandene Issues abzurufen und daraus einen gemeinsamen Änderungsvorschlag zu erstellen. Das reduziert wiederholte Suchvorgänge und das manuelle Bearbeiten von Eigenschaften. Über Zuständigkeit und Priorität entscheidet weiterhin die Teamleitung.

Beispieleingabe: Eine neue Meldung mit dem Titel „Export-Schaltfläche hängt“ beschreibt, dass der Browser bei einem gefilterten Export nicht mehr reagiert. Ein vorhandenes Issue namens „Gefilterter Export wird nicht fertig“ betrifft dieselbe Ansicht. Bei einer weiteren Meldung, „Einladungen kommen nie an“, fehlen Zustellprotokolle und Schritte zum Reproduzieren des Fehlers.

Prompt:

So könnte ein brauchbarer Vorschlag aussehen:

Nach der Prüfung könnte die Teamleitung nur die vereinbarten Änderungen an Labels und Zuständigkeiten über save_issue freigeben. Unklare Meldungen bleiben dabei unverändert. Der Assistent sollte anschließend die Links zu den betroffenen Issues und eine Aufstellung der geänderten Felder zurückgeben. Die Funktionen zum Abrufen und Speichern stehen in Linears Tool-Liste.

Vor dem Bau einer eigenen Triage-Lösung lohnt sich der Vergleich mit Triage Intelligence. Linear bietet bereits Vorschläge für Eigenschaften sowie die Erkennung von Duplikaten und Beziehungen. Eine eigene MCP-Orchestrierung ist eher dann sinnvoll, wenn Entscheidungen Kontext oder Regeln benötigen, die über den integrierten Arbeitsablauf hinausgehen. Triage Intelligence

Aus einer Spezifikation Issues erstellen, ohne Anforderungen zu erfinden

Ein Gründer könnte aus einer freigegebenen Feature-Beschreibung zunächst Issue-Entwürfe ableiten und die geprüften Aufgaben anschließend in Linear anlegen lassen. Der Vorteil liegt in der Einheitlichkeit: Jedes Ticket verweist auf seine ursprüngliche Anforderung, und offene Entscheidungen bleiben sichtbar.

Beispielspezifikation: „Workspace-Administratoren können Mitglieder per E-Mail einladen. Eingeladene Personen nehmen die Einladung über einen E-Mail-Link an. Administratoren können ausstehende Einladungen widerrufen. Änderungen an der Abrechnung und Masseneinladungen gehören nicht zum Umfang.“

Prompt:

Vorgeschlagene Aufteilung in Issues:

Offene Fragen: Was passiert, wenn die E-Mail-Adresse bereits zu einem Mitglied gehört? Läuft eine Einladung ab? Was soll eine eingeladene Person nach einem Widerruf sehen? Das bleiben offene Fragen, bis die Produktverantwortlichen dazu eine Entscheidung getroffen haben.

Nach der Freigabe könnte der Assistent das übergeordnete Issue und die Unter-Issues erstellen, ihre URLs zurückgeben und alle Einträge nennen, die sich nicht anlegen ließen. Das Erstellen von Unter-Issues gehört zu den dokumentierten MCP-Funktionen. MCP-Änderungen von Linear

Der Assistent übernimmt die Übertragung in Tickets. Die Produktentscheidungen bleiben bei den Produktverantwortlichen.

Aus dem Zyklus einen wöchentlichen Statusbericht erstellen

Eine Teamleitung könnte aus den Aufgaben eines Zyklus einen Statusentwurf erstellen lassen, dessen Aussagen jeweils durch Links belegt sind. So wird aus verstreuten Issue-Updates schneller ein nachvollziehbarer Bericht.

Ein Wochenbericht und eine Zykluszusammenfassung können unterschiedliche Zeiträume abdecken. Deshalb sollten Team, Zyklus und Berichtszeitraum ausdrücklich festgelegt werden. Aus „in diesem Zyklus abgeschlossen“ darf nicht unbemerkt „diese Woche abgeschlossen“ werden.

Beispielmaterial: „Einladungs-E-Mail“ wurde innerhalb des Berichtszeitraums als „Done“ markiert. „Einladung annehmen“ steht weiterhin auf „In Progress“. Ein Kommentar zu „Einladung widerrufen“ hält fest, dass die Umsetzung auf eine Produktentscheidung dazu wartet, was beim Öffnen eines widerrufenen Links geschehen soll.

Prompt:

Beispielentwurf:

In einem tatsächlichen Entwurf sollte jeder Satz auf das passende Issue verlinken. Das Beispiel nennt bewusst weder einen Fertigstellungsgrad noch behauptet es eine Veröffentlichung. Die Abruffunktionen für Zyklen, Issues und Kommentare liefern die Grundlage für diesen Ablauf. Zyklus- und Issue-Tools, Kommentare abrufen

Weitere sinnvolle Aufgaben, sobald die Abläufe funktionieren

Das Erstellen von Kommentaren gehört zu den dokumentierten Serverfunktionen. Die Projekt-Tools liefern den Kontext für eine Übergabe. Serverfunktionen, Projekt-Tools

Die Wirtschaftlichkeit: Prüfaufwand mitrechnen

Betroffen ist vor allem der Aufwand für die Koordination im Entwicklungsteam. Ohne MCP sucht die Teamleitung Informationen, kopiert sie, gleicht sie ab und schreibt sie zusammen. Mit angebundenem Assistenten muss sie weiterhin den Auftrag eingrenzen, das Ergebnis prüfen und Fehler korrigieren.

Für eine Wirtschaftlichkeitsrechnung mit den eigenen Kosten eignet sich diese Formel:

Nettonutzen = (Zeit für manuelle Vorbereitung − Zeit für assistierte Vorbereitung, Prüfung und Korrektur) × Vollkosten pro Arbeitsstunde − zusätzliche Client- und Betriebskosten.

Ein gut formulierter Bericht spart keine Zeit, wenn seine Prüfung länger dauert. Für den Vergleich müssen beide Arbeitsabläufe denselben Berichtsumfang abdecken. Auch die Nacharbeit nach falschen Änderungen gehört in die Rechnung. Das sinnvolle Ziel ist weniger Koordinationsaufwand pro akzeptiertem Ergebnis.

Bei der Tarifwahl hilft der Überblick zu den Linear-Preisen. Falls noch offen ist, welches Ticketsystem zum Einsatz kommen soll, behandelt Linear vs Jira diese Entscheidung. Weitere Anbindungen stehen in unserem Leitfaden zu den besten MCP-Servern.

Welche Produkte lassen sich darauf aufbauen?

Ein Dienst für Statusentwürfe aus Zyklusdaten ist der aussichtsreichste Einstieg. Eine technische Teamleitung könnte für einheitliche Berichte bezahlen, die Teamgrenzen berücksichtigen, abgeschlossene und offene Arbeit trennen und Belege aus den Issues mitliefern. Die kleinste sinnvolle Version würde eine Berichtsdefinition speichern, die relevanten Zyklusdaten abrufen und einen bearbeitbaren Entwurf erzeugen. Zeitplanung, Wiederholungsversuche und Zustellung wären Aufgaben der eigenen Anwendung.

Die Herausforderung ist die Abgrenzung: Ein allgemeiner Prompt für Zusammenfassungen lässt sich leicht nachbauen. Das mögliche Produkt liegt in den Berichtsvorgaben des Unternehmens, der Nachvollziehbarkeit der Quellen und dem Prüfprozess. Vor dem Aufbau eines eigenständigen Abonnements sollte sich bestätigen, dass Teams regelmäßig genau an diesen Punkten scheitern.

Eine eigene Prüfwarteschlange für die Triage ist eine enger gefasste Möglichkeit. Die Leitung eines Plattform- oder Support-Engineering-Teams könnte dafür bezahlen, den Kontext aus Linear-Issues mit eigenen Zuweisungsregeln und separat autorisierten Supportinformationen zu verbinden. Eine minimale Version würde vorgeschlagene Feldänderungen samt Belegen anzeigen, die Auswahl zwischen Freigeben und Überspringen anbieten und anschließend die akzeptierten Änderungen anwenden.

Die Herausforderung ist hier die direkte Konkurrenz zu Linears eigener Triage Intelligence. Eine Eigenentwicklung lohnt sich nur dort, wo zusätzlicher Kontext oder eigene Regeln eine Entscheidung verändern, die das integrierte System für dieses Team nicht ausreichend abbilden kann. Das sind Produkthypothesen, keine nachgewiesenen Kundenergebnisse.

Wo die Verbindung an ihre Grenzen stößt

MCP gibt dem Assistenten Zugriff auf Funktionen. Unklare Anforderungen klärt es damit nicht, und unvollständige Issue-Daten werden dadurch nicht verlässlich. Ein als „Done“ markiertes Ticket kann eine Statusaussage über dieses Ticket belegen. Für sich genommen beweist es nicht, dass ein Kunde das Feature erhalten hat.

Ebenso erteilt eine Linear-Autorisierung keine Zugriffsrechte auf jedes Dokument, Repository oder Supportsystem, das in einem Issue erwähnt wird. Benötigt eine Anwendung solche Quellen, müssen die jeweiligen Zugriffs- und Abrufwege gesondert eingeplant werden.

Für neue Einrichtungen ist /mcp vorgesehen. Linear kennzeichnet /sse als veraltete Ausweichlösung. Auch der ältere Community-Server von jerhadf weist ausdrücklich darauf hin, dass er veraltet ist und nicht mehr gepflegt wird. Er verweist auf den offiziellen Server von Linear. Hinweise zum aktuellen Endpunkt

Der nächste Schritt für Montag: Die technische Teamleitung legt Team, Zyklus und Berichtszeitraum für einen Statusentwurf mit reinem Lesezugriff fest. Anschließend werden die Aussagen anhand der verlinkten Issues geprüft und der Vorbereitungsaufwand mit dem bisherigen Verfahren verglichen. Schreibzugriffe kommen hinzu, sobald das Team einen klaren Prüfablauf etabliert hat.

Für Arbeitsabläufe nach den Regeln des eigenen Teams entwickeln wir KI-Automatisierungen.