Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DATA_DIRNoData directory for the JSON driver (and default location for the SQLite file)../data
MONGODB_DBNoMongoDB database name.mcpocket
MONGODB_URINoMongoDB connection URI when `STORAGE_DRIVER=mongo`.
SQLITE_FILENoSQLite database file when `STORAGE_DRIVER=sqlite`. Defaults to `DATA_DIR/mcpocket.db`.
MCPOCKET_PORTNoPort for the dashboard, REST and MCP endpoints.3000
STORAGE_DRIVERNoStorage driver: `json` (default), `sqlite`, or `mongo`.json
MCPOCKET_API_KEYSNo`keyId:secret` pairs (comma/newline separated) for REST/MCP clients. Alternatively, create managed keys on the dashboard's Access page.
MCPOCKET_WORKSPACENoWorkspace (tenant) slug this instance serves. Defaults to `MCPOCKET_SSO_WORKSPACE`.
MCPOCKET_OAUTH_CLAIMNoName of the OAuth grant claim.mcpocket
MCPOCKET_OAUTH_ISSUERNoExact `iss` of accepted OAuth access tokens; set to enable OAuth for MCP clients (e.g. ChatGPT connectors).
MCPOCKET_API_KEY_ROLESNo`keyId:role` pairs for env API keys, e.g. `ci:readonly,bots:agent`.
MCPOCKET_COOKIE_SECURENoSet to `false` only when serving production over plain HTTP. Default is `true` in production.true
MCPOCKET_LEASE_SECONDSNoDefault lease duration for claim / heartbeat.300
MCPOCKET_RETRY_BACKOFFNoRetry backoff strategy: `exponential` or `fixed`.exponential
MCPOCKET_ADMIN_PASSWORDYesAdmin password. Required; without it the login page shows setup instructions and nobody can sign in. Compose refuses to start while it is empty.
MCPOCKET_ADMIN_USERNAMENoAdmin login name.admin
MCPOCKET_OAUTH_AUDIENCENoRequired `aud` claim in OAuth tokens (not checked when unset; Supabase: `authenticated`).
MCPOCKET_OAUTH_JWKS_URLNoSigning keys URL; defaults to `<issuer>/.well-known/jwks.json`.
MCPOCKET_SESSION_SECRETNoKey for signing session cookies (`openssl rand -base64 32`). Set it explicitly in production. Defaults to a value derived from the admin password.
MCPOCKET_MULTI_WORKSPACENoSet to `true` (requires `mongo`) to serve every workspace from one instance, with each request acting in the workspace of its credential.false
MCPOCKET_OAUTH_WORKSPACENoWorkspace slug the OAuth grant must name; unset = any. Defaults to `MCPOCKET_SSO_WORKSPACE`.
MCPOCKET_SWEEPER_ENABLEDNoSet to `false` to disable the background lease sweeper (claims still recover expired leases).true
MCPOCKET_SESSION_TTL_HOURSNoSession lifetime in hours.12
MCPOCKET_RETRY_MAX_ATTEMPTSNoTotal attempts (claims) per item; `1` = never retry.3
MCPOCKET_RETRY_DELAY_SECONDSNoBase retry delay in seconds.30
MCPOCKET_SEED_ON_FIRST_STARTNoSet to `true` to seed an empty volume/workspace from `mock/seed.json` on first start. Existing data is never touched. Set to `false` to start empty.true
MCPOCKET_API_KEY_DEFAULT_ROLENoRole of env API keys not listed in `MCPOCKET_API_KEY_ROLES`.admin
MCPOCKET_RATE_LIMIT_PER_MINUTENoRequests per API key per minute (managed keys may override; `0` = unlimited).600
MCPOCKET_RETRY_MAX_DELAY_SECONDSNoCap for the exponential retry delay in seconds.3600
MCPOCKET_SWEEPER_INTERVAL_SECONDSNoSeconds between sweeps (1..3600).15

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources