Agents: MCP und Skill

Eine Entscheidung dauert etwa 10 ms und kostet nichts, also kann ein Agent vor jedem Routing-, Triage-, Moderations- oder Eskalationsschritt eine treffen. Ollaya gibt Agenten zwei Dinge:

Einen MCP-Server, ollaya mcp, der die lokalen Modelle als Tools bereitstellt.
Einen Agent-Skill, ollaya-decisions, der einem Agenten beibringt, wann eine typisierte Entscheidung besser ist als Schlussfolgern in Text, wie man gute Fragen schreibt und wie man auf die Wahrscheinlichkeiten reagiert.

MCP-Server

ollaya mcp spricht das Model Context Protocol über stdio. Er spricht mit dem lokalen Server wie jeder andere Befehl und startet ihn, wenn er nicht läuft.

Claude Code

claude mcp add ollaya -- ollaya mcp

Claude Desktop

Füge ihn zu claude_desktop_config.json hinzu (Settings → Developer → Edit Config):

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

Wenn Claude Desktop ollaya nicht findet, verwende den vollständigen Pfad, zum Beispiel /usr/local/bin/ollaya oder ~/.local/bin/ollaya.

Cursor, VS Code und andere Clients

Verwende denselben Befehl ollaya mcp in den MCP-Einstellungen des Clients: .cursor/mcp.json für Cursor, .vscode/mcp.json für VS Code (mit "type": "stdio").

Über HTTP

Für Clients, die über das Netzwerk verbinden, serviere stattdessen streamfähiges HTTP:

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

Standardmäßig akzeptiert er nur Loopback-Hosts.

Tools

Tool	Was es tut
`decide`	Beantwortet typisierte Fragen zu einem Zustand. Argumente: `state` (ein String oder beliebiges JSON), `questions` oder `preset` und `model` (Standard `laya`). Das Ergebnis ist genau das, was `POST /v1/systemone` zurückgibt.
`list_models`	Die Modelle auf diesem Rechner, wie `ollaya list`.
`show_model`	Die Details, Fähigkeiten, Lizenz und eingebauten Fragen eines Modells.
`pull_model`	Lädt ein Modell herunter, mit Fortschrittsbenachrichtigungen. `decide` lädt bei der ersten Verwendung ebenfalls herunter.

Ressourcen

URI	Inhalt
`ollaya://models`	Die installierten Modelle
`ollaya://presets/<name>`	Die Fragen eines eingebauten Presets: `triage`, `email`, `guard`, `moderation`, `router`, `agent`

Agent-Skill

Der Skill ist eine SKILL.md, die Agenten mit Unterstützung für Agent Skills, etwa Claude Code, laden, wenn eine Aufgabe es erfordert. Er behandelt die Wahl eines Modells, das Schreiben von choice-, score- und noul-Fragen, die Presets, Konfidenz-Schwellenwerte zum Handeln oder Eskalieren und den Aufruf von Ollaya über MCP, die CLI oder HTTP.

Installiere ihn in ein Projekt (oder füge -g für jedes Projekt hinzu):

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

Er wird außerdem mit jedem Release ausgeliefert, in share/ollaya/skills/ollaya-decisions/ neben dem Binary (/usr/local/share/ollaya/skills/ bei einer Systeminstallation), sodass du ihn ohne Netzwerk nach .claude/skills/ kopieren kannst.

Der Skill funktioniert auch allein: Ein Agent, der nur den Skill und ollaya installiert hat, ruft die CLI auf.