Skip to main content
Most issues come down to the API key, the network, or the Claude client not reloading. Work through the relevant section below.

​
Authentication failed / invalid API key

1

Check the key format

A valid key starts with sk_strt_. Make sure no leading or trailing whitespace was copied.
2

Check it isn't revoked

Open stratta.ch/api-keys and confirm the key is still active. If unsure, create a new one.
3

Check the key reaches the process

If you use the environment variable, confirm it’s set:
echo $STRATTA_API_KEY          # macOS / Linux
echo $env:STRATTA_API_KEY      # Windows PowerShell
4

Re-save the key

Run npx -y @stratta/mcp login again and paste a fresh key.

​
ECONNREFUSED or network errors

  • Confirm outbound HTTPS to *.convex.cloud is allowed by your firewall or VPN.
  • Test general connectivity: curl -I https://stratta.ch.

​
Tools don’t appear in Claude

1

Restart the client

Quit and reopen Claude Desktop, or restart your Claude Code session, after editing any config.
2

Check the server logs

  • Claude Code: claude mcp logs stratta
  • Claude Desktop (macOS): ~/Library/Logs/Claude/mcp-server-stratta.log
3

Check your Node.js version

The server requires Node 20 or newer:
node --version

​
Rate-limited

Each user can hold up to 50 active keys and create 20 new keys per 24 hours. If you hit a limit, revoke unused keys at stratta.ch/api-keys. See Manage API keys.

​
Figures do not display inline

When you ask about a figure, Stratta returns the image plus a link to view it full-size. Some clients can’t render remote images inline:
  • Claude Desktop shows a clickable placeholder/link rather than the image in the message body. This is a current limitation of the desktop client, not of Stratta.
  • The native (base64) image is available in the tool-result panel.
You can always open the provided URL to see the figure full-size.

​
Still stuck?

Email hello@stratta.ch with the failing command and any log output (redact your API key).