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
{
"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 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.
{
"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.
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.