Merge pull request 'chore(mcp): Outline-MCP per OAuth statt API-Key-Header' (#45) from chore/44-outline-mcp-oauth into main
All checks were successful
CI / flutter (push) Successful in 1m20s
CI / web-build (push) Successful in 54s
CI / supabase (push) Successful in 3s
CI / supabase-tests (push) Successful in 33s
CI / e2e (push) Successful in 2m45s

Reviewed-on: #45
This commit is contained in:
cschlaefke 2026-11-03 10:57:09 +00:00
commit f8774359ee
2 changed files with 5 additions and 7 deletions

View file

@ -21,10 +21,7 @@
}, },
"outline": { "outline": {
"type": "http", "type": "http",
"url": "https://outline.cshomelabs.work/mcp", "url": "https://outline.cshomelabs.work/mcp"
"headers": {
"Authorization": "Bearer ${OUTLINE_API_KEY}"
}
} }
} }
} }

View file

@ -28,11 +28,12 @@ git init -b main && git add . && git commit -m "chore: project scaffold"
Danach weiter mit Phase 2 der Anleitung. Danach weiter mit Phase 2 der Anleitung.
## MCP-Zugänge einrichten ## MCP-Zugänge einrichten
Die Server in `.mcp.json` lesen ihre Zugangsdaten aus Umgebungsvariablen (nie ins Repo): Forgejo liest seine Zugangsdaten aus Umgebungsvariablen (nie ins Repo):
| Variable | Zweck | | Variable | Zweck |
|---|---| |---|---|
| `FORGEJO_URL`, `FORGEJO_ACCESS_TOKEN` | Forgejo (Issues, PRs) | | `FORGEJO_URL`, `FORGEJO_ACCESS_TOKEN` | Forgejo (Issues, PRs) |
| `OUTLINE_API_KEY` | Outline (Doku). In Outline unter *Einstellungen → API* einen Schlüssel anlegen und z. B. in `~/.zshenv` als `export OUTLINE_API_KEY=…` setzen; Claude Code danach neu starten. |
Outline-Endpunkt: `https://outline.cshomelabs.work/mcp`. Ist zusätzlich ein Outline-Connector in der Claude-App aktiv, sind die Tools doppelt vorhanden; die Agents nutzen `mcp__outline__*`. **Outline** (`https://outline.cshomelabs.work/mcp`) meldet sich per OAuth an, ein Schlüssel in der Umgebung ist nicht nötig. In Claude Code `/mcp` öffnen, `outline` wählen und im Browser anmelden (Anleitung: https://docs.getoutline.com/s/guide/doc/mcp-6j9jtENNKL). Voraussetzung: MCP ist im Workspace aktiviert (*Settings → Workspace → AI*). Ist zusätzlich ein Outline-Connector in der Claude-App aktiv, sind die Tools doppelt vorhanden; die Agents nutzen `mcp__outline__*`.
Alternativ geht ein API-Schlüssel (*Einstellungen → API*) als Header `Authorization: Bearer ${OUTLINE_API_KEY}` im `outline`-Eintrag. Dann muss die Variable für den Prozess sichtbar sein, der Claude startet; ein gesetzter `Authorization`-Header schaltet OAuth aus.