spec 1.0 · referência

Servidor MCP

Tradução assistida por agentes de IA. Em caso de divergência, prevalece a página em inglês. Se você encontrar algum problema no texto, abra uma issue ou envie um pull request.

As ferramentas do Leji estão disponíveis de duas formas. A CLI atende você e o seu CI; o servidor do Model Context Protocol (MCP) é para o seu agente.

@leji-org/mcp é um servidor MCP local que encapsula o SDK de referência. Com ele, seu agente lê a especificação e os schemas, valida uma camada de contexto em disco e pontua a conformidade dela, sem consultar o site nem chamar a CLI pelo shell.

Ele roda localmente sobre stdio e não faz chamadas de rede em tempo de execução, embora a primeira instalação por npx baixe o pacote, e expõe apenas ferramentas somente leitura.

Adicione ao seu cliente

Basta configurar uma vez para que as ferramentas leji apareçam em todas as sessões abrangidas pelo escopo, sem nenhuma outra preparação: um registro no nível do usuário alcança todos os projetos; um registro no nível do projeto alcança apenas aquele repositório. O cliente inicia leji-mcp sob demanda.

Se você está adotando com a CLI e o Claude Code ou o Codex está no seu PATH, leji init e leji adopt oferecem a opção de registrar este servidor para aquele host antes de repassar o trabalho ao seu agente.

Como a oferta é interativa, uma execução com --yes a ignora. As instruções a seguir são para quem pulou o prompt, usa outro cliente ou deseja um escopo diferente.

Claude Code

claude mcp add leji --scope project -- npx -y @leji-org/mcp

--scope project grava o .mcp.json compartilhado na raiz do repositório; faça o commit desse arquivo para que todos que clonarem o repositório recebam a oferta do servidor. Para configurar o seu usuário em todos os projetos, em vez disso:

claude mcp add leji --scope user -- npx -y @leji-org/mcp

Omitir --scope registra o servidor de forma privada, só para este projeto. Referência completa: documentação de MCP do Claude Code.

Codex

codex mcp add leji -- npx -y @leji-org/mcp

Ou adicione uma tabela [mcp_servers.leji] diretamente ao ~/.codex/config.toml. Referência completa: documentação de MCP do Codex.

Outros clientes

Claude Desktop, Cursor, Windsurf e qualquer outro cliente MCP aceitam a configuração padrão:

{
  "mcpServers": {
    "leji": { "command": "npx", "args": ["-y", "@leji-org/mcp"] }
  }
}

Requer Node.js 22 ou mais novo (npx vem com o Node). A primeira execução baixa o pacote; as demais usam o cache. Aponte cada ferramenta para a raiz do repositório que contém o seu leji.json.

Ferramentas

Todas são somente leitura. Nenhum recurso exposto pelo servidor pode escrever na sua camada de contexto ou alterá-la.

Ferramentas MCP que o servidor expõe
Ferramenta	O que ela devolve
`search_spec`	Seções da especificação que correspondem a uma consulta.
`fetch_spec_doc`	Um documento da especificação (ou a especificação inteira).
`fetch_schema`	Um JSON Schema.
`validate_manifest`	Valida um leji.json fornecido em linha.
`validate_layer`	Valida a camada de contexto em um caminho.
`score_conformance`	Comparação entre o nível de conformidade declarado e o verificado.
`explain_conformance`	O que foi verificado e o que o próximo nível exige.

Recursos

Recursos MCP que o servidor expõe
URI	O que ele serve
`leji://spec/full`	A especificação completa, em um documento.
`leji://spec/{id}`	Um documento da especificação, por exemplo leji://spec/conformance.
`leji://schema/{name}`	Um JSON Schema, por exemplo leji://schema/context-manifest.
`leji://cli/help`	A referência de comandos e opções da CLI leji.

Por que um servidor, e não só a CLI?

A CLI já valida e pontua uma camada de contexto, e o servidor oferece as duas funções. Além disso, ele faz o que a CLI não faz: busca e fornece a especificação e os schemas. Também oferece uma interface diferente, que um agente procura por conta própria:

Ele se anuncia sozinho. Configurado uma vez, aparece na lista de ferramentas do seu agente em todas as sessões, com descrições exatas do que faz. Ninguém precisa avisar ao agente que Leji existe nem onde encontrar a CLI.
Ele funciona onde um shell não funciona. Muitos ambientes de agente não podem ou não devem executar comandos arbitrários. Um servidor somente leitura, sem chamadas de rede em tempo de execução, pode ser acessado mesmo onde leji validate não pode ser executado.
Ele serve a especificação e os schemas diretamente. Seu agente os lê como recursos, sem busca na web, e os cita enquanto trabalha.

Consumir uma camada de contexto não precisa do servidor: o perfil de boot de um repositório conforme já integra o seu agente. O servidor atende à outra necessidade: aprender Leji e verificar se uma camada de contexto está de acordo com ele.