# MCP-Server

Stand **19.10.2026**. Agenten steuern Grotti nur über die HTTP-API mit einem API-Token.

Beim Connect bekommt der Client die Server-Anweisung aus `grotti/mcp_server.py` (`INSTRUCTIONS`): Deutsch antworten, Host und Datei-id nachschlagen, erst lesen dann schreiben, `confirm=true` nur auf klaren Wunsch, Warteschlange vor Sofortstart, Filament-Pause nicht blind fortsetzen, `clear_bed` ist nur eine Quittung, kein G-code und kein Firmware-Restart.

## 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.