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

# Troubleshooting

> Fixes for the most common Stratta setup and runtime issues.

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

<Steps>
  <Step title="Check the key format">
    A valid key starts with `sk_strt_`. Make sure no leading or trailing whitespace was copied.
  </Step>

  <Step title="Check it isn't revoked">
    Open [stratta.ch/api-keys](https://stratta.ch/api-keys) and confirm the key is still active.
    If unsure, create a new one.
  </Step>

  <Step title="Check the key reaches the process">
    If you use the environment variable, confirm it's set:

    ```bash theme={null}
    echo $STRATTA_API_KEY          # macOS / Linux
    echo $env:STRATTA_API_KEY      # Windows PowerShell
    ```
  </Step>

  <Step title="Re-save the key">
    Run `npx -y @stratta/mcp login` again and paste a fresh key.
  </Step>
</Steps>

## `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

<Steps>
  <Step title="Restart the client">
    Quit and reopen Claude Desktop, or restart your Claude Code session, after editing any config.
  </Step>

  <Step title="Check the server logs">
    * **Claude Code:** `claude mcp logs stratta`
    * **Claude Desktop (macOS):** `~/Library/Logs/Claude/mcp-server-stratta.log`
  </Step>

  <Step title="Check your Node.js version">
    The server requires Node **20 or newer**:

    ```bash theme={null}
    node --version
    ```
  </Step>
</Steps>

## 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](https://stratta.ch/api-keys). See
[Manage API keys](/en/guides/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](mailto:hello@stratta.ch) with the failing command and any log output
(redact your API key).