- 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
35 lines
1.9 KiB
Markdown
Executable file
35 lines
1.9 KiB
Markdown
Executable file
# Hinweise für Agenten
|
||
|
||
## macOS-Testbuild veröffentlichen
|
||
|
||
Beim Hochladen eines macOS-Builds auf den Webspace (programmschmiede.de):
|
||
|
||
- Neben der App-ZIP (`rinkplanner.zip`) auch `start_rinkplanner.command` mit
|
||
hochladen und auf der Startseite verlinken.
|
||
- **Das Start-Skript nicht zippen** – es wird direkt als `.command` abgelegt
|
||
und verlinkt. (Stand 2026-10-31 so vom Nutzer gewünscht.)
|
||
- Download-Links relativ zur `index.html` setzen, z. B.
|
||
`rinkplanner/download/rinkplanner.zip`.
|
||
|
||
## MCP-Werkzeuge
|
||
|
||
- **Godot:** `godot-mcp` steuert das Projekt über `--project rinkplanner/rinkplanner`.
|
||
Die Live-Editor-Werkzeuge brauchen das Addon `rinkplanner/addons/godot_ai_bridge`
|
||
(Port 6550, startet mit dem Editor).
|
||
- `godot_ai_bridge` ist eine Kopie aus `/opt/godot-mcp` **mit lokalem Patch**.
|
||
Beim Neukopieren den Patch aus `docs/findings-2026-11-01-godot-ai-bridge.md`
|
||
erneut anwenden, sonst meldet jeder `--import`-Lauf
|
||
„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.
|