Linear MCP auf einen Blick
Aus Linears MCP-Dokumentation, dem Changelog und der API-Dokumentation, geprüft am 17. November 2026. Der Server stammt von Linear und steht im Connectors Directory von Claude als von Anthropic verifiziert.
| Linear-MCP-Server | |
|---|---|
| Endpunkt (lesen und schreiben) | https://mcp.linear.app/mcp |
| Nur-Lesen-Endpunkt | https://mcp.linear.app/mcp/readonly, der „only ever exposes read tools“ (stellt ausschließlich Lese-Tools bereit); seit dem 5. November 2026 in der MCP-Registry gelistet |
| Transport | Streamable HTTP. Clients ohne Remote-MCP-Unterstützung verbinden sich über das npm-Modul mcp-remote |
| Auth | OAuth 2.1 mit dynamischer Client-Registrierung (nur PKCE S256) oder ein OAuth-Token bzw. Linear-API-Key im Header Authorization: Bearer <yourtoken>. Von Okta verwaltete Anmeldung bei Enterprise und Claude Auto-Connect (Beta) bei Business oder Enterprise |
| Alter SSE-Endpunkt | https://mcp.linear.app/sse ist veraltet. Am 5. Februar 2026 schrieb Linear, man entferne die SSE-Unterstützung vollständig („fully removing SSE support“); am 17. November 2026 lieferte eine nicht authentifizierte Anfrage dorthin 404. Nimm für jede neue Einrichtung /mcp |
| Linear-Plan | Linears MCP-Seite nennt keine Planvoraussetzung für den Server; die Preisseite führt „MCP server“ unter den Integrationen auf, und der API-Zugriff ist in allen Plänen enthalten |
| Rate Limits | Linear nennt für MCP keine. Die allgemeinen API-Limits sind 2.500 Anfragen pro Stunde und Nutzer mit API-Key und 600 pro Stunde und IP ohne Authentifizierung; auch OAuth-Token-Anfragen sind begrenzt (429 mit Retry-After) |
| Gestartet | 1. Mai 2025 |
KI-Client mit Linears MCP-Server verbinden
Ein Schritt pro Client; folge dem, den du nutzt. Jedes Snippet stammt aus Linears Dokumentation oder Integrationsseite, bei Abweichungen aus der Dokumentation des Clients selbst. Für Nur-Lesen-Zugriff setzt du https://mcp.linear.app/mcp/readonly dort ein, wo ein Snippet https://mcp.linear.app/mcp hat.
Claude Code
Führe den Befehl im Terminal aus und starte dann in einer Claude-Code-Sitzung
/mcp, um dich bei Linear anzumelden. Mit--scope usernutzt du Linear in jedem Projekt, mit--scope projectteilst du es über.mcp.json. Um die Anmeldung zu überspringen, übergib ein Token mit--header "Authorization: Bearer your-token". Ein bei claude.ai verbundenes Linear erscheint auch in Claude Code, wenn du mit einem claude.ai-Abo angemeldet bist, und das offizielle Pluginlinear@claude-plugins-officialnutzt denselben Endpunkt. Mehr in Claude Code + Linear.# Add Linear's MCP server to Claude Code claude mcp add --transport http linear-server https://mcp.linear.app/mcp # Then, inside a Claude Code session, sign in to Linear /mcpClaude (claude.ai, Desktop und mobil)
Linears Connector steht im Connectors Directory von Claude. Anthropics Ablauf steht unten. Linears Dokumentation unterscheidet nach Plan (Team und Enterprise auf claude.ai, Free und Pro in Claude Desktop unter Settings > Connectors), während Claudes eigene Dokumentation sagt, Connectoren funktionierten in jedem Plan und im Web, auf dem Desktop und mobil. Bei Team und Enterprise können Admins außerdem Auto-Connect (Beta) einrichten, damit Mitglieder mit passender E-Mail-Adresse die Linear-Anmeldung überspringen.
Customize > Connectors > Discover > search "Linear" > Connect to Claude In a chat: + > Connectors > turn Linear onCursor
Linears Dokumentation installiert ihn über einen Cursor-Deeplink (die Config ist
{"url":"https://mcp.linear.app/mcp"}) oder über die Suche nach Linear auf Cursors Seite für MCP-Tools; die OAuth-Installation mit einem Klick kam mit Cursor 1.0. Linears Cursor-Seite nennt auch die manuellemcp-remote-Config. Cursors eigene Dokumentation legt Remote-Server in~/.cursor/mcp.json(global) oder.cursor/mcp.json(Projekt) mit einemurl-Feld ab. Mehr in Cursor + Linear.# One-click install (opens Cursor) cursor://anysphere.cursor-deeplink/mcp/install?name=Linear&config=eyJ1cmwiOiJodHRwczovL21jcC5saW5lYXIuYXBwL21jcCJ9 # Manual: CTRL/CMD Shift J → MCP → Add new global MCP server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}VS Code
Das ist Linears Weg: Füge einen stdio-Server hinzu, der
mcp-remoteausführt, nenne ihn **Linear**, dann **MCP: List Servers** → Linear → **Start Server**. Die eigene Dokumentation von VS Code fügt Remote-Server direkt hinzu: **MCP: Add Server** → **HTTP (HTTP or Server-Sent Events)** → Endpunkt eingeben → Global oder eine Workspace-.mcp.jsonwählen. Ein globaler Server wird mit Copilot CLI geteilt. Mehr in GitHub Copilot + Linear.# CTRL/CMD P → MCP: Add Server → Command (stdio), then enter: npx mcp-remote https://mcp.linear.app/mcp # Or, as JSON (Linear's docs): {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Codex (CLI und IDE-Erweiterung)
codex mcp addfordert dich zur Anmeldung auf. Die offiziellen Seiten widersprechen sich bei einem Feature-Flag: Linears Dokumentation ergänztexperimental_use_rmcp_client = trueunter[features]in~/.codex/config.toml, Linears Codex-Seite sagtrmcp_client = true, und OpenAIs aktuelle MCP-Dokumentation nutzt kein Flag. Das Snippet unten ist OpenAIs Form; verlangt deine Codex-Version ein Flag, prüfe beide Seiten. Die Config teilen sich die Codex-CLI, die IDE-Erweiterung und die ChatGPT-Desktop-App. Laut Linear können nur lokale Codex-Aufgaben (CLI oder IDE-Erweiterung) den Server nutzen. Mehr in Codex + Linear.# One command (Linear's docs and OpenAI's docs) codex mcp add linear --url https://mcp.linear.app/mcp # Or by hand in ~/.codex/config.toml (OpenAI's docs) [mcp_servers.linear] url = "https://mcp.linear.app/mcp" # then sign in (add --no-browser on a headless machine) codex mcp login linearWindsurf
Linears Windsurf-Seite sagt, du wählst das Symbol für Cascade-Plugins und installierst den Linear-MCP-Server von dort, oder fügst ihn von Hand wie unten hinzu. Die URL von Windsurfs MCP-Dokumentation leitet inzwischen auf die Dokumentation von Devin Local weiter. Dort liegen die Server in
~/.config/devin/mcp_config.jsonoder.devin/mcp_config.json, und Streamable HTTP mit OAuth wird unterstützt, die Menüs können also anders aussehen, als Linear sie beschreibt.# CTRL/CMD , → Cascade → MCP servers → Add Server → Add custom server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Zed
Linear dokumentiert zwei Formen: Die Dokumentationsseite nutzt die erste, die Zed-Integrationsseite die zweite. Auch Zeds eigene Dokumentation unterstützt Remote-Server per URL (Settings → AI → MCP Servers → Add Remote Server) mit dem MCP-OAuth-Ablauf, doch Linear dokumentiert diese Form nicht, und Zeds Dokumentation erwähnt
"source": "custom"nicht. Beginne mit der Form der Dokumentationsseite und sieh in Zeds MCP-Dokumentation nach, falls deine Version sie ablehnt.// Linear's docs: CMD , then add to settings {"context_servers": {"linear": {"source": "custom", "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}}} // Linear's Zed integration page shows an older shape: {"context_servers": {"linear": {"command": {"path": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}, "settings": {}}}}ChatGPT (Deep-Research-Connector)
Linears ChatGPT-Seite behandelt nur einen Deep-Research-Connector: Verbinde Linear in den Connector-Einstellungen von ChatGPT und füge Linear dann in Deep Research als Quelle hinzu. Er steht Plus- und Pro-Nutzern (außer im EWR, in der Schweiz und im Vereinigten Königreich) sowie Team-, Enterprise- und Edu-Nutzern zur Verfügung. Linear dokumentiert nicht, die MCP-URL im Entwicklermodus von ChatGPT einzutragen. OpenAI führt Linear als ChatGPT-Plugin, und die ChatGPT-Desktop-App nutzt den MCP-Server über die Codex-Config oben. Mehr in ChatGPT + Linear.
ChatGPT connector settings > connect Linear Deep research > add Linear as a sourceAndere, über mcp-remote
Für jeden Client, der einen lokalen MCP-Befehl ausführt, aber kein Remote-MCP unterstützt, nennt Linear diese Werte. Außerdem dokumentiert Linear fx (
/mcp add linear https://mcp.linear.app/mcp, dann/mcp login linear) und v0 von Vercel (Installation über die Seite für MCP-Verbindungen).Command: npx Arguments: -y mcp-remote https://mcp.linear.app/mcp Environment: None
Was du damit machen kannst
Linears Dokumentation beschreibt die Tools als „finding, creating, and updating objects in Linear like issues, projects, and comments“ (Objekte in Linear wie Issues, Projekte und Kommentare finden, anlegen und aktualisieren), nennt sie aber nicht einzeln. Die Namen unten stammen aus Anthropics Connector-Verzeichnis (22 Tools) und aus Linears Changelog. Die Liste des Verzeichnisses stammt aus der Zeit vor Linears Ergänzungen vom Februar 2026, dein Client zeigt also eventuell mehr.
- Issues:
list_issues,list_my_issues,get_issue,create_issue,update_issue,list_issue_statuses,get_issue_status,list_issue_labels. Seit dem 5. November 2026 kannlist_issuesmitcompletedAtnach Abschlussdatum filtern (ein ISO-8601-Datum oder eine Dauer wie-P7D). Probier: „Liste meine offenen Linear-Issues im Backend-Team“ oder „Lege für diesen Bug ein Issue an und weise es mir zu“. - Kommentare:
list_comments,create_comment. Probier: „Fasse die Kommentare zu ENG-123 zusammen und füge einen Kommentar mit der Lösung hinzu“. - Projekte:
list_projects,get_project,create_project,update_project. Probier: „Lege ein Projekt für den Billing-Umbau an und füge diese drei Issues hinzu“. - Teams, Nutzer und Cycles:
list_teams,get_team(seit dem 14. September 2026 mit der Sichtbarkeit undretiredAtjedes Teams),list_users,get_user,list_cycles. Seit dem 22. Oktober 2026 kannst du Personen über einen Teil ihres Namens zuweisen. Probier: „Welche Issues im aktuellen Cycle sind nicht zugewiesen?“ - Dokumente und Hilfe:
list_documents,get_document,search_documentation(Linears eigene Dokumentation). Probier: „Finde unsere Onboarding-Spezifikation in Linear und fasse sie zusammen“. - Kunden:
list_customer_needs(seit dem 8. Oktober 2026) liefert Kundenwünsche zu einem Issue, Projekt oder einer Initiative; Kunden lassen sich seit dem 22. Oktober 2026 über Domain und externe IDs finden. Probier: „Welche Kunden haben nach SSO gefragt?“ - Produktmanagement (seit dem 5. Februar 2026): Initiativen, Initiative-Updates, Projekt-Meilensteine und Projekt-Updates anlegen und bearbeiten, Projekt-Labels verwalten, Bilder laden und Linear-Ressourcen über ihre URLs laden. Probier: „Schreibe das Projekt-Update dieser Woche für Mobile v2 aus den geschlossenen Issues“.
- Seit dem 5. November 2026 sendet der Server den Clients Standardanweisungen, wie sie seine Tools nutzen sollen.
Nur-Lesen-Zugriff
Linear dokumentiert drei Wege, einen KI-Client daran zu hindern, etwas zu ändern:
- Nutze den Nur-Lesen-Endpunkt
https://mcp.linear.app/mcp/readonly, der ausschließlich Lese-Tools bereitstellt. - Nutze
https://mcp.linear.app/mcp, erteile aber nur den OAuth-Scoperead, sodass das Token keine Schreib-APIs erreicht. - Übergib im Header
Authorization: Bearereinen Linear-API-Key, der nur die Berechtigung Read hat.
Fehlerbehebung
- Die Verbindung scheitert oder braucht mehrere Versuche: Linear sagt, Remote-MCP-Verbindungen „are still early“ (seien noch jung). Starte deinen Client neu oder schalte den Linear-Server in dessen MCP-Einstellungen aus und wieder ein. Trennen und erneutes Verbinden ändert nichts an deinen Linear-Daten oder deiner Anmeldung.
- Internal Server Error beim Verbinden: Führe
rm -rf ~/.mcp-authaus und verbinde dich dann neu. Eventuell brauchst du eine neuere Node-Version. - Falscher Workspace: Erneutes Verbinden wechselt den Workspace innerhalb einer bestehenden Anmeldung nicht. Gib jedem Workspace einen eigenen Auth-Ordner, zum Beispiel
MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-a npx mcp-remote https://mcp.linear.app/mcpundMCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp. - Alte Config mit
/sse: Ändere die URL inhttps://mcp.linear.app/mcp. Linear hat am 5. Februar 2026 das Ende der SSE-Unterstützung angekündigt. - WSL unter Windows: Linears Dokumentation nennt weiterhin einen SSE-Workaround,
{"mcpServers": {"linear": {"command": "wsl","args": ["npx","-y","mcp-remote","https://mcp.linear.app/sse","--transport sse-only"]}}}, der den Endpunkt nutzt, den Linear entfernt. Rechne damit, dass er scheitern kann, und sieh in Linears Dokumentation nach einem Update. - Codex-Cloud-Aufgaben sehen Linear nicht: Laut Linear können nur lokale Codex-Aufgaben (CLI oder IDE-Erweiterung) den MCP-Server nutzen.
- Der Client hat keine Remote-MCP-Unterstützung: Nutze
mcp-remotewie im Schritt „Andere“.
Zeitleiste
- 1. Mai 2025: Linear startet seinen MCP-Server unter
https://mcp.linear.app/sse, nativ in Claude und übermcp-remotein Cursor, Windsurf, VS Code und Zed. - 5. Juni 2025: OAuth-Installation mit einem Klick in Cursor 1.0 und ein Linear-Connector für ChatGPT Deep Research.
- 5. Februar 2026: Initiativen, Initiative-Updates, Projekt-Meilensteine, Projekt-Updates, Projekt-Labels, Bilder und Ressourcen-URLs; geringerer Token-Verbrauch; Ende von SSE zugunsten von
/mcpangekündigt. - 13. August 2026: von Okta verwaltete Anmeldung für Enterprise-Workspaces mit Okta SAML.
- 14. September 2026:
list_teamsundget_teamliefern die Sichtbarkeit undretiredAteines Teams. - 8. Oktober 2026: Tool
list_customer_needs; PKCE muss eine explizite S256-Methode nutzen. - 22. Oktober 2026: Nutzer über einen Teil des Namens zuweisen, Kunden über Domain und externe IDs finden, und per MCP angelegte Sub-Issues erhalten jetzt das Projekt des übergeordneten Issues.
- 5. November 2026: Standardanweisungen für Clients, ein
completedAt-Filter fürlist_issuesund der Nur-Lesen-Endpunkt in der MCP-Registry. - 12. November 2026: Änderungen an Beschreibungen und Dokumenten mit API-Keys und App-Tokens behalten die Formatierung unveränderter Inhalte.
Linear mit jedem KI-Agenten
Manche Agenten haben zusätzlich zum MCP-Server eine eigene Linear-Integration. Jede Seite behandelt alle Wege, wie dieser Agent mit Linear arbeitet.
Ein Board, auf dem die KI-Agenten die Zuständigen sind
Linear ist für Menschen gebaut, Agenten kommen als Delegierte dazu. Crewmark ist ein Issue-Tracker für ein Team aus KI-Mitarbeitern. Jeder Mitarbeiter ist eine Claude-Code- oder Codex-Unterhaltung auf deinem eigenen Computer, mit Rolle, KPIs und Projekten; andere Agenten wie OpenCode und DeepSeek Harness verbinden sich über das Agent Client Protocol. Weise ihm ein Issue zu, und er legt los: Er wacht in seinen Arbeitszeiten mit einem Heartbeat auf, hält den Status aktuell, kommentiert und @erwähnt andere Mitarbeiter und setzt das Issue auf „Handlungsbedarf“ (Needs action), wenn er dich braucht.
Crewmark verbindet sich nicht mit Linear. Behält dein Team Linear, kann ein Mitarbeiter trotzdem den Linear-MCP-Server nutzen, den du auf seinem Computer eingerichtet hast, wie jedes andere Tool. Crewmark ist Open Source (GPL-3.0) und kostenlos für 1 Projekt mit bis zu 3 KI-Mitarbeitern; die Agenten laufen mit den Plänen, die du bereits hast.
| Linear-MCP-Server | Crewmark | |
|---|---|---|
| Was es ist | Eine Verbindung, über die ein KI-Client Linear lesen und ändern kann | Ein Issue-Tracker, in dem KI-Mitarbeiter die Issues besitzen |
| Wer die Arbeit macht | Du, indem du deinen KI-Client promptest | Jeder KI-Mitarbeiter, mit einem Heartbeat in seinen Arbeitszeiten |
| Wo der Agent läuft | In deinem KI-Client | Auf deinem eigenen Computer, in deiner normalen Claude-Code- oder Codex-Umgebung |
| Wenn er dich braucht | Er wartet auf deinen nächsten Prompt | Er setzt das Issue auf „Handlungsbedarf“ und fragt dich dort |
FAQ zu Linear MCP
Was ist der Linear-MCP-Server?
Linears offizieller, gehosteter Remote-MCP-Server unter https://mcp.linear.app/mcp. Er lässt KI-Clients wie Claude, Cursor, Codex, VS Code, Windsurf und Zed Linear-Issues, -Projekte, -Kommentare und mehr finden, anlegen und aktualisieren. Linear hat ihn am 1. Mai 2025 gestartet.
Ist der Linear-MCP-Server kostenlos?
Linear nennt dafür weder eine Planvoraussetzung noch eine eigene Gebühr: Die Preisseite führt „MCP server“ unter den Integrationen auf, und der API-Zugriff ist in allen Linear-Plänen enthalten. Nur Extras sind an Pläne gebunden: Claude Auto-Connect braucht Linear Business oder Enterprise, die von Okta verwaltete Anmeldung Enterprise. Der Plan deines KI-Clients gilt weiterhin.
Wie füge ich Linear MCP zu Claude Code hinzu?
Führe claude mcp add --transport http linear-server https://mcp.linear.app/mcp aus und starte dann in einer Claude-Code-Sitzung /mcp, um dich bei Linear anzumelden. Hast du Linear bei claude.ai verbunden und meldest dich in Claude Code mit diesem Abo an, erscheint der Connector auch dort.
Funktioniert Linear MCP mit Cursor?
Ja. Installiere es über Linears Cursor-Deeplink oder Cursors Seite für MCP-Tools mit OAuth per Klick, oder trage {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}} unter Add new global MCP server ein.
Kann ich Linear MCP nur lesend nutzen?
Ja. Nutze https://mcp.linear.app/mcp/readonly, der nur Lese-Tools bereitstellt; oder nutze /mcp und erteile nur den OAuth-Scope read; oder übergib einen Linear-API-Key mit nur der Berechtigung Read als Bearer-Token.
Warum scheitert meine Linear-MCP-Verbindung?
Linear sagt, Remote-MCP-Verbindungen seien noch jung und bräuchten manchmal mehrere Versuche: Starte den Client neu oder schalte den Server aus und wieder ein. Bei einem Internal Server Error führe rm -rf ~/.mcp-auth aus, verbinde dich neu und aktualisiere Node. Zeigt deine Config noch auf /sse, ändere sie in https://mcp.linear.app/mcp; Linear entfernt die SSE-Unterstützung.
Fakten am 17. November 2026 anhand von Linears Dokumentation und Changelog sowie der Dokumentation jedes Clients geprüft.