# Connect Claude, Cursor and other MCP clients

> Add the hosted ShopSavvy MCP server by URL with one command, or run it locally over stdio for Claude Desktop. A key is optional and raises your limits.

*Source: https://shopsavvy.com/data/documentation/mcp-installation* · Part of the [ShopSavvy Data API documentation](https://shopsavvy.com/data/documentation.md)

---

## 1. Connect by URL

Claude Code, Cursor, VS Code, Codex, Gemini CLI, claude.ai and ChatGPT connect to the hosted server directly. The key is optional (anonymous use is rate-limited per IP); send it for your plan's limits:

```bash
claude mcp add --transport http shopsavvy https://api.shopsavvy.com/mcp \
  --header "Authorization: Bearer ss_live_your_key_here"
```

Per-client setup: https://shopsavvy.com/agents#install

## 2. Or run it locally

For clients that can only launch local (stdio) servers, such as Claude Desktop's config file:

```json
{
  "mcpServers": {
    "shopsavvy": {
      "command": "npx",
      "args": ["-y", "@shopsavvy/mcp-server"],
      "env": {
        "SHOPSAVVY_API_KEY": "ss_live_your_key_here"
      }
    }
  }
}
```

## 3. Get Your API Key

- [Subscribe to a Plan](https://shopsavvy.com/data#pricing)
- [Create API Key](https://shopsavvy.com/data/dashboard)