# Image CDN for Claude Code — AuraImage (https://auraimage.ai/claude-code)

Add AuraImage to Claude Code with one committable .mcp.json. Audit, migrate, and optimize images from the terminal — a Cloudinary alternative your agent installs for you.

## Add AuraImage to Claude Code

### Project — `.mcp.json`

> The `${AURA_SECRET_KEY}` form reads from your shell or `.env.local`, which keeps `.mcp.json` safe to commit.

```json
{
  "mcpServers": {
    "auraimage": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@auraimage/mcp-server@latest"],
      "env": {
        "AURA_SECRET_KEY": "${AURA_SECRET_KEY}"
      }
    }
  }
}
```

Or from the terminal:

```bash
claude mcp add --scope project --transport stdio auraimage -- npx -y @auraimage/mcp-server@latest
```

Verified against https://code.claude.com/docs/en/mcp on 2026-08-09.

## Optimize images with Claude Code

- "Audit every image in the repo for LCP impact, then write the rule you applied into CLAUDE.md." → `audit_lcp`
- "Migrate /public to AuraImage, update every reference, and stage it as one commit." → `migrate_assets`
- "Add the missing alt text across app/ — use the AuraImage skill so I do not have to describe the house style again." → `generate_alt`
- "Replace the <img> in app/page.tsx with a responsive <picture>, and put it in the same commit as .mcp.json so the team gets the tool and the fix together." → `generate_responsive_tag`
- "I just added AURA_SECRET_KEY to .env.local — crop team-photo.jpg to 1:1 and 16:9 and show me both." → `smart_crop_preview`

## Project conventions

`CLAUDE.md` — Repo-wide conventions go in `CLAUDE.md`, which loads at the start of every conversation. Reusable behaviours go in `.claude/skills/`, which load on demand — only when you invoke one or when Claude decides it is relevant.

## FAQ

### Is .mcp.json safe to commit?

Yes, as long as the key stays interpolated. The `${AURA_SECRET_KEY}` form resolves from your shell or `.env.local` at launch, so the committed file contains a variable name rather than a credential.

### Do I need the agent skills as well as the MCP server?

No — the MCP server alone gives Claude Code the tools. The skills add judgment about when and how to use them. Start with the server; add `npx skills add auraimage/skills` when you want the agent to make the calls unprompted.

## Links

- All agents: https://auraimage.ai/skills
- AI integration: https://auraimage.ai/docs/ai-integration.md
- Getting started: https://auraimage.ai/docs/getting-started.md