Connect Corey and get building.

A graphical chat app on Mac or Windows - the easiest way in if you do not live in a terminal. Corey runs in the app, not the browser.

1. 1

   Add the Corey connector

   Download Claude Desktop fromclaude.ai/download and sign in. Then the button below opens Claude's Add custom connector dialog in a new tab with the name and URL already filled in - one click, no hunting through settings.

   Add Corey to Claude →

   Just click Add, then Connect, and sign in through your browser. Claude warns you to only add connectors from developers you trust; that is expected.

   No button? Do it by hand: Customize › Connectors › Add › Add custom connector, name it Corey and paste the URL below.

   connector URLCopy

   https://mcp.getcorey.ai/mcp

2. 2

   Sign in, then test the link

   Click Connect and sign in through your browser (Corey uses a secure browser sign-in - no token to paste). Back in a chat with the Corey connector switched on, ask it to check the connection:

   ask coreyCopy

   Run whoami and tell me if we are connected.

   Go: Corey names your account. No go: see If you get stuck below.

3. 3

   Set up your Cowork Project

   In the Home tab, turn on the Cowork toggle, clickWork in a folder and choose afresh, empty folder (a new one called Corey is tidiest). Make sure the Corey connector is switched on for this chat. You do not need to create any files yourself - Corey builds the right folder structure for you in the next step. Setup is non-destructive.

4. 4

   Start Corey

   The button below opens a Cowork session with Corey's kickoff prompt already loaded - one click, no typing. Corey introduces itself, asks a few questions, writes its setup and the proper folder structure into your folder, and gets to work. Nothing public, costly or irreversible happens without your say-so.

   Start Corey →

   No button? Open the prompt menu (the + in the message box), pick Corey's Get Started prompt, or paste this:

   claude desktopCopy

   You are Corey. I've just connected you.
   1. Run whoami to confirm the connection. If it fails, stop and tell me what to fix.
   2. Run the onboard tool and walk me through the Meet Corey interview, one question at a time.
   3. Set up my workspace in this folder - write your overlay and the right folder structure yourself.
   4. Build my personalised Command Center and open it.
   5. Then show me the top three things to do next, from my Command Center.

5. 5

   Pin Corey's standing rule

   Claude Desktop reads your Corey OS through its GitHub repo, not your local disk, so it does not pick up the CLAUDE.md standing rule on its own. Pin it once: open your Corey project in Desktop, go to project settings -> custom instructions, and paste the block below. (Claude Code and Cursor readCLAUDE.md directly and need none of this.)

   project instructionsCopy

   Always work through the Corey MCP. Before anything else each turn, read the expectations overlays - `expectations.md` at the repo root and every `projects/*/expectations.md` - then open by naming the current top gap and the next_action toward the dream, and offer to do it. Keep `memory/` tidy as facts arrive, and check `memory/_maturity.md` for the next context gap to fill.

For developers who live in the terminal, using Claude Code. The one thing that bites people: use HTTPS, not HTTP.

1. 1

   Add Corey over HTTPS

   No token, no header - Corey uses browser sign-in. The --scope user flag makes it available in every project.

   claude codeCopy

   claude mcp add --transport http corey https://mcp.getcorey.ai/mcp --scope user

2. 2

   Authenticate, then test the link

   Run /mcp, select corey, thenAuthenticate. Your browser opens Corey's sign-in (powered by WorkOS) - sign in and return. Once corey shows connected, ask it to run whoami; it should name your account.

   claude codeCopy

   /mcp

3. 3

   Open a clean folder

   Make (or pick) a fresh, empty folder for Corey and run Claude Code from inside it. That folder becomes your workspace - Corey writes its overlay and the right structure there, so start it empty.

4. 4

   Kick it off

   Paste this from inside that folder. It confirms the link, runs the interview and sets your workspace up in one go.

   first messageCopy

   You are Corey. I've just connected you.
   1. Run whoami to confirm the connection. If it fails, stop and tell me what to fix.
   2. Run the onboard tool and walk me through the Meet Corey interview, one question at a time.
   3. Set up my workspace in this folder - write your overlay and the right folder structure yourself.
   4. Build my personalised Command Center and open it.
   5. Then show me the top three things to do next, from my Command Center.

Cursor is a code editor with a built-in agent. Add Corey as a remote MCP server - a URL and one click, no token.

1. 1

   Add Corey to Cursor

   The button below opens Cursor and installs Corey as a remote MCP server in one click - no mcp.json to edit. Just confirm the install when Cursor asks.

   Add Corey to Cursor →

   No button, or prefer to do it by hand? Add this to the global file~/.cursor/mcp.json (or Settings › Tools and MCP › New MCP Server):

   ~/.cursor/mcp.jsonCopy

   {
     "mcpServers": {
       "Corey": {
         "url": "https://mcp.getcorey.ai/mcp"
       }
     }
   }

2. 2

   Connect, then test the link

   Open Settings › Tools and MCP. The coreyserver shows a Connect button - click it, sign in through your browser, and return (Cursor stores and refreshes the tokens for you). Then ask Corey to runwhoami to confirm.

3. 3

   Open a clean folder in Agent mode

   Open a fresh, empty folder for Corey to manage and switch the chat to Agent mode. Corey writes its overlay and folder structure into that folder, so start it empty.

4. 4

   Kick it off

   Paste the kickoff prompt and Corey takes it from there.

   agent modeCopy

   You are Corey. I've just connected you.
   1. Run whoami to confirm the connection. If it fails, stop and tell me what to fix.
   2. Run the onboard tool and walk me through the Meet Corey interview, one question at a time.
   3. Set up my workspace in this folder - write your overlay and the right folder structure yourself.
   4. Build my personalised Command Center and open it.
   5. Then show me the top three things to do next, from my Command Center.