grotti/docs/internal/MCP.md

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

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