@briefhq/mcp-server/dist/templates/claude-brief.md

Brief MCP server and CLI – connect Cursor/Claude MCP to your Brief organization

# /brief Onboarding

Use /brief to set up or invoke Brief tools in Claude Code.

If MCP is not installed or configured, run:

`npx -y @briefhq/mcp-server@latest init --app claude --scope user --yes --write`

This will securely save your API credentials and add the Brief MCP server.

# Cold Start Suggestions

- Discover available context:
  → brief_discover_context

- Plan which context to fetch for this task:
  → brief_plan_context

- Search documents:
  → brief_search_documents {"query": "<keywords>", "limit": 5}

- Browse folders:
  → brief_browse_context {"limit": 10}

- Retrieve content (smart subset):
  → brief_retrieve_content {"document_ids": ["doc-id"], "max_tokens": 2000, "mode": "smart_subset"}

- Guard your approach:
  → brief_guard_approach {"approach": "<summary of your plan>"}

- Record a decision:
  → brief_record_decision {"topic": "<topic>", "decision": "<what>", "rationale": "<why>", "severity": "important"}

# Notes

- Keep requests scoped to the current task
- Prefer summaries/smart subsets when token budgets are tight
- Respect organization boundaries and sensitive materials