Test mode

Connect your agent. Nothing real is charged.

Point Claude, Cursor or ChatGPT at https://calmar.sh/api/mcp with a test key (sk_test_…) from the dashboard, sent as Authorization: Bearer sk_test_…. Everything that key calls stays in test mode: sample stores and provider sandboxes, no card charged, no real store told.

Claude Desktop

claude_desktop_config.json · macOS ~/Library/Application Support/Claude · Windows %APPDATA%\Claude

Claude Desktop
{
  "mcpServers": {
    "calmar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://calmar.sh/api/mcp",
        "--header",
        "Authorization:${CALMAR_AUTH_HEADER}"
      ],
      "env": {
        "CALMAR_AUTH_HEADER": "Bearer sk_test_…"
      }
    }
  }
}

Claude Code

Terminal. The header is Authorization: Bearer and your test key.

Claude Code
claude mcp add --transport http calmar https://calmar.sh/api/mcp --header "Authorization: Bearer sk_test_…"

Cursor

.cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project.

Cursor
{
  "mcpServers": {
    "calmar": {
      "url": "https://calmar.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_test_…"
      }
    }
  }
}

ChatGPT

Developer mode connector. Use this URL when the form cannot send a header.

ChatGPT
https://calmar.sh/api/mcp?key=sk_test_…

In ChatGPT, open Settings, then Connectors, and turn on developer mode. Add a custom connector with the server URL. OpenAI's connector form offers OAuth or no authentication, and does not document a custom Authorization header. If the form you see has a header field, set Authorization to Bearer and your sk_test key. If it does not, use the key-in-URL fallback. Use a test key either way: a live key is not accepted as a way into test mode.

Back to the docs