Blog · Linear

Linear-MCP-Server: Einrichtung für Claude, Cursor, Codex, VS Code und mehr

Linears offizieller Remote-MCP-Server lässt KI-Clients Linear-Issues, -Projekte und -Kommentare finden, anlegen und aktualisieren. Linear hostet ihn unter https://mcp.linear.app/mcp, du musst also nichts installieren oder selbst betreiben: Du trägst die URL in deinen Client ein und meldest dich bei Linear an. Unten stehen die Endpunkte und Auth-Optionen, die exakte Einrichtung für jeden Client nach der Dokumentation von Linear und der jeweiligen Anbieter, die Tools und Lösungen für die üblichen Verbindungsprobleme.

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-Endpunkthttps://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
TransportStreamable HTTP. Clients ohne Remote-MCP-Unterstützung verbinden sich über das npm-Modul mcp-remote
AuthOAuth 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-Endpunkthttps://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-PlanLinears 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 LimitsLinear 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)
Gestartet1. 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.

  1. 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 user nutzt du Linear in jedem Projekt, mit --scope project teilst 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 Plugin linear@claude-plugins-official nutzt 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
    /mcp
  2. Claude (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 on
  3. Cursor

    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 manuelle mcp-remote-Config. Cursors eigene Dokumentation legt Remote-Server in ~/.cursor/mcp.json (global) oder .cursor/mcp.json (Projekt) mit einem url-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"]}}}
  4. VS Code

    Das ist Linears Weg: Füge einen stdio-Server hinzu, der mcp-remote ausfü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.json wä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"]}}}
  5. Codex (CLI und IDE-Erweiterung)

    codex mcp add fordert dich zur Anmeldung auf. Die offiziellen Seiten widersprechen sich bei einem Feature-Flag: Linears Dokumentation ergänzt experimental_use_rmcp_client = true unter [features] in ~/.codex/config.toml, Linears Codex-Seite sagt rmcp_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 linear
  6. Windsurf

    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.json oder .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"]}}}
  7. 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": {}}}}
  8. 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 source
  9. Andere, ü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 kann list_issues mit completedAt nach 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 und retiredAt jedes 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-Scope read, sodass das Token keine Schreib-APIs erreicht.
  • Übergib im Header Authorization: Bearer einen 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-auth aus 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/mcp und MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp.
  • Alte Config mit /sse: Ändere die URL in https://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-remote wie im Schritt „Andere“.

Zeitleiste

  • 1. Mai 2025: Linear startet seinen MCP-Server unter https://mcp.linear.app/sse, nativ in Claude und über mcp-remote in 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 /mcp angekündigt.
  • 13. August 2026: von Okta verwaltete Anmeldung für Enterprise-Workspaces mit Okta SAML.
  • 14. September 2026: list_teams und get_team liefern die Sichtbarkeit und retiredAt eines 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ür list_issues und 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.

Mit Crewmark

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-ServerCrewmark
Was es istEine Verbindung, über die ein KI-Client Linear lesen und ändern kannEin Issue-Tracker, in dem KI-Mitarbeiter die Issues besitzen
Wer die Arbeit machtDu, indem du deinen KI-Client promptestJeder KI-Mitarbeiter, mit einem Heartbeat in seinen Arbeitszeiten
Wo der Agent läuftIn deinem KI-ClientAuf deinem eigenen Computer, in deiner normalen Claude-Code- oder Codex-Umgebung
Wenn er dich brauchtEr wartet auf deinen nächsten PromptEr 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.

Gib deinen Agenten ein Board, nicht nur eine Verbindung.

Crewmark macht aus Claude Code, Codex und ACP-Agenten wie OpenCode und DeepSeek Harness KI-Mitarbeiter mit Rollen, KPIs, Arbeitszeiten und einem Heartbeat.