Agentes: MCP e skill

Uma decisão leva cerca de 10 ms e não custa nada, então um agente pode tomar uma antes de cada etapa de roteamento, triagem, moderação ou escalonamento. O Ollaya dá duas coisas aos agentes:

Um servidor MCP, ollaya mcp, que expõe os modelos locais como ferramentas.
Uma skill de agente, ollaya-decisions, que ensina a um agente quando uma decisão tipada supera o raciocínio em texto, como escrever boas perguntas e como agir com base nas probabilidades.

Servidor MCP

ollaya mcp fala o Model Context Protocol por stdio. Ele conversa com o servidor local como qualquer outro comando e o inicia quando ele não está em execução.

Claude Code

claude mcp add ollaya -- ollaya mcp

Claude Desktop

Adicione-o a claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "ollaya": { "command": "ollaya", "args": ["mcp"] }
  }
}

Se o Claude Desktop não encontrar ollaya, use o caminho completo, por exemplo /usr/local/bin/ollaya ou ~/.local/bin/ollaya.

Cursor, VS Code e outros clientes

Use o mesmo comando, ollaya mcp, nas configurações de MCP do cliente: .cursor/mcp.json para o Cursor, .vscode/mcp.json para o VS Code (com "type": "stdio").

Por HTTP

Para clientes que se conectam pela rede, sirva HTTP em streaming:

ollaya mcp --http                  # http://127.0.0.1:11436/mcp
ollaya mcp --http 127.0.0.1:9000   # another address

Por padrão, ele só aceita hosts de loopback.

Ferramentas

Ferramenta	O que faz
`decide`	Responde a perguntas tipadas sobre um estado. Argumentos: `state` (uma string ou qualquer JSON), `questions` ou `preset`, e `model` (padrão `laya`). O resultado é exatamente o que `POST /v1/systemone` retorna.
`list_models`	Os modelos nesta máquina, como `ollaya list`.
`show_model`	Os detalhes, as capacidades, a licença e as perguntas integradas de um modelo.
`pull_model`	Baixa um modelo, com notificações de progresso. `decide` também baixa no primeiro uso.

Recursos

URI	Conteúdo
`ollaya://models`	Os modelos instalados
`ollaya://presets/<name>`	As perguntas de um preset integrado: `triage`, `email`, `guard`, `moderation`, `router`, `agent`

Skill de agente

A skill é um SKILL.md que agentes compatíveis com Agent Skills, como o Claude Code, carregam quando uma tarefa exige. Ela cobre escolher um modelo, escrever perguntas choice, score e noul, os presets, limiares de confiança para agir ou escalonar, e chamar o Ollaya por MCP, a CLI ou HTTP.

Instale-a num projeto (ou adicione -g para todos os projetos):

npx skills add ollaya-dev/ollaya --skill ollaya-decisions

Ela também vem com cada versão, em share/ollaya/skills/ollaya-decisions/ ao lado do binário (/usr/local/share/ollaya/skills/ numa instalação do sistema), então você pode copiá-la para .claude/skills/ sem rede.

A skill também funciona sozinha: um agente com apenas a skill e o ollaya instalados chama a CLI.