Grotti 2.2.0: Auth, API-Tokens, MCP und Doku-Trennung.

docs/internal/MCP.md

@@ -0,0 +1,30 @@
+# MCP-Server
+
+Stand **15.10.2026**. Agenten steuern Grotti nur über die HTTP-API mit einem API-Token.
+
+## Start
+
+```powershell
+$env:GROTTI_URL = "http://127.0.0.1:8770"
+$env:GROTTI_TOKEN = "grt_…"   # unter Einstellungen → API-Tokens
+$env:GROTTI_MCP_READ_ONLY = "1"   # optional: nur lesen
+.\.venv\Scripts\pip install mcp
+.\.venv\Scripts\python.exe -m grotti.mcp_server
+```
+
+## Tools
+
+| Tool | Schreibend | Confirm |
+| --- | --- | --- |
+| `list_printers`, `get_printer`, `list_running`, `list_queue`, `list_events`, `list_files`, `list_spools`, `get_version` | nein | — |
+| `pause_printer`, `resume_printer` | ja | — |
+| `cancel_printer`, `clear_bed`, `enqueue_*` | ja | `confirm=true` |
+| `steer_temp`, `steer_speed`, `steer_fan` | ja | — |
+
+Nicht exponiert: freie G-code, Firmware-Restart, E-Stop, User/Token/Settings.
+
+## Sicherheit
+
+- Token mit Rolle Operator reicht für den Alltag; Admin-Token vermeiden.
+- Read-only-Flag für vorsichtige Agents.
+- Server ideal nur lokal; Grotti selbst hinter Login/TLS.