Setup Guide — From Install to AI-Ready

The golden path

flexx setup
flexx connect          # or: flexx service install

flexx setup handles authentication and registration only. It does not start the daemon. After setup, start a connection with one of:

What flexx setup does

1. Authenticate — browser login or API key from the dashboard
2. Register — registers this machine as a remote
3. MCP config — prints the JSON to paste into your AI agent

Example output

  Welcome to flexx.dev

  ✓ Already authenticated
  Registering this machine as "dev-laptop"...
  ✓ Remote registered (ID: a7f3c2e1)

  MCP Configuration:

  {
    "mcpServers": {
      "flexx": {
        "url": "https://relay.flexx.dev/v1/mcp",
        "headers": {
          "Authorization": "Bearer flexx_…"
        }
      }
    }
  }

  Next steps

    flexx service install   # always-on (recommended)
    flexx connect           # foreground session
    flexx connect --daemon  # background process

Step-by-step (manual)

If you prefer to run each step separately:

1. Authenticate

flexx auth login

Get your API key from Dashboard → Settings → API Keys.

2. Register this machine

flexx remote init

This registers your machine with the flexx API and saves the remote configuration to ~/.flexx/remote.json.

3. Start the daemon

flexx connect

Or run in the background:

flexx connect --daemon

Or install as a user service (starts on login):

flexx service install

4. Configure your AI agent

flexx mcp config

This prints the MCP JSON block. Paste it into your AI tool:

• Cursor — Settings → MCP → Add Server → paste the URL
• Claude Desktop — add to ~/.claude/mcp_servers.json
• ChatGPT — add as an MCP server endpoint
• Any MCP client — use https://relay.flexx.dev/v1/mcp

Or visit the dashboard for copy-paste configs tailored to each AI tool.

Install as system service

For the daemon to start automatically on login:

flexx service install

This creates:

• Linux — a systemd user unit
• macOS — a LaunchAgent
• Windows — a Task Scheduler task (user-level, no admin required)

Uninstall with flexx service uninstall.