Search documentation

Search documentation

Get an API key

Create the key that connects the Stratta MCP server to your workspace.

An API key is how the Stratta MCP server proves it's allowed to read and write your workspace.

The easy way: sign in through your browser

Most of the time there is no key to create and nothing to copy. One command does it:

npx -y @stratta/mcp login

Your browser opens on stratta.ch, you sign in as usual, you see which machine and which organisation are involved, and you click Authorise. The key is created for you, handed straight back to the terminal, and saved to ~/.stratta/config.json. It is never shown on screen.

The key is named after your machine, which makes it easy to recognise later on Intégrations › Clés d’API (API keys) when you want to revoke it.

No browser on this machine (remote server, SSH session, CI)? Use npx -y @stratta/mcp login --paste and follow the manual steps below.

Create a key by hand

  1. Open Réglages › Intégrations (Settings › Integrations)

  2. Create a key

    Click Create API key, give it a memorable name (for example "Laptop: Claude Code"), and confirm. A name helps you recognise and revoke the right key later.

  3. Copy the key immediately

    The full key, starting with sk_strt_, is displayed once. Copy it now.

    For security, Stratta never shows the full key again. If you lose it, revoke it and create a new one.

  4. Give it to your Claude client

    Follow Install in Claude Code or Install in Claude Desktop. You can paste the key when prompted, save it with npx -y @stratta/mcp login --paste, or set it as an environment variable.

Treat your key like a password

Your API key grants read and write access to your workspace, including ingesting and deleting norms. Never commit it to a repository, paste it into a shared or project-scoped MCP config, or post it in logs or chat. Prefer a user-scoped config or an environment variable. If a key leaks, revoke it immediately at Intégrations › Clés d’API (API keys).

Limits

To prevent abuse, each user can hold:

LimitValue
Active API keys50
New keys per 24 hours20

If you hit a limit, revoke keys you no longer use. See Manage API keys.

Next steps