Corey Corey
Hire Corey
How it works Use cases Guides Build log What Corey builds Docs Hire Corey

Corey in Claude Code (CLI)

To connect Corey in Claude Code, add the server with --scope user over HTTPS, run /mcp to authenticate, then paste the kickoff prompt in any session from your chosen folder. No token to paste; Corey uses a browser sign-in that creates your account and starts your 28-day probation at no cost.

For developers who live in the terminal. If you prefer a graphical interface, use the Desktop guide instead.

The one thing that bites people: use HTTPS, not HTTP

Corey is served over HTTPS. If you add it as http://..., Claude Code fetches Corey’s protected-resource metadata (which says https://...), sees a mismatch, and refuses to authenticate with exactly this error:

shell
Protected resource https://mcp.getcorey.ai/mcp does not match expected http://mcp.getcorey.ai/mcp

The fix is just the scheme. Keep reading.

Step 1: Remove any earlier (HTTP) entry

If you tried to add Corey before and used http://, remove it first:

shell
claude mcp remove corey

If you have never added Corey before, skip this step.

Step 2: Add Corey over HTTPS with --scope user

No token, no header. Corey uses browser sign-in, not a pasted key. The --scope user flag makes Corey available in every project, which is what you want for a personal assistant:

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

Already added Corey in the Desktop app? Import it instead of retyping:

shell
claude mcp add-from-claude-desktop

Step 3: Authenticate in a Claude Code session

Open a Claude Code session (from the folder you want Corey to work in) and run:

shell
/mcp

Select corey, then Authenticate. Your browser opens Corey’s sign-in page.

The browser page is Corey’s own sign-in (powered by WorkOS), not Claude asking for your Claude password. It is where you:

  • First time: create your Corey account (email and password, or a social login if shown). This creates your account and starts your 28-day probation at no cost.
  • Returning: sign in.

After you finish in the browser, return to the terminal. /mcp now shows corey connected with its tools. There is no access token to paste.

Step 4: Run the kickoff prompt

Once corey shows connected, paste this as your first message:

shell
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 onboard and walk me through the Meet Corey interview, one question at a time.
3. Write my setup into this folder as my overlay.
4. Then show me three things you can do for me right now.

Corey confirms the connection, runs the onboarding interview, sets up your workspace in the current folder, and suggests three concrete things it can do for you right now, drawn from what you told it in the interview.

Claude Code reads and writes local files natively, so Corey builds your workspace in the current folder. There is no separate Cowork step (unlike the Desktop app). Run Claude Code from the folder you want Corey to work in, or default to ~/Corey.

Optional: the corey launcher

Want to type corey from anywhere to jump into your Corey folder and start a session? The onboarding can install a small shell function for you (corey-launcher.sh, idempotent). After it runs:

shell
source ~/.zshrc   # or ~/.bashrc
corey

corey (or Corey) changes into your Corey folder ($COREY_HOME, default ~/Corey) and launches Claude with a short greeting.

Still not connecting?

  • Double-check the URL is https://mcp.getcorey.ai/mcp (HTTPS, ends in /mcp).
  • Run claude mcp list to confirm there is no leftover http:// entry.
  • The config lives in ~/.claude.json. A stale corey block there with http:// will keep failing until removed.

Related

Questions, answered

Corey is served over HTTPS. If you add it as http://, Claude Code fetches Corey's metadata, sees a scheme mismatch, and refuses to authenticate. The fix is just the URL scheme.
It makes the Corey connection available across all your projects rather than only the current directory. Because Corey is a personal assistant, user scope is the right choice.
No. The browser page is Corey's own sign-in, powered by WorkOS. It is where you create your Corey account (first time) or sign back in (returning). There is no access token to paste afterwards.
Run Claude Code from the folder you want Corey to work in, or default to ~/Corey. Claude Code reads and writes local files natively, so there is no separate filesystem step like the Desktop app has.