# Getting started

> What you need before your first Shortcake site, and how the pieces fit together.

import CopyPromptCard from '../../components/CopyPromptCard';

Shortcake lets you update a website by talking to your AI assistant. You say what you want in plain words. Your assistant makes the change, shows it to you, and gets the right person's approval before anything goes live. You never need to type a command.

This works for your own business site, and for sites you build for clients.

## Quick setup with your AI bot

If you use an AI coding assistant (such as **Claude Code**, **Cursor**, **Google Antigravity**, or **Hermes Agent**), you can automate your setup in one step. Copy and paste this prompt directly into your bot:

<CopyPromptCard client:load />

```text
Set up Shortcake on my system:

1. Prerequisites:
   - Check if Node.js 20 or newer is installed ('node -v'). If missing or older than v20, advise me on installing Node.js 20+.

2. CLI Installation:
   - Install the Shortcake CLI globally (ensure the exact package name '@getshortcake/cli' is used, never plain 'shortcake'):
     npm install -g @getshortcake/cli

3. MCP Server Configuration:
   Configure the Shortcake MCP server for my current AI assistant environment:
   - Server URL: https://api.getshortcake.com/v1/mcp
   - OAuth Client ID: 4c16673rm8trdku4f809u3gskd
   - Client Secret: (leave empty / none)
   Specific setup by agent:
   - Claude Code: run 'claude mcp add --transport http --client-id 4c16673rm8trdku4f809u3gskd shortcake https://api.getshortcake.com/v1/mcp'
   - Google Antigravity: create '~/.gemini/config/plugins/shortcake/plugin.json' and 'mcp_config.json' with the MCP server URL and OAuth client ID.
   - Hermes Agent: run:
     hermes config set mcp_servers.shortcake.url https://api.getshortcake.com/v1/mcp && hermes config set mcp_servers.shortcake.auth oauth && hermes config set mcp_servers.shortcake.oauth.client_id 4c16673rm8trdku4f809u3gskd && hermes config set mcp_servers.shortcake.oauth.redirect_host localhost && hermes config set mcp_servers.shortcake.oauth.redirect_port 47821
   - Cursor / Windsurf / Claude Desktop: add 'shortcake' with URL 'https://api.getshortcake.com/v1/mcp' to the active MCP settings.

4. Sign-in & Authentication:
   - Trigger the login flow with 'npx @getshortcake/cli login' (opens the Shortcake login page in the browser).
   - If using Hermes, run 'hermes mcp login shortcake'. If using Claude Code, use '/mcp' to authenticate if needed.

5. Verification (Read-Only):
   - Check connection status and list accessible projects.
   - IMPORTANT: Only run read-only checks (call 'get_status' and 'list_projects' via MCP, or run 'npx @getshortcake/cli status'). Do not create, edit, publish, or promote anything.
   - Report the status, workspace name, and available website projects back to me.
```

## What you need

- **A Shortcake account.** Sign in at [shortcake.wun.ai](https://shortcake.wun.ai). During the invite-only beta, your workspace must be approved before you can use the product.
- **An AI assistant you already use.** You connect Shortcake to it once, and you bring your own subscription. Either kind works:
  - A **chat assistant**, such as Claude, ChatGPT or Gemini, shows your changes with preview links.
  - A **computer assistant**, such as Claude Code, Codex or Google Antigravity, can also show a live view on your computer.

  [See the difference](/docs/see-your-changes#two-kinds-of-assistants).
- **A website, or a new one.** Shortcake can start a new site for you, or connect an existing one built with Astro.

## Key ideas

| Term | What it means |
| --- | --- |
| Workspace | One business. Each workspace keeps its own sites, people and records separate. |
| Site | A website that Shortcake manages. |
| Version | One round of changes to a site, from first edit to approval and going live. Shortcake also calls this a *release*. |
| Saved changes | Every edit your assistant makes is saved right away. Nothing is shown or published yet. |
| Live view | Your site on your own computer, changing within seconds of each edit. Computer assistants only. |
| Preview link | A web link to your saved changes. Ready in about a minute, opens on any device. |
| Review copy | The exact, frozen version the approver reviews. Only this version can be approved. |
| Approver | The person who approves a version before it goes live. For client work, someone at the client. They don't need an account. |

## The flow

1. [Connect your AI assistant](/docs/connect-your-ai-assistant) to Shortcake.
2. [Create or connect a site](/docs/create-or-connect-a-site).
3. Ask for changes and [see them](/docs/see-your-changes): in a live view on your computer, or with a preview link.
4. [Send the review copy for approval](/docs/client-approval).
5. [Publish the approved version](/docs/publishing).

Steps 3 to 5 always happen in that order. Saving and previewing never change your live website. Only an approved and published version does.
