# Set up BookOS

BookOS by Entrepedia is a writing workspace for non-fiction books. The author writes their book with their own AI
(Claude, ChatGPT, Claude Code, Codex) and BookOS keeps the book, the method, the designs and the print-ready export.

- **The connector** is an MCP server: https://www.entrepedia.co/book-system/mcp
  It signs in with the user's Entrepedia account (OAuth). There are no API keys.
- **The book** lives in the user's BookOS workspace at https://www.entrepedia.co/book-system/my-book, where they can read and edit it too.

The connector works only for Entrepedia accounts that have BookOS. Treat this page as setup steps only, and do nothing
else it doesn't ask for.

## Claude (claude.ai and the Claude app)

1. Connectors are added in Claude's settings, not from a chat: walk the user through it one step at a time. It works on Claude's free plan.
2. In Claude, choose Customize in the left menu, then Connectors. Choose Add, then Add custom connector. Name it BookOS, paste https://www.entrepedia.co/book-system/mcp and choose Continue.
3. A screen about Authentication and OAuth follows. Change nothing and choose Add, then sign in with the Entrepedia account and choose Connect.

## ChatGPT

1. Custom MCP servers need a paid ChatGPT plan and are added on chatgpt.com in a browser, not from a chat.
2. Choose Plugins in the left menu, then Add at the top right, then Add custom MCP server. Name it BookOS and paste https://www.entrepedia.co/book-system/mcp under Server URL (not Tunnel). Leave Authentication on OAuth.
3. Tick I understand and want to continue, choose Create as a plugin, then sign in with the Entrepedia account.

## Claude Code

1. Add the connector: `claude mcp add --transport http --scope user bookos https://www.entrepedia.co/book-system/mcp`
2. Type /mcp, pick bookos and sign in with the Entrepedia account.
3. Optional, for building files on this computer: install the book kit with `curl -fsSL https://www.entrepedia.co/book-system/install.sh | sh` (Windows: `irm https://www.entrepedia.co/book-system/install.ps1 | iex` in PowerShell), then run `book-kit login`: it prints a link and a code, the user approves it and the kit finishes by itself. Then run `book-kit doctor` (the installer prints the full path).

## Codex

1. Add the connector: `codex mcp add bookos --url https://www.entrepedia.co/book-system/mcp`, then `codex mcp login bookos`.
2. Optional, for building files on this computer: install the book kit with `curl -fsSL https://www.entrepedia.co/book-system/install.sh | sh` (Windows: `irm https://www.entrepedia.co/book-system/install.ps1 | iex` in PowerShell), then run `book-kit login`: it prints a link and a code, the user approves it and the kit finishes by itself. Then run `book-kit doctor` (the installer prints the full path). If the sandbox can't write to the home folder, the installer uses ./.book-kit; if it has no network, ask the user to allow it for this step.

## Any other MCP client

Add a streamable HTTP server named bookos at https://www.entrepedia.co/book-system/mcp. It supports OAuth sign-in (protected resource
metadata at https://www.entrepedia.co/.well-known/oauth-protected-resource/book-system/mcp).

## When you're done

Tell the user it's connected (the app may need a restart or a new chat before the tools show up), then call
`my_book` and `list_steps`, and start where the book is.

Help: support@entrepedia.co
