Getting started / Install

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_ISSUERPublic HTTPS base. The connector URL is this plus /mcp.
ENGINE_PASSWORDGates the console and the OAuth consent page.
ENGINE_SECRETHMAC key for access and session tokens.
ENGINE_ENCRYPTION_KEY32-byte key, base64-encoded. Encrypts credentials and recorded payloads at rest.
DATABASE_URLOptional. 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.