# Briefs Documentation — Index

This is the hub for the Briefs system documentation. Each linked Brief covers one scoped
topic. If you are an AI agent helping a user work with Briefs, start here, then fetch the
specific Brief(s) you need for the task at hand rather than loading everything.

## Start here

- **Quickstart — get a user up and running now:** https://sharebriefs.com/brief/quickstart
  An agent playbook: explain Briefs, connect the MCP, create a first Brief, and set the user
  up for personal, team, or enterprise use. Fetch this when a user wants to start using
  Briefs right away.

- **Intro — what Briefs are and how to use them:** https://sharebriefs.com/brief/intro
  The concept, how to recognize a Brief, how to consume one, how Briefs differ from
  documents and memory, and the access model. Read this for background.

## Content types

Briefs hosts two kinds of content, sharing one ownership and permission model:

- **Briefs** — markdown knowledge for an AI agent to read (the default; everything below
  unless noted).
- **Pages — host single-file HTML at a URL:** https://sharebriefs.com/brief/pages
  A Page is a single-file HTML document (dashboard, report, chart, visual explainer) hosted
  with the same owners, visibility, and collaborators as a Brief, viewed and shared at
  `sharebriefs.com/{owner}/pages/{name}`. Fetch this when a user wants a rendered or
  interactive artifact rather than markdown knowledge.

## Authoring

- **Creating and organizing Briefs:** https://sharebriefs.com/brief/creating
  How to author Briefs and structure knowledge across several Briefs (scope tightly, use an
  index Brief, naming, where to create). Fetch when a user asks you to create or organize
  Briefs.

## Operating

- **Managing Briefs:** https://sharebriefs.com/brief/managing
  Lifecycle through the MCP: get, list, update, rename, and delete. Update-in-place vs
  recreate, and destructive-action etiquette.

## Access & teams

- **Sharing Briefs and managing access:** https://sharebriefs.com/brief/sharing
  Per-Brief collaborators and permissions (read/write/admin), invitations, and when to just
  share the URL instead. Pages share the same model.

- **Organizations:** https://sharebriefs.com/brief/organizations
  Shared org namespaces, member vs admin roles, org settings (default permission,
  members_can_create), and the membership/invitation flow.

- **Enterprise & SSO:** https://sharebriefs.com/brief/enterprise
  Domain-verified single sign-on via WorkOS for company-wide setups.

## Programmatic access

- **Using the MCP server:** https://sharebriefs.com/brief/mcp
  Connect an AI agent (Claude Code, Claude Desktop, other MCP clients) to the Briefs MCP at
  mcp.sharebriefs.com, how authentication works, and what the tools let you do.

- **Authentication & tokens:** https://sharebriefs.com/brief/authentication
  OAuth vs personal access tokens, how to generate a token, scopes, and security.

- **REST API:** https://sharebriefs.com/brief/api
  Direct HTTP access to the same capabilities at api.sharebriefs.com — endpoints, request
  and response shapes, pagination, and errors.

- **System limits:** https://sharebriefs.com/brief/limits
  Content and request-size caps, rate limits, and pagination defaults.

## How to use this index

Match the user's intent to a topic, fetch that Brief, and act on its guidance. Most Briefs
link back here and across to siblings, so you can navigate without reloading the whole set.