Oz MCP Setup
One-line setup for Oz, a version-aware documentation MCP server for coding agents.
npx tryoz setup
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
Oz gives agents a repeatable workflow for external library, SDK, framework, API, and package questions:
Without a documentation MCP, coding agents often answer from old training data, guess APIs, or mix docs from the wrong major version.
With Oz, your agent can ask for the current indexed documentation at the moment it needs context.
User: Add Next.js middleware auth for v15.
Agent: resolve-library-id -> /vercel/next.js
Agent: get-library-docs -> version v15, topic middleware auth
Agent: answers from retrieved docs instead of guessing.
npx tryoz setup is interactive by default:
The setup wizard:
oz-.tools/list.No login flow. No broad hidden patching. Use --all when you want to configure every supported agent.
# Interactive setup
oz setup
npx tryoz setup
# Non-interactive setup
npx tryoz setup --codex --claude --global --api-key oz-your-key
npx tryoz setup --all --project --api-key oz-your-key
# Remove Oz-owned config only
oz logout
npx tryoz remove
npx tryoz logout
npx tryoz remove --codex --claude --global
# Verify the remote MCP endpoint
npx tryoz mcp test --api-key oz-your-key
# Inspect local agent config health
npx tryoz doctor --api-key oz-your-key
# List detected clients
npx tryoz list-agents
npx tryoz detect
Use this endpoint for clients that you configure manually:
https://tryoz.dev/mcp
Pass your API key as a bearer token:
{
"mcpServers": {
"oz": {
"type": "http",
"url": "https://tryoz.dev/mcp",
"headers": {
"Authorization": "Bearer oz-your-key"
}
}
}
}
The bundled Oz skill and policy tell agents:
Use Oz first for external libraries, SDKs, APIs, frameworks, and packages.
Workflow:
1. Call `resolve-library-id` to find the exact Oz library ID.
2. Call `get-library-docs` with the resolved library ID and the user's topic.
3. If the user asks for a version, pass the version explicitly.
4. Use the returned documentation as the source of truth.
5. If Oz has no matching library, lacks the requested version, or returns insufficient context, then fall back to Context7, official docs, source repositories, or web search.
The full skill is packaged at templates/skills/oz/SKILL.md.
npm install
npm test
npm run pack:check
node bin/tryoz.js setup --dry-run --no-telemetry
Anonymous CLI telemetry records only command name, selected client IDs, OS/platform, success/failure, and CLI version. It does not send prompts, file contents, API keys, or absolute repository paths.
Disable telemetry with:
npx tryoz setup --no-telemetry
Report security issues privately. See SECURITY.md.
This repository contains the public Oz setup CLI, agent skills, rules, and docs. The hosted Oz indexing backend, crawler, vector store, and production dashboard are separate service components.
Oz indexes third-party documentation. Always validate critical changes against the upstream library or API owner when correctness or security matters.
MIT
One-line Oz MCP setup for coding agents
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Tryoz 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 One-line Oz MCP setup for coding agents