Agent：MCP 与 skill

一次决策大约花 10 毫秒，而且不花钱，所以 agent 可以在每一次路由、分流、审核或升级步骤之前做一次。Ollaya 给 agent 两样东西：

一个 MCP 服务器，ollaya mcp，它把本地模型暴露成工具。
一个 agent skill，ollaya-decisions，它教 agent 什么时候类型化决策胜过用文本推理、怎么写出好问题，以及怎么依据概率行动。

MCP 服务器

ollaya mcp 通过 stdio 说 Model Context Protocol。它像其他所有命令一样与本地服务器通信，并在它没运行时把它启动起来。

Claude Code

claude mcp add ollaya -- ollaya mcp

Claude Desktop

把它加进 claude_desktop_config.json（Settings → Developer → Edit Config）：

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

如果 Claude Desktop 找不到 ollaya，就用它的完整路径，例如 /usr/local/bin/ollaya 或 ~/.local/bin/ollaya。

Cursor、VS Code 与其他客户端

在客户端的 MCP 设置里用同一条命令 ollaya mcp：Cursor 用 .cursor/mcp.json，VS Code 用 .vscode/mcp.json（带 "type": "stdio"）。

走 HTTP

对于通过网络连接的客户端，改为提供可流式传输的 HTTP：

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

默认情况下它只接受回环地址。

工具

工具	作用
`decide`	就一个状态回答类型化问题。参数：`state`（一个字符串或任意 JSON）、`questions` 或 `preset`，以及 `model`（默认 `laya`）。结果与 `POST /v1/systemone` 返回的完全一样。
`list_models`	本机上的模型，类似 `ollaya list`。
`show_model`	某个模型的详情、能力、许可证和内置题目。
`pull_model`	下载一个模型，带进度通知。`decide` 也会在首次使用时拉取。

资源

URI	内容
`ollaya://models`	已安装的模型
`ollaya://presets/<name>`	一个内置预设的题目：`triage`、`email`、`guard`、`moderation`、`router`、`agent`

Agent skill

这个 skill 是一个 SKILL.md，支持 Agent Skills 的 agent（例如 Claude Code）在任务需要时会加载它。它涵盖挑选模型、编写 choice、score 和 noul 问题、预设、用于行动或升级的置信度阈值，以及通过 MCP、CLI 或 HTTP 调用 Ollaya。

把它装进一个项目（或加 -g 装到每个项目）：

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

它也随每个发行版一起提供，位于二进制文件旁边的 share/ollaya/skills/ollaya-decisions/（系统安装则是 /usr/local/share/ollaya/skills/），所以你可以不联网把它复制进 .claude/skills/。

这个 skill 也能单独工作：只装了该 skill 和 ollaya 的 agent 会调用 CLI。