docs: fal-MCP-Zugang fuer Agenten festhalten

- Bearer-Header {env:FAL_KEY} statt OAuth; der Browser-Login scheitert am
  lokalen Callback-Port, der Relay akzeptiert den API-Key direkt
- Key liegt in ~/.config/environment.d/90-fal.conf (600) und wird von
  ~/.bashrc vor dem Interaktiv-Guard gesourct
- Fehlerbild "needs authentication" und die zwei Befehle zum Beheben
  (import-environment, service restart) inklusive Rotation
- Hinweis auf kostenpflichtige run_model/submit_job-Aufrufe
This commit is contained in:
torsten 2026-11-01 15:47:55 +01:00
parent 53c8498bc5
commit 80dbb86bf4

View file

@ -22,3 +22,14 @@ Beim Hochladen eines macOS-Builds auf den Webspace (programmschmiede.de):
„6 ObjectDB instances leaked at exit".
- **Blender:** `mcp-for-blender` über `uvx`, Addon in
`~/.config/blender/5.2/scripts/addons/blender_mcp.py` (Port 9876).
- **fal:** Remote-Server `https://mcp.fal.ai/mcp-relay` (Streamable HTTP) mit
`Authorization: Bearer {env:FAL_KEY}` in `opencode.jsonc`. Kein OAuth nötig –
der Relay akzeptiert den API-Key als Bearer, der Browser-Login scheitert
dagegen oft am lokalen Callback-Port.
Der Key liegt in `~/.config/environment.d/90-fal.conf` (Modus 600), im
systemd-Format; `~/.bashrc` sourct dieselbe Datei vor dem Interaktiv-Guard.
Meldet fal `needs authentication`, fehlt dem OpenCode-Dienst die Variable:
`systemctl --user import-environment FAL_KEY && opencode service restart`.
Nach einer Key-Rotation ebenso: Datei anpassen, import-environment, Neustart.
`run_model` und `submit_job` lösen kostenpflichtige Generierungen aus – vorher
Modell und Preis nennen und die Zustimmung abwarten.