rinkplanner/AGENTS.md
torsten 80dbb86bf4 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
2026-11-01 15:47:55 +01:00

1.9 KiB
Executable file
Raw Blame History

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.