Agentes: MCP e skill

Uma decisão demora cerca de 10 ms e não custa nada, por isso um agente pode tomar uma antes de cada passo de encaminhamento, 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. Fala com o servidor local como qualquer outro comando e inicia-o quando este não está em execução.

Claude Code

claude mcp add ollaya -- ollaya mcp

Claude Desktop

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

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

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

Cursor, VS Code e outros clientes

Usa o mesmo comando, ollaya mcp, nas definiçõ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 ligam pela rede, serve, em vez disso, HTTP em streaming:

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

Por predefinição, só aceita anfitriões de loopback.

Ferramentas

Ferramenta	O que faz
`decide`	Responde a perguntas tipadas sobre um estado. Argumentos: `state` (uma cadeia ou qualquer JSON), `questions` ou `preset`, e `model` (predefinição `laya`). O resultado é exatamente o que `POST /v1/systemone` devolve.
`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`	Transfere um modelo, com notificações de progresso. `decide` também transfere 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 os agentes compatíveis com Agent Skills, como o Claude Code, carregam quando uma tarefa o exige. Abrange escolher um modelo, escrever perguntas choice, score e noul, os presets, limiares de confiança para agir ou escalar, e chamar o Ollaya por MCP, a CLI ou HTTP.

Instala-a num projeto (ou adiciona -g para todos os projetos):

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

Também é fornecida 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), por isso podes 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.