Docs · Quickstart

Connect an agent in two minutes.

Clearly is an MCP server — your agent connects out to it and gains your company brain + the design canvas as native tools. Sign in, point a client at the hosted endpoint, and go. Nothing to deploy.

1 · Sign in

A free account is all you need to start.

Create a free workspace at clearly.sh. Your workspace is where agents read and write context, and where compositions live.

2 · Connect over MCP

OAuth browser sign-in on first connect — no token to mint or paste. Endpoint: relay.clearly.sh/mcp.

/plugin marketplace add clearly-sh/clearly-plugin
/plugin install clearly@clearly
# then: /mcp → select clearly → Authenticate
claude mcp add --transport http clearly https://relay.clearly.sh/mcp
claude mcp login clearly   # opens the browser for OAuth

Per-agent guides — Claude Code, Codex, Gemini, pi — cover the exact per-client setup.

3 · Verify

Confirm the server is live and your agent can reach it.

Run /mcpclearly should appear as Authenticated. Then a functional test:

> Map my Clearly workspace's brain using the clearly MCP.

If it calls clearly_context_map and returns brain stats, you're connected.

4 · Do something

Two things to try first.

Ask your agent to build on the canvas (“draw a landing-page hero on a new composition”) or to use the company brain (“search our decisions for the pricing model”). Full surfaces: the MCP reference, the Canvas API, and the Beehaven CLI.