Outline-MCP: OAuth statt API-Key-Header (Verbindung scheitert mit 401) #44

New issue

Closed

opened 2026-11-03 10:51:13 +00:00 by cschlaefke · 0 comments

cschlaefke commented

2026-11-03 10:51:13 +00:00

Owner

Problem

Nach #39 (PR #40) verbindet sich der Server outline nicht: Outline antwortet mit 401 Unable to decode token, obwohl der Key an der REST-API (/api/auth.info) 200 liefert. Wahrscheinliche Ursache: die Variable ${OUTLINE_API_KEY} wird von der Desktop-App nicht aus ~/.zshenv geerbt, der Header enthält dann den unaufgelösten Platzhalter. Außerdem setzt ein gesetzter Authorization-Header den OAuth-Fallback außer Kraft.

Lösung (nach Outline-Doku, https://docs.getoutline.com/s/guide/doc/mcp-6j9jtENNKL)

Standard ist OAuth: .mcp.json nur mit type: http und url (https://outline.cshomelabs.work/mcp), Anmeldung per OAuth-Ablauf. Kein Key in Umgebungsvariablen nötig. Voraussetzung: MCP im Workspace aktiviert (Settings → Workspace → AI).

Akzeptanz

headers-Block aus .mcp.json entfernt
README: OUTLINE_API_KEY-Abschnitt durch OAuth-Hinweis ersetzt (API-Key nur als Alternative)
Verbindung mit Anmeldung geprüft, Tools erscheinen als mcp__outline__*

## Problem Nach #39 (PR #40) verbindet sich der Server `outline` nicht: Outline antwortet mit 401 `Unable to decode token`, obwohl der Key an der REST-API (`/api/auth.info`) 200 liefert. Wahrscheinliche Ursache: die Variable `${OUTLINE_API_KEY}` wird von der Desktop-App nicht aus `~/.zshenv` geerbt, der Header enthält dann den unaufgelösten Platzhalter. Außerdem setzt ein gesetzter `Authorization`-Header den OAuth-Fallback außer Kraft. ## Lösung (nach Outline-Doku, https://docs.getoutline.com/s/guide/doc/mcp-6j9jtENNKL) Standard ist OAuth: `.mcp.json` nur mit `type: http` und `url` (`https://outline.cshomelabs.work/mcp`), Anmeldung per OAuth-Ablauf. Kein Key in Umgebungsvariablen nötig. Voraussetzung: MCP im Workspace aktiviert (Settings → Workspace → AI). ## Akzeptanz - [ ] `headers`-Block aus `.mcp.json` entfernt - [ ] README: `OUTLINE_API_KEY`-Abschnitt durch OAuth-Hinweis ersetzt (API-Key nur als Alternative) - [ ] Verbindung mit Anmeldung geprüft, Tools erscheinen als `mcp__outline__*`