Search documentation

Search documentation

Install in Claude Desktop

Add the Stratta MCP server to the Claude Desktop app.

Claude Desktop takes the same connectors as Claude on the web: Settings › Connectors › Add custom connector, paste https://stratta.ch/mcp, and authorise Stratta in the browser. No Node, no key, no config file. This page is the local alternative, needed only for add_attachment or if you would rather run the server yourself.

You can also run the local server in the Claude Desktop app by adding it to the config file. Because the desktop config can't prompt you interactively, save your key with the CLI first.

Requirements

Steps

  1. Save your key once

    In a terminal, run the login command and paste your key when prompted. It's stored in ~/.stratta/config.json (owner-only).

    npx -y @stratta/mcp login

  2. Edit the Claude Desktop config

    Open Settings → Developer → Edit Config, then add the Stratta server. No key is needed in the file since it reads the one you just saved:

    {
  "mcpServers": {
    "stratta": {
      "command": "npx",
      "args": ["-y", "@stratta/mcp"]
    }
  }
}

    Lighter variant: add "--simple" to args (["-y", "@stratta/mcp", "--simple"]) to expose only the norm-reading tools.

  3. Restart Claude Desktop

    Quit and reopen the app. The Stratta tools appear in the MCP indicator.

Keeping the key in the config instead

Prefer to keep the key in the config file rather than ~/.stratta/config.json? Add an env block:

{
  "mcpServers": {
    "stratta": {
      "command": "npx",
      "args": ["-y", "@stratta/mcp"],
      "env": { "STRATTA_API_KEY": "sk_strt_xxx" }
    }
  }
}

This stores the key in plaintext in the config file. Keep that file private and don't sync it to a shared location.

A note on figures

When you ask about a figure, Claude retrieves the image and includes a link to view it full-size. Claude Desktop does not render remote images inline. You'll see a clickable placeholder/link rather than the picture in the message body. This is a current limitation of the desktop client, not of Stratta. See Troubleshooting.

Next steps

Ask your first question

Get the most out of Stratta.

Troubleshooting

Fix common setup issues.