Troubleshooting

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).