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>

Client-spezifische Konfiguration

In FlawDesk öffnet der „Einrichten"-Button im Connectors-Tab einen geführten Assistenten, der die fertige Konfiguration pro Client anzeigt und einen Verbindungstest direkt nach dem Anlegen des Tokens anbietet. Die Snippets im Überblick:

Claude.ai / Claude Desktop

Einstellungen → Connectors → „+" → „Add custom connector". Connector-URL einfügen und mit „Add" bestätigen.

Cursor — ~/.cursor/mcp.json (global) oder .cursor/mcp.json (im Projekt):

{
  "mcpServers": {
    "flawdesk": {
      "url": "https://mcp.flawdesk.de/?token=<dein-token>"
    }
  }
}

VS Code — Befehlspalette → „MCP: Open User Configuration" (oder .vscode/mcp.json im Projekt):

{
  "servers": {
    "flawdesk": {
      "type": "http",
      "url": "https://mcp.flawdesk.de/?token=<dein-token>"
    }
  }
}

3. Zugriffsrechte verstehen

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

Jede Berechtigung kontrolliert eine eigene Klasse von Operationen:

| Berechtigung | Was sie erlaubt | |---|---| | Code-Tab & Branches anzeigen | Filetree lesen, Dateien lesen, git Status anzeigen | | Git-Schreibzugriff (push/clone/sync) | git push, clone, gitignore bearbeiten | | Builds auslösen | Module bauen, APK/IPA-Builds starten | | Deploy auslösen | Live-Deploy auf den Server | | MySQL-Queries ausführen | Datenbankzugriff über den Connector | | SSH-Konsole öffnen | Shell-Befehle über den Connector | | Connector-Config & Module verwalten | Dateien schreiben/löschen, Sticky-Files, Module konfigurieren |

Der Zugriff wird sowohl im Browser als auch direkt über den MCP-Token erzwungen — ein Token kann keine Operationen ausführen, für die die zugehörige Berechtigungsgruppe nicht konfiguriert ist.

Verfügbare Tools

Dateien & Code

• flawdesk_code_search — Dateien finden, grep in Projekten (Code-Tab anzeigen)
• flawdesk_code_file — Dateien lesen (Code-Tab anzeigen), schreiben/löschen/umbenennen (Connector-Config verwalten)
• flawdesk_code_sticky — Sticky-Files verwalten (Connector-Config verwalten)

Git

• flawdesk_code_git — git status/diff (Code-Tab anzeigen), push/clone/sync (Git-Schreibzugriff)
• flawdesk_code_gitignore — .gitignore bearbeiten (Git-Schreibzugriff)

Build & Deploy

• flawdesk_code_build — Module bauen (Builds auslösen)
• flawdesk_code_deploy — Live-Deploy (Deploy auslösen)

Server

• flawdesk_code_mysql — Queries gegen Projekt-Datenbank (MySQL-Queries ausführen)
• flawdesk_code_exec — Shell-Befehle (SSH-Konsole öffnen)

Connector-Konfiguration

• flawdesk_code_module — Module konfigurieren (Connector-Config verwalten)

Tickets

• get_task, list_tasks — Tickets lesen (Tickets sehen)
• create_task — Ticket erstellen (Tickets erstellen)
• update_task — Ticket bearbeiten (Eigene Tickets bearbeiten)
• delete_task — Ticket löschen (Tickets löschen)

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" — Berechtigungen des Nutzers prüfen: Workspace-Einstellungen → Berechtigungen → Gruppe des Nutzers bearbeiten.

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