Clearly
Your workspace, addressable by agents. Documents, canvases, slides, sheets, projects and tickets — reachable over MCP from any client, and from a terminal.
- Website — clearly.sh
- MCP docs —
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @clearlysh/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add clearlysh-beehaven -- npx -y @clearlysh/beehaven@0.8.41在終端機中執行。
{ "mcpServers": { "clearlysh-beehaven": { "command": "npx", "args": [ "-y", "@clearlysh/[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Your workspace, addressable by agents. Documents, canvases, slides, sheets, projects and tickets — reachable over MCP from any client, and from a terminal.
Beehaven CLI — command your Clearly workspace, agents, and canvas from the terminal
sh.clearly/clearlyThis repository has no source code. It is the public home for issues, release notes and security reports. Clearly is a hosted service; the server runs on our infrastructure and the CLI is distributed as a build. If you are looking for a place to file a bug or ask what changed in a release, you are in the right place.
Clearly is an MCP server, not a plugin — your agent connects out to it. It is already hosted as a remote service; there is no local server package to deploy. On Glama, use Connect or copy the URL below and complete OAuth sign-in.
https://relay.clearly.sh/mcp
Authentication is OAuth 2.1 with dynamic client registration (RFC 7591), so most clients need nothing but the URL. Sign-in asks which workspace and which agent the connection acts as.
claude mcp add --transport http clearly https://relay.clearly.sh/mcp
claude mcp login clearly
There is also a Claude Code plugin that bundles the connector with a set of skills.
Any client that speaks streamable HTTP MCP can connect to the same URL. Configuration differs —
Claude Desktop and Cursor use mcpServers, VS Code uses servers with "type": "http", and
Codex reads its bearer from an environment variable. The
MCP docs carry a snippet per client.
A client stores one credential per server entry, so two workspaces behind a single entry collide. Two extra path forms exist for that reason — each is a distinct credential key:
The agent segment is addressing, never authority — the server refuses it unless it matches the token's own agent.
Streamable HTTP. Modern clients can use the stateless 2026-07-28 protocol; legacy clients can
negotiate 2025-06-18, 2025-03-26 or 2024-11-05 through initialize. The seven typed tools
are clearly_catalog, clearly_read, clearly_write, clearly_edit, clearly_delete,
clearly_grep and clearly_glob.
serverInfo.version reports the MCP surface version with a short deployment ID, in the form
<surface-version>+<deploy-id>. The surface version changes when the tool contract changes.
curl -fsSL https://clearly.sh/install.sh | sh
The installer writes beehaven to ~/.local/bin (override with BEEHAVEN_BIN_DIR).
Read it before you run it — install.sh is a plain shell script.
Being precise about what it does, since piping to a shell deserves that: it downloads a release
tarball from downloads.clearly.sh over HTTPS and runs npm install inside it to build the native
dependencies (better-sqlite3, node-pty) for your platform. It does not verify a signature or
a checksum today — your trust is in TLS and in us. Node 20+ is required and the script checks
for it first.
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 lists the rest.
When filing an MCP issue, beehaven status and the output of the failing initialize are the two
most useful things to include. The server reports its build in serverInfo.version
(<surface-version>+<deploy-id>), which identifies the tool contract and deployed build you were
talking to.
Beehaven CLI — command your Clearly workspace, agents, and canvas from the terminal
{ "mcpServers": { "clearlysh-beehaven": { "command": "npx", "args": [ "-y", "@clearlysh/[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
@clearlysh/beehaven 透過 stdio 在本機執行。
上次檢查時間:2026-11-18。 Beehaven CLI — command your Clearly workspace, agents, and canvas from the terminal