Install in Claude Code

Add the Stratta MCP server to Claude Code: the recommended setup.

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 is 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:

The STRATTA_API_KEY environment variable.
~/.stratta/config.json (written by login or the first-use prompt).
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.