Clearly

Clearly

你的工作区，可由 Agent 寻址。 文档、画布、幻灯片、表格、项目和工单——可通过 MCP 从任何客户端及终端访问。

• 网站 — clearly.sh
• MCP 文档 — clearly.sh/docs/mcp
• MCP Registry — sh.clearly/clearly

此仓库不包含源代码。 这是用于提交问题、发布说明和安全报告的公开空间。Clearly 是托管服务；服务端运行在我们的基础设施上，CLI 以构建产物的形式分发。如果你想提交 bug，或询问某次发布有哪些变更，那么你来对地方了。

---

MCP

Clearly 是 MCP 服务，而不是插件——你的 Agent 会主动连接到它。 它已作为远程服务托管；没有可供部署的本地服务包。在 Glama 上，点击 Connect，或复制下面的 URL 并完成 OAuth 登录。

https://relay.clearly.sh/mcp

身份验证采用 OAuth 2.1 和动态客户端注册（RFC 7591），因此大多数客户端只需要 URL。登录时会询问此次连接代表哪个工作区和哪个Agent。

Claude Code

claude mcp add --transport http clearly https://relay.clearly.sh/mcp
claude mcp login clearly

此外还有一个 Claude Code 插件，将连接器与一组技能打包在一起。

其他客户端

任何支持可流式传输 HTTP MCP 的客户端都可以连接到同一个 URL。配置方式各不相同——Claude Desktop 和 Cursor 使用 mcpServers，VS Code 使用 servers 和 "type": "http"，而 Codex 从环境变量读取其 bearer。 MCP 文档为每个客户端提供了相应的配置片段。

同时持有多个工作区或 Agent

客户端会为每个服务条目存储一份凭据，因此，单个条目后面的两个工作区会发生冲突。为此提供了两种额外的路径形式——每种路径都对应一个独立的凭据键：

URL	含义
/mcp	登录时选择的工作区和 Agent
/mcp/w/<workspaceId>	固定到一个工作区
/mcp/w/<workspaceId>/a/<agentId>	固定到一个工作区和一个 Agent

Agent 路径段只用于寻址，不代表权限——除非它与令牌所属的 Agent 匹配，否则服务端会拒绝该请求。

协议

可流式传输 HTTP。现代客户端可以使用无状态的 2026-07-28 协议；旧版客户端可以通过 initialize 协商 2025-06-18、2025-03-26 或 2024-11-05。七个类型化工具分别是 clearly_catalog、clearly_read、clearly_write、clearly_edit、clearly_delete、clearly_grep 和 clearly_glob。

serverInfo.version 会报告 MCP 接口版本并附带简短的部署 ID，格式为 <surface-version>+<deploy-id>。工具契约变更时，接口版本也会变更。

---

CLI

curl -fsSL https://clearly.sh/install.sh | sh

安装程序会将 beehaven 写入 ~/.local/bin（可通过 BEEHAVEN_BIN_DIR 覆盖）。

运行前请先阅读脚本——install.sh 是一个普通的 Shell 脚本。鉴于通过管道将内容传给 Shell 需要谨慎对待，这里明确说明它的操作：它会通过 HTTPS 从 downloads.clearly.sh 下载发布压缩包，并在其中运行 npm install，为你的平台构建原生依赖（better-sqlite3、node-pty）。目前它不会验证签名或校验和——你只能信任 TLS 和我们。需要 Node 20+，脚本会先检查是否满足要求。

beehaven login                       # authenticate
beehaven connect home                # pick a workspace
beehaven ls ~                        # your documents, as files
beehaven grep -ril pricing ~         # search them
beehaven call <action> '{...}'       # any workspace action
beehaven status                      # connection + auth state

beehaven --help 会列出其余内容。

---

反馈问题

• Bug 和功能请求 — 提交问题。
• 安全问题 — 请不要公开提交问题。请参阅 SECURITY.md。

提交 MCP 问题时，beehaven status 和失败的 initialize 的输出是最值得提供的两项信息。服务会在 serverInfo.version 中报告其构建版本 （<surface-version>+<deploy-id>），以标识你所交互的工具契约和已部署构建。

---

许可

本仓库内容遵循 MIT 许可。Clearly 服务本身受其条款约束。