Transports
The Lore MCP Server supports two transport modes.
stdio (Local)
The stdio transport is used when the AI harness spawns the MCP Server as a subprocess. Best for local developer setups.
Not yet distributed.
lore-mcphas no public binary download today — this section documents the transport for reference; it isn’t a supported install path yet. Until it is, connect via the hostedhttptransport instead (see MCP Server Setup).
Configuration (Claude Code ~/.claude/settings.json):
{
"mcpServers": {
"lore": {
"command": "lore-mcp",
"args": ["--transport", "stdio"],
"env": {
"LORE_AUTH_TOKEN": "<token>",
"LORE_REGISTRY_URL": "https://registry.lore.infraestrutura.app"
}
}
}
}Startup:
lore-mcp --transport stdioStreamable HTTP (Hosted)
The http transport implements the MCP spec’s Streamable HTTP transport (spec revision 2025-03-26 and later) — a single endpoint used for the hosted MCP Server at mcp.lore.infraestrutura.app. This supersedes the older, deprecated “HTTP+SSE” transport.
Authentication is OAuth 2.1 (Dex as the authorization server, lore-mcp as a pre-registered public client), not a static bearer header — see MCP Server Setup for the actual connector/claude mcp add walkthrough per client. Public packages work with no token at all; the client only needs to complete OAuth for private-namespace access.
Self-hosted deployment:
lore-mcp --transport http --port 8080Self-hosting over http additionally requires LORE_MCP_PUBLIC_URL and LORE_MCP_AUTH_ISSUER (see below) — lore-mcp refuses to start over HTTP without both, since they’re what it advertises in its /.well-known/oauth-protected-resource discovery document.
Environment Variables
| Variable | Description | Default |
|---|---|---|
LORE_AUTH_TOKEN | Static bearer token for registry auth — used by stdio (no per-request caller identity to scope to); ignored by http, which forwards each caller’s own OAuth token instead | — |
LORE_REGISTRY_URL | Registry base URL | https://registry.lore.infraestrutura.app |
LORE_TARGET | Default render target (claude, cursor, copilot, codex, gemini, raw) | Auto-detected from the client, falling back to raw |
LORE_DEFAULT_LANG | Default content language (BCP 47) | en-US |
LORE_ORG | Default org scope for namespace resolution | — |
LORE_CACHE_TTL | Content cache TTL, in seconds | 300 |
LORE_MCP_PUBLIC_URL | This server’s own public URL — http transport only | — |
LORE_MCP_AUTH_ISSUER | The OIDC issuer (Dex) callers authenticate against — http transport only | — |