33 lines
1.3 KiB
Markdown
33 lines
1.3 KiB
Markdown
# 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.
|