Install in Claude Code
Run the Stratta MCP server locally in Claude Code, with an API key.
This page installs the local server in Claude Code: the npm package runs on your machine and authenticates with an API key.
The shorter path needs no package and no key. Add Stratta as a remote
connector, then type /mcp and authorise it in the browser:
claude mcp add --transport http stratta --scope user https://stratta.ch/mcpThat is what the dashboard guides you through, and it serves everything but
add_attachment. See Connect an agent from the browser.
Paste Read stratta.ch/installer/claude-code and install Stratta for me.
into Claude Code and it does it on its own.
The local server is for an agent that cannot open a browser (CI, a scheduled task), for
add_attachment, or when you would rather run it yourself.
Requirements
- Claude Code installed.
- Node.js 20 or newer (
node --versionto check). - A Stratta account. No key to prepare: one is created for you in step 2.
1. Add the server
claude mcp add stratta --scope user -- npx -y @stratta/mcp--scope user makes the server available in every project you open. Without it, claude mcp add
only writes to the current folder's config: the server exists where you typed the command, and
appears to have vanished everywhere else.
Lighter variant: add --simple to the command to expose only the 10
norm-reading tools (npx -y @stratta/mcp --simple). See Simple
mode.
npx -y @stratta/mcp always fetches the latest published version. No manual
updates needed.
2. Connect your account
npx -y @stratta/mcp loginYour browser opens on Stratta. You see which machine is asking for access and for which
organisation, then you authorise it. The key comes back over a local port and is written to
~/.stratta/config.json (mode 0600, readable by you alone).
Nothing to copy, nothing to paste, and the key never touches your clipboard.
Without a browser
On a server, over SSH, or in CI, two fallbacks:
Create a key at Intégrations › Clés d’API (API keys), then:
npx -y @stratta/mcp login --pasteYour input is not echoed, and the key ends up in the same place.
Verify it works
Start a conversation and ask Claude to list the available norms, for example:
List the documents available in Stratta.Claude should call list_norms and return the norms in your workspace. If the tools don't
appear, see Troubleshooting.
claude mcp logs stratta.How the key is resolved
The server looks for your key in this order:
- The
STRATTA_API_KEYenvironment variable. ~/.stratta/config.json(written byloginor the first-use prompt).- An interactive prompt on first use (clients that support it).
Full details in MCP Reference → Overview.