DE EN
Code & Deployment › KI-Connector einrichten

KI-Connector einrichten

FlawDesk Code stellt einen MCP-Server (Model Context Protocol) bereit, über den ein externer KI-Client direkt auf deinen Server zugreifen kann — Dateien lesen und schreiben, Code ändern, Builds ausführen, Deploys starten, Datenbank-Queries laufen lassen.

Voraussetzungen

  • Zugriff auf ein FlawDesk-Projekt mit aktiviertem Code-Connector
  • Einen KI-Client der MCP-Verbindungen unterstützt

1. Connector-Token anlegen

Jeder Nutzer legt seinen eigenen Token an:

1. In FlawDesk: unten in der Sidebar auf das ⚙️-Icon neben deiner E-Mail-Adresse klicken → Einstellungen 2. Tab Connectors öffnen 3. + Neu klicken 4. Einen Namen vergeben (z.B. den Namen des KI-Tools das du verbinden willst) 5. Den angezeigten Token sofort kopieren und in einem Passwort-Manager speichern — er wird nur einmalig im Klartext angezeigt 6. Bei Verlust: Token rotieren, der alte wird sofort ungültig

2. Connector im KI-Client eintragen

Trage die MCP-Server-URL in deinem KI-Client unter den Connector-Einstellungen ein. Die URL inklusive Token wird dir direkt in den Einstellungen angezeigt — Format:

https://mcp.flawdesk.de?token=<dein-token>

3. Zugriffsrechte verstehen

Welche Operationen ein KI-Client durchführen darf hängt von der Workspace-Rolle des Nutzers ab — dieselben Rechte die der Nutzer in FlawDesk hat, hat auch der KI-Client über seinen Token. Die Berechtigungen sind unter Workspace-Einstellungen → Berechtigungen → Code-Connector konfigurierbar.

⚠️ Ein Token eines Nutzers mit weitreichenden Rechten hat entsprechend weitreichenden Zugriff auf den Server. Für den produktiven Einsatz empfehlen wir einen dedizierten Nutzer mit eingeschränkter Rolle — siehe SSH absichern.

Verfügbare Tools

  • flawdesk_code_search — Dateien finden, grep in Projekten
  • flawdesk_code_file — Dateien lesen, schreiben, str_replace
  • flawdesk_code_git — git status/diff/push
  • flawdesk_code_build — Module bauen
  • flawdesk_code_deploy — Live-Deploy
  • flawdesk_code_mysql — Queries gegen Projekt-Datenbank
  • flawdesk_code_exec — Shell-Befehle (security-filtered)
  • Plus Ticket-Tools: get_task, create_task, update_task, list_tasks

Häufige Probleme

"Connector test failed" — Token abgelaufen oder falsch eingetragen. Token rotieren und URL im KI-Client ersetzen.

"Tools verfügbar aber kein Zugriff" — Projekt-Berechtigungen prüfen: Projekt → ⚙️ → Tab "Code" → Sektion "FlawDesk Code".

"No tools listed" — URL-Format prüfen: muss ?token= als Query-Parameter enthalten.