---
title: Linear-MCP wieder funktionsfähig machen
type: reference
tags: [linear, mcp, troubleshooting, infra]
date: 2026-08-03
status: aktiv
related: [[01-Projekte/qaf-compare-v2-offene-punkte]], [[TOOLS]]
---

# Linear-MCP wieder funktionsfähig machen

> Aufgenommen am 03.08.2026, nachdem `list_teams` mit
> `requires re-authorization (token expired)` fehlschlug und der Server sich anschliessend
> ganz getrennt hat. Kais: „Lass uns erstmal Linear wieder funktionsfähig machen."

## Befund

Das Linear-Plugin ist **kein API-Key-Integration**, sondern ein HTTP-MCP-Server mit OAuth:

```json
// ~/.claude/plugins/cache/claude-plugins-official/linear/*/.mcp.json
{ "linear": { "type": "http", "url": "https://mcp.linear.app/mcp" } }
```

Daraus folgen zwei Dinge:

1. **Ein `LINEAR_API_KEY` in einer `.env` hilft nicht.** Der Hook beim Session-Start meldet
   zwar „LINEAR_API_KEY in /home/aria/aria/.env nicht gesetzt" — diese Datei existiert gar
   nicht, und der MCP-Server benutzt den Schlüssel ohnehin nicht. Die Hook-Meldung führt in
   die Irre (eigener Punkt, siehe unten).
2. **Die Erneuerung braucht einen Browser-Login.** Ein OAuth-Flow lässt sich weder aus
   Telegram noch aus einem Agentenlauf heraus abschliessen — Kais muss ihn selbst starten.

## Was Kais tun muss

In der Konsole, in der die Aria-Session läuft (tmux):

```
/mcp
```

Dort `linear` auswählen und die Neu-Authentifizierung starten. Der Browser-Login läuft über
`linear.app`; danach ist der Server sofort wieder erreichbar, ein Neustart der Session ist
nicht nötig.

## Zusatzbefund: das Plugin ist als verwaist markiert

```
b65c78ce1730/.orphaned_at   1784045673049  (13.07.2026)
unknown/                    zweite Kopie, identische .mcp.json
```

Es liegen **zwei Kopien** des Plugins im Cache, eine davon seit 13.07. als `orphaned`
markiert, und beide zeigen auf dieselbe URL. Das erklärt den Token-Ablauf nicht, ist aber
ein Kandidat dafür, dass die Autorisierung an der „falschen" Kopie hängt.

Falls die Neu-Authentifizierung nicht greift: Plugin einmal entfernen und neu hinzufügen,
damit nur eine Kopie übrig bleibt.

## Nicht selbst gemacht, bewusst

Weder Plugin-Verzeichnisse gelöscht noch Konfiguration umgeschrieben. Beides fasst
fremde Werkzeug-Installation an und kann die Autorisierung weiterer MCP-Server mitreissen —
das gehört mit Kais abgestimmt, nicht nebenbei erledigt.

## Folgefehler, der davon abhängt

`brain/01-Projekte/qaf-compare-v2-offene-punkte.md` listet 35 offene Punkte, die auf Kais'
Anweisung **auch in Linear** stehen sollten. Solange der Server nicht erreichbar ist, sind
sie nur im Brain. Nach der Neu-Authentifizierung anzulegen.

## Nebenbefund für die Hook-Pflege

Der SessionStart-Hook prüft `LINEAR_API_KEY` in `/home/aria/aria/.env`. Diese Datei
existiert nicht, und der Schlüssel wäre für den HTTP-MCP-Server ohne Funktion. Die Meldung
suggeriert eine Ursache, die keine ist — sie sollte entweder auf den MCP-Status prüfen oder
entfallen.