Work with Claude
How Crux connects to Claude — status, setup, and how it links to Research and Experience.
Status: Available
Use Anthropic’s Claude (Claude Code CLI or other Claude MCP clients) with the Crux MCP endpoint — especially to capture research into Crux from the conversation.
Setup
- Open Settings → External sources → AI assistants → Claude (or Settings → Setup MCP → Claude).
- Copy the one-command install and run it in your terminal (not inside a Claude session):
claude mcp add --transport http --scope user crux https://www.crux-hq.com/mcp - Sign in when prompted. Then prompt by project name — "capture that as research in Acme", "why does the checkout page exist?", "plan the discovery phase in Acme".
What Claude can do
Claude gets the full Crux tool set — the same one Cursor gets — so it both reads and writes your projects:
- Read — list projects, read the research and experience graphs, ask why an entity exists (
ask_why), and read the current plan (list_plan). - Write — capture research from the conversation (
capture_research), create experience entities, register code references, and schedule activities and to-dos (upsert_activity,create_todo).
Writing requires the connection's Write permission, which is on by default. See the full read and write tool list.
Plan from the conversation
Ask Claude to plan or sequence work and it reads what is already scheduled, proposes activities, dates, owners, and the to-dos under each, and writes them only once you have agreed. They appear immediately on the Crux Plan calendar and timeline.
How it fits
Crux keeps Research (evidence) and Experience (pages, features, content) linked. Claude plugs into that loop — it does not replace the tool you already use for day-to-day work in that product.
Notes
Generic MCP JSON from Settings works if you prefer editing config by hand. Manage or revoke the connection, and turn Write off, under Settings → Integrations.
Next
Related articles
Documents: MCP & browser extension