diff --git a/.claude/agents/docs-writer.md b/.claude/agents/docs-writer.md
index 1b1df8f..b5ef57f 100644
--- a/.claude/agents/docs-writer.md
+++ b/.claude/agents/docs-writer.md
@@ -1,7 +1,7 @@
 ---
 name: docs-writer
 description: Technischer Redakteur. Hält die Projektdoku in Outline (Collection Shuffle) synchron mit Repo, Specs und ADRs, schreibt Changelog und Release Notes. Einsetzen nach gemergten Features, bei Releases und auf Wunsch.
-tools: Read, Grep, Glob, Write, Edit, mcp__outline__*, mcp__3f9ac702-fa59-4ed4-aa26-cece4fcf6d21__*, mcp__forgejo__*
+tools: Read, Grep, Glob, Write, Edit, mcp__outline__*, mcp__forgejo__*
 model: haiku
 ---
 
diff --git a/.mcp.json b/.mcp.json
index 6dc310a..517d5e6 100644
--- a/.mcp.json
+++ b/.mcp.json
@@ -18,6 +18,13 @@
       "type": "stdio",
       "command": "npx",
       "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "outline": {
+      "type": "http",
+      "url": "https://outline.cshomelabs.work/mcp",
+      "headers": {
+        "Authorization": "Bearer ${OUTLINE_API_KEY}"
+      }
     }
   }
 }
diff --git a/README.md b/README.md
index 01f8c71..4e60473 100644
--- a/README.md
+++ b/README.md
@@ -26,3 +26,13 @@ chmod +x .claude/hooks/*.sh scripts/*.sh
 git init -b main && git add . && git commit -m "chore: project scaffold"
 ```
 Danach weiter mit Phase 2 der Anleitung.
+
+## MCP-Zugänge einrichten
+Die Server in `.mcp.json` lesen ihre Zugangsdaten aus Umgebungsvariablen (nie ins Repo):
+
+| Variable | Zweck |
+|---|---|
+| `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__*`.