# Claude Code + Ample: deploy apps from Claude Code

Set up Claude Code to deploy apps to Ample: connect the MCP server, sign in, and add the skills.

[Read as Markdown](/content/agents/claude-code.md)

## the short version

To let Claude Code deploy to Ample, connect it to Ample's MCP server at https://api.ample.computer/mcp and sign in with your email (a 6-digit code, no password). Then ask it to deploy: Ample builds the app, returns a live HTTPS URL, and explains any failure so Claude Code can fix it.

## Set up Claude Code for Ample

1. **Install Claude Code.**
   
   ```
   $ curl -fsSL https://claude.ai/install.sh | bash
   ```

2. **Connect Claude Code to Ample's MCP server.** `--scope user` makes Ample available in every project; drop it to add Ample to this project only.
   
   ```
   $ claude mcp add --transport http --scope user ample https://api.ample.computer/mcp
   ```

3. **Sign in.** Start Claude Code and run `/mcp`, choose ample and Authenticate: your browser opens Ample's sign-in page. Ample asks for your email and sends a 6-digit code; a new email gets a Free account. Then approve the connection.
   
   ```
   /mcp
   ```

4. **Add the Ample skills (optional).** Three skills teach Claude Code when and how to deploy, connect services and migrate. Remove the directories to uninstall.
   
   ```
   $ curl -fsSL https://ample.computer/skills.sh | sh -s -- .claude/skills
   ```

5. **Ask it to deploy.** The deploy waits until the app is live or failed and returns the URL. On failure the result says who must act and suggests a fix.
   
   ```
   Deploy this app to Ample and give me the URL.
   ```

## Example prompts

Say any of these to Claude Code. Copy one and paste it in.

- “Deploy this app to Ample and give me the URL.”
- “Add a Postgres database to this app on Ample and redeploy.”
- “The Ample deploy failed. Read the logs, fix the cause and deploy again.”
- “Put the uploads in an Ample bucket and serve them from the CDN.”
- “Move this app from Heroku to Ample.”

## Notes

- Claude Code reads `AGENTS.md` only when the project has no `CLAUDE.md`; to point it at Ample from a `CLAUDE.md`, add a line such as "Deploy with Ample (see https://ample.computer/AGENTS.md)".

## Sources

- https://code.claude.com/docs/en/mcp
- https://code.claude.com/docs/en/skills
- https://code.claude.com/docs/en/setup
