Transportes
O Servidor MCP do Lore suporta dois modos de transporte.
stdio (Local)
O transporte stdio é usado quando o AI harness inicia o Servidor MCP como um subprocesso. Ideal para setups de desenvolvimento local.
Ainda não distribuído. O
lore-mcpnão tem um binário público pra baixar hoje — esta seção documenta o transporte como referência; ainda não é um caminho de instalação suportado. Até que seja, conecte pelo transporte hospedadohttp(veja Configurar Servidor MCP).
Configuração (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"
}
}
}
}Inicialização:
lore-mcp --transport stdioStreamable HTTP (Hospedado)
O transporte http implementa o transporte Streamable HTTP da spec MCP (revisão 2025-03-26 em diante) — um único endpoint usado pelo Servidor MCP hospedado em mcp.lore.infraestrutura.app. Isso substitui o antigo transporte “HTTP+SSE”, já descontinuado.
A autenticação é OAuth 2.1 (Dex como authorization server, lore-mcp como client público pré-registrado), não um header estático com bearer token — veja Configurar Servidor MCP para o passo a passo real de conector/claude mcp add por cliente. Pacotes públicos funcionam sem nenhum token; o client só precisa completar o OAuth para acessar namespaces privados.
Deploy auto-hospedado:
lore-mcp --transport http --port 8080Auto-hospedar via http também exige LORE_MCP_PUBLIC_URL e LORE_MCP_AUTH_ISSUER (veja abaixo) — o lore-mcp recusa iniciar sobre HTTP sem os dois, já que são exatamente o que ele anuncia no seu documento de descoberta /.well-known/oauth-protected-resource.
Variáveis de Ambiente
| Variável | Descrição | Padrão |
|---|---|---|
LORE_AUTH_TOKEN | Token estático para autenticação no registry — usado pelo stdio (não há identidade de chamador por requisição pra vincular); ignorado pelo http, que encaminha o próprio token OAuth de cada chamador | — |
LORE_REGISTRY_URL | URL base do registry | https://registry.lore.infraestrutura.app |
LORE_TARGET | Target de renderização padrão (claude, cursor, copilot, codex, gemini, raw) | Auto-detectado a partir do client, com fallback para raw |
LORE_DEFAULT_LANG | Idioma padrão do conteúdo (BCP 47) | en-US |
LORE_ORG | Escopo de org padrão para resolução de namespace | — |
LORE_CACHE_TTL | TTL do cache de conteúdo, em segundos | 300 |
LORE_MCP_PUBLIC_URL | URL pública deste servidor — só para o transporte http | — |
LORE_MCP_AUTH_ISSUER | O issuer OIDC (Dex) contra o qual os chamadores se autenticam — só para o transporte http | — |