Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stratta.ch/llms.txt

Use this file to discover all available pages before exploring further.

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