Install
The engine and the console come up together. No external database is required to start.
With Docker
$ git clone https://github.com/Tegence/synaxis-engine $ cd synaxis-engine $ cp backend/.env.example backend/.env $ docker compose up --build engine listening on :8080 console listening on :3000 store json file (set ENGINE_ENCRYPTION_KEY to encrypt at rest) ready http://localhost:8080/mcp
The console is on port 3000 and the MCP endpoint on 8080. Accounts persist in the named volume, so a rebuild keeps them. The bundled compose file runs ENGINE_DEVELOPMENT_MODE=true: it prints a temporary password and signing secret in the logs, and is intentionally disposable.
From source
$ cd backend && go run ./cmd/engine $ cd frontend && npm install && npm run dev
Requires Go 1.25 and Node if you prefer to build it rather than run the published images.
Required configuration
ENGINE_ISSUER | Public HTTPS base. The connector URL is this plus /mcp. |
ENGINE_PASSWORD | Gates the console and the OAuth consent page. |
ENGINE_SECRET | HMAC key for access and session tokens. |
ENGINE_ENCRYPTION_KEY | 32-byte key, base64-encoded. Encrypts credentials and recorded payloads at rest. |
DATABASE_URL | Optional. Without it, accounts live in a JSON file. |
ENGINE_ISSUER must be reachable by claude.ai over public HTTPS. Localhost works for the console, but Claude cannot complete a consent flow against it.