Configurar Servidor MCP
Conecte seu AI harness ao Lore via Model Context Protocol (MCP). O Servidor MCP do Lore está hospedado em mcp.lore.infraestrutura.app, usando o transporte Streamable HTTP da spec MCP (revisão 2025-03-26 em diante) — não o antigo transporte “HTTP+SSE”, que já foi descontinuado.
Hoje essa conexão é só remota: Claude Desktop, claude.ai, Claude Code, GitHub Copilot (VS Code Desktop e Copilot CLI), OpenAI Codex CLI, ChatGPT e Cursor falam direto com o servidor hospedado e fazem login através do Dex. Sem token pra copiar, sem nada pra instalar. Existe um caminho local (stdio) — rodar o binário lore-mcp na sua própria máquina — no código-fonte, mas ele ainda não é distribuído, então não está documentado aqui.
Claude Desktop / claude.ai
- Abra Settings → Connectors → Add custom connector.
- Defina a URL como:
Pertence a mais de uma org e quer que toda chamada de tool nesse conector já saia com escopo em uma delas, sem passar
https://mcp.lore.infraestrutura.app/mcp?auth=requiredorgtoda vez? Adicione?org=<slug>&auth=requiredna URL, por exemplohttps://mcp.lore.infraestrutura.app/mcp?org=laca&auth=required. Isso é opcional — veja Escopando uma conexão a uma org abaixo. - Em Authentication, escolha Sign in now (as ferramentas públicas funcionam sem login, mas essa opção já conecta o caminho de namespaces privados no mesmo passo, em vez de depender de um prompt que pode não aparecer sozinho — veja a nota abaixo).
- Em OAuth Client, escolha Use your own OAuth client e defina:
Deixe o campo de segredo em branco — o
Client ID: lore-mcplore-mcpé um client público. - Continue — você vai cair na tela de login do Lore (GitHub, ou o SSO da sua org, se configurado). Complete o login e o conector está pronto.
Por que “Sign in now” em vez de “Log in when needed”?
O lore-mcp encaminha qualquer credencial que tiver diretamente pro Registry, e só o Registry decide se uma chamada é aceita — o lore-mcp em si nunca emite seu próprio desafio 401 pra uma chamada específica. Na prática, isso significa que uma chamada em namespace privado que falha não necessariamente dispara um prompt de login do Claude na hora; ela só volta com uma mensagem de “unauthorized” no resultado da tool. Escolher Sign in now evita esse problema autenticando logo de cara. Pacotes públicos funcionam dos dois jeitos.
O que o auth=required faz?
auth=required faz?Ele faz a sua ferramenta de IA pedir login no momento da conexão. Com auth=required, o lore-mcp responde a primeira requisição de conexão com o desafio OAuth padrão (HTTP 401 apontando pra /.well-known/oauth-protected-resource), então Claude Code, Cursor, Codex e Copilot iniciam o login na hora, e um login expirado é renovado em vez de a sessão seguir sem ele. Sem o parâmetro, o conector continua funcionando, mas de forma anônima: pacotes públicos podem ser lidos, e tudo que precisa da sua identidade (namespaces privados, memória da org, publicação de pacotes) falha com uma mensagem pedindo pra reconectar. Uma chamada anônima que indica uma org (no org ou pelo ?org= da URL) continua trazendo os pacotes públicos dessa org, e termina com um aviso de que o conector não está logado e de que as Rules obrigatórias e a memória da org não foram entregues. Pra combinar com o escopo de org, use ?org=<slug>&auth=required.
Claude Code
O mesmo conector que o Claude Desktop usa, via claude mcp add:
claude mcp add -s user --transport http lore "https://mcp.lore.infraestrutura.app/mcp?auth=required"O Claude Code se identifica sozinho, então não precisa informar client ID nem porta de callback; o navegador abre o login do Lore assim que ele conecta. Instruções antigas usavam --callback-port 8090; conectores configurados assim continuam funcionando.
Pra escopar essa conexão a uma org (veja Escopando uma conexão a uma org abaixo), adicione ?org=<slug>&auth=required na URL: https://mcp.lore.infraestrutura.app/mcp?org=laca&auth=required.
Onde instalar no Claude Code
O claude mcp add guarda o conector em um de três escopos. Escolha um:
| Escopo | Flag | Onde fica | Vale em |
|---|---|---|---|
| Usuário (recomendado) | -s user | ~/.claude.json | Qualquer diretório, pra sua conta neste computador |
| Local (padrão do Claude Code) | -s local ou sem flag | ~/.claude.json, por diretório | Só no diretório em que o comando rodou |
| Projeto | -s project | .mcp.json na raiz do repositório | Todo mundo que abrir o repositório (versionado no git) |
Sem -s user, o conector só existe no diretório em que você rodou o comando. Se ele ficou lá por engano, remova essa cópia com claude mcp remove -s local lore no mesmo diretório.
Pra um time, versione um .mcp.json no repositório:
{
"mcpServers": {
"lore": {
"type": "http",
"url": "https://mcp.lore.infraestrutura.app/mcp?org=<sua-org>&auth=required"
}
}
}Cada pessoa continua fazendo login com a própria conta do Lore; o arquivo guarda só a URL, nunca um token.
Para administradores de TI: configuração para o computador inteiro (managed-mcp.json)
managed-mcp.json)O Claude Code também lê um arquivo do sistema, distribuído por um administrador (por exemplo via MDM):
- macOS:
/Library/Application Support/ClaudeCode/managed-mcp.json - Linux/WSL:
/etc/claude-code/managed-mcp.json - Windows:
C:\Program Files\ClaudeCode\managed-mcp.json
Esse arquivo é exclusivo. Quando ele existe, substitui todos os servidores MCP configurados pelos usuários daquele computador (não há mesclagem), e o claude mcp add deixa de funcionar. Todos os conectores de que as pessoas precisam têm que estar nele, não só o Lore. A documentação do Claude Code não confirma que o bloco oauth (e, portanto, a porta de callback fixa que o Lore exige) é aceito nesse arquivo; teste o login numa máquina piloto antes de distribuir. Pra maioria das organizações, distribuir o comando -s user acima é a opção mais segura.
GitHub Copilot
VS Code Desktop
Rode MCP: Add Server na Command Palette, escolha HTTP e preencha:
Server name: lore
Server URL: https://mcp.lore.infraestrutura.app/mcp?auth=requiredDeixe Headers e OAuth Client ID em branco — o VS Code descobre o lore-mcp automaticamente via seu Client ID Metadata Document, e o timeout padrão de requisição já serve.
Copilot CLI
Pelo terminal:
copilot mcp add lore "https://mcp.lore.infraestrutura.app/mcp?auth=required"Deixe o OAuth Client ID em branco — o Copilot CLI descobre o lore-mcp do mesmo jeito que o VS Code.
O Copilot CLI tem bugs conhecidos upstream de binding de porta (github/copilot-cli#4793 , #4795 , #4800 ) que podem causar falha intermitente no callback OAuth — isso não é um problema do lado do Lore. O VS Code Desktop não é afetado.
OpenAI Codex CLI
Adicione o conector ao ~/.codex/config.toml:
[mcp_servers.lore]
url = "https://mcp.lore.infraestrutura.app/mcp?auth=required"Depois rode codex mcp login lore. O Codex se identifica sozinho, então não precisa de client ID nem de porta de callback. Configurações antigas com client_id = "lore-mcp" e mcp_oauth_callback_port = 8092 em [mcp_servers.lore.oauth] continuam funcionando.
Cursor
O Cursor não tem descoberta automática de client OAuth — adicione o conector ao mcp.json com um client ID explícito:
{
"mcpServers": {
"lore": {
"url": "https://mcp.lore.infraestrutura.app/mcp?auth=required",
"auth": {
"CLIENT_ID": "lore-mcp"
}
}
}
}Sem client secret — o lore-mcp é um client público.
ChatGPT
Nas configurações de conectores do ChatGPT (modo desenvolvedor), crie um conector com a URL https://mcp.lore.infraestrutura.app/mcp e autenticação OAuth. O ChatGPT se identifica sozinho, então deixe o client ID e o secret vazios. Funciona a partir de qualquer conta ou workspace do ChatGPT; o navegador abre o login do Lore quando você conecta.
Para que as Rules obrigatórias da sua org sejam carregadas no início de toda conversa, use https://mcp.lore.infraestrutura.app/mcp?org=<slug>&auth=required. O conector então orienta o ChatGPT a chamar o lore_context primeiro. O ChatGPT guarda essa orientação até o conector ser atualizado, então atualize-o nas configurações de conectores depois de mudar a URL.
Gemini CLI
Ainda sem suporte. O Gemini CLI só fala com um servidor MCP via stdio hoje, e o Lore ainda não distribui um binário pronto pra isso — veja a nota no topo desta página. Skills publicadas no Lore ainda chegam até ele via lore pull (o caminho de instalação local da CLI); veja a documentação da CLI.
Entrando: GitHub ou conta da empresa
Quando a sua ferramenta de IA abre a tela de entrada do Lore, você escolhe como entrar:
- Continuar com GitHub, para uso pessoal e da comunidade.
- Conta da empresa: digite o seu e-mail corporativo. Se a organização da sua empresa no Lore configurou o login pelo Microsoft Entra ID (365), o Lore o encontra pelo domínio do seu e-mail e leva você direto ao login da empresa. O e-mail é usado só para essa busca e nunca é armazenado.
O Lore lembra a sua última escolha neste navegador e a oferece primeiro da próxima vez. Para pular a escolha, escope o conector à sua org com ?org=<slug> (veja abaixo). Assim a ferramenta vai direto ao login da sua organização: o da empresa, quando configurado, ou o GitHub.
Escopando uma conexão a uma org
Se você pertence a mais de uma org, toda chamada de tool cai no namespace flat/global por padrão, a menos que você diga o contrário. Duas formas de escopar uma sessão a uma org, só no transporte hospedado (http):
- Por chamada — passe
org: "<slug>"em qualquer chamada individual delore_get/lore_search/lore_list/lore_resolve. - Por conexão — adicione
?org=<slug>&auth=requiredna URL do conector (veja as seções do Claude Desktop e do Claude Code acima). Esse valor é capturado uma única vez, na primeira chamada do conector, e fica fixo pelo tempo de vida daquela conexão — não existe tool nem troca no meio da sessão pra mudar isso, então uma sessão que precisa trabalhar em duas orgs precisa de um segundo conector.
Não sabe qual slug usar? Chame a tool lore_orgs — ela lista todas as orgs às quais você pertence e seu papel em cada uma. Se você for membro de mais de uma org e ainda não tiver escopado sua conexão, as respostas das tools também trazem uma dica de uma linha lembrando que lore_orgs e ?org=<slug>&auth=required existem.
Acesso escopado a uma org exige que aquela org esteja num plano Pro ativo. Se ela estiver no tier free, uma chamada escopada àquela org (por qualquer um dos métodos acima) falha com uma mensagem apontando pra fazer upgrade — conteúdo público não é afetado de nenhuma forma, e a lore_orgs em si sempre funciona independente de plano, então você sempre consegue checar a quais orgs pertence.
Tools Disponíveis
| Tool | Descrição |
|---|---|
lore_get | Recupera o conteúdo completo de um pacote, renderizado para o runtime alvo ativo |
lore_search | Busca no registry por pacotes que combinem com uma consulta |
lore_resolve | Dado um objetivo em linguagem natural, encontra e pré-busca os pacotes mais relevantes |
lore_list | Lista pacotes em um namespace, ou pacotes públicos recentes |
lore_versions | Lista todas as versões publicadas de um pacote |
lore_orgs | Lista as orgs às quais você pertence, e seu papel em cada uma |
lore_context | Carrega o contexto da org: as Rules e Skills obrigatórias, depois a memória mais relevante (só no conector hospedado) |