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.

Claude Code is the recommended way to use Stratta. The install is a single command, and you provide your API key on first use.

Requirements

  • Claude Code installed.
  • Node.js 20 or newer (node --version to check).
  • A Stratta API key.

Install

Add the server — no key needed up front:
claude mcp add stratta -- npx -y @stratta/mcp
On the first tool call, Claude Code prompts you to paste your API key. It’s validated and saved to ~/.stratta/config.json (owner-only, mode 0600), so you only do this once.
npx -y @stratta/mcp always fetches the latest published version. No manual updates needed.

Alternative: provide the key ahead of time

Prefer to set the key before the first call? You have two options.
Run the login command and paste your key when prompted. It’s saved to ~/.stratta/config.json.
npx -y @stratta/mcp login

Verify it works

Start a conversation and ask Claude to list the available norms, for example:
List the engineering norms available in Stratta.
Claude should call list_norms and return the norms in your workspace. If the tools don’t appear, see Troubleshooting.
View the server logs anytime with claude mcp logs stratta.

How the key is resolved

The server looks for your key in this order:
  1. The STRATTA_API_KEY environment variable.
  2. ~/.stratta/config.json (written by login or the first-use prompt).
  3. An interactive prompt on first use (clients that support it).
Full details in MCP Reference → Overview.

Next steps

Ask your first question

Prompt patterns that work well.

MCP Reference

Every tool and command.