Agents : MCP et skill

Une décision prend environ 10 ms et ne coûte rien, donc un agent peut en prendre une avant chaque étape de routage, de triage, de modération ou d’escalade. Ollaya donne deux choses aux agents :

Un serveur MCP, ollaya mcp, qui expose les modèles locaux comme des outils.
Un skill d’agent, ollaya-decisions, qui apprend à un agent quand une décision typée vaut mieux qu’un raisonnement en texte, comment écrire de bonnes questions et comment agir sur les probabilités.

Serveur MCP

ollaya mcp parle le Model Context Protocol sur stdio. Il dialogue avec le serveur local comme toute autre commande et le démarre quand il ne tourne pas.

Claude Code

claude mcp add ollaya -- ollaya mcp

Claude Desktop

Ajoute-le à claude_desktop_config.json (Settings → Developer → Edit Config) :

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

Si Claude Desktop ne trouve pas ollaya, utilise son chemin complet, par exemple /usr/local/bin/ollaya ou ~/.local/bin/ollaya.

Cursor, VS Code et d’autres clients

Utilise la même commande, ollaya mcp, dans les réglages MCP du client : .cursor/mcp.json pour Cursor, .vscode/mcp.json pour VS Code (avec "type": "stdio").

Sur HTTP

Pour les clients qui se connectent par le réseau, sers plutôt du HTTP streamable :

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

Par défaut, il n’accepte que les hôtes de bouclage.

Outils

Outil	Ce qu’il fait
`decide`	Répond à des questions typées sur un état. Arguments : `state` (une chaîne ou n’importe quel JSON), `questions` ou `preset`, et `model` (par défaut `laya`). Le résultat est exactement ce que renvoie `POST /v1/systemone`.
`list_models`	Les modèles de cette machine, comme `ollaya list`.
`show_model`	Les détails, les capacités, la licence et les questions intégrées d’un modèle.
`pull_model`	Télécharge un modèle, avec des notifications de progression. `decide` télécharge aussi au premier usage.

Ressources

URI	Contenu
`ollaya://models`	Les modèles installés
`ollaya://presets/<name>`	Les questions d’un preset intégré : `triage`, `email`, `guard`, `moderation`, `router`, `agent`

Skill d’agent

Le skill est un SKILL.md que les agents prenant en charge Agent Skills, comme Claude Code, chargent quand une tâche l’exige. Il couvre le choix d’un modèle, l’écriture de questions choice, score et noul, les presets, les seuils de confiance pour agir ou escalader, et l’appel d’Ollaya via MCP, la CLI ou HTTP.

Installe-le dans un projet (ou ajoute -g pour tous les projets) :

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

Il est aussi livré avec chaque version, dans share/ollaya/skills/ollaya-decisions/ à côté du binaire (/usr/local/share/ollaya/skills/ pour une installation système), donc tu peux le copier dans .claude/skills/ sans réseau.

Le skill fonctionne aussi tout seul : un agent avec seulement le skill et ollaya installés appelle la CLI.