DE EN
Code & Deployment › AI Connector Setup

Setting Up the AI Connector

FlawDesk Code provides an MCP server (Model Context Protocol) through which an external AI client can directly access your server — read and write files, modify code, execute builds, start deployments, and run database queries.

Prerequisites

  • Access to a FlawDesk project with the Code Connector enabled
  • An AI client that supports MCP connections

1. Create a connector token

Every user creates their own token:

1. In FlawDesk: click the ⚙️ icon next to your email address at the bottom of the sidebar → Settings 2. Open the Connectors tab 3. Click + New 4. Enter a name (e.g. the name of the AI tool you want to connect) 5. Copy the displayed token immediately and save it in a password manager — it is only shown once in plain text 6. If lost: rotate the token, the old one is immediately invalidated

2. Add the connector in your AI client

Enter the MCP server URL in your AI client's connector settings. The URL including token is shown directly in the settings — format:

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

3. Understanding access rights

Which operations an AI client can perform depends on the workspace role of the user — the same permissions the user has in FlawDesk, the AI client has through its token. Permissions can be configured under Workspace Settings → Permissions → Code Connector.

⚠️ A token tied to a user with broad permissions has correspondingly broad access to the server. For production use, we recommend a dedicated user with a restricted role — see Securing SSH.

Available tools

  • flawdesk_code_search — find files, grep in projects
  • flawdesk_code_file — read, write, str_replace files
  • flawdesk_code_git — git status/diff/push
  • flawdesk_code_build — build modules
  • flawdesk_code_deploy — live deployment
  • flawdesk_code_mysql — queries against project database
  • flawdesk_code_exec — shell commands (security-filtered)
  • Plus ticket tools: get_task, create_task, update_task, list_tasks

Common issues

"Connector test failed" — token expired or entered incorrectly. Rotate the token and replace the URL in your AI client.

"Tools available but no access" — check project permissions: Project → ⚙️ → Tab "Code" → Section "FlawDesk Code".

"No tools listed" — check URL format: must contain ?token= as a query parameter.