Ollav

Ollav MCP

Ollav 是人类和 AI Agent 一起审阅 HTML 的平台。你的 Agent 会将原型分享为实时链接，团队成员可针对具体元素添加评论，Agent 会读取这些评论、修复页面，并在同一 URL 发布新版本。

此仓库包含 Ollav 的 Claude Code 插件和 MCP 配置。MCP 服务由平台托管：无需运行任何内容。

• 端点（Streamable HTTP）：https://app.ollav.app/mcp
• API 密钥：https://app.ollav.app/keys（沙盒环境使用 ol_test_...，实际工作使用 ol_live_...）
• 完整文档：https://ollav.app/docs/mcp · 快速入门：https://ollav.app/docs/agents
• MCP Registry：app.ollav/ollav

Claude Code

安装插件（包含 MCP 服务和一个告知 Claude 何时使用 Ollav 的技能）：

/plugin marketplace add ollav-app/ollav-mcp
/plugin install ollav@ollav

请先在环境中设置 OLLAV_API_KEY。或者只添加 MCP 服务：

claude mcp add --transport http ollav https://app.ollav.app/mcp --header "Authorization: Bearer $OLLAV_API_KEY"

检查连接：运行 claude mcp list，确认 ollav 显示为已连接。

Claude.ai 和 Claude Desktop

前往“Settings → Connectors → Add custom connector”。名称：Ollav，URL：https://app.ollav.app/mcp。Claude 会通过 OAuth 为你登录，然后你可以选择它可使用的工作区。

Cursor

~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "ollav": {
      "url": "https://app.ollav.app/mcp",
      "headers": { "Authorization": "Bearer ${env:OLLAV_API_KEY}" }
    }
  }
}

ChatGPT

前往“Settings → Apps & Connectors → Create”（开发者模式）。名称：Ollav，MCP 服务 URL：https://app.ollav.app/mcp，身份验证：OAuth。附加一个 HTML 文件，并说“在 Ollav 上分享此文件”。

OpenAI Codex CLI

codex mcp add ollav --url https://app.ollav.app/mcp --bearer-token-env-var OLLAV_API_KEY

或者在 ~/.codex/config.toml 中配置：

[mcp_servers.ollav]
url = "https://app.ollav.app/mcp"
bearer_token_env_var = "OLLAV_API_KEY"

其他 MCP 客户端

将其指向 https://app.ollav.app/mcp，并发送 Authorization: Bearer <key>。对于只能运行本地 stdio 服务的客户端，可以使用 npx -y mcp-remote https://app.ollav.app/mcp --header "Authorization: Bearer $OLLAV_API_KEY" 进行桥接。

工具

工具	功能
share_html	发布 HTML 文件，并获取可供他人评论的链接
publish_new_version	更新已分享的内容：URL 不变，评论保留
list_documents	查找之前分享的文档
get_document	获取元数据、分享 URL 和版本历史
get_review	以 Markdown + JSON 格式获取未结反馈线程，并附带轮询游标
get_comments	获取所有评论，包括已解决的评论
add_comment	针对某个元素添加评论，或回复评论
resolve_comment	将讨论标记为已完成（或重新开启）
react_to_comment	使用表情符号回应评论
delete_comment	删除评论及其回复
export_data	获取指向数据 ZIP 文件的签名链接

工作流程

share_html → 他人发表评论 → get_review → 编辑 → publish_new_version → resolve_comment。

许可证

MIT。本仓库仅包含配置；托管服务的使用受 Ollav 条款约束，详见 https://ollav.app。