Settings

Developer settings

API keys and MCP access for the organization.

RolesAdminRoute/settings?tab=developerShown toAll organizations

What it is

The Developer tab is where admins create and revoke API keys. A key authenticates REST calls and headless MCP clients against the organization. Interactive MCP clients such as Cursor and Claude Desktop do not need a key; they sign in with OAuth. The tab links to the full API documentation, and the Developers section of these docs covers everything beyond key management.

Where to find it

SettingsDeveloper
Developer tab with the API and MCP documentation card and the API keys cardDeveloper tab with the API and MCP documentation card and the API keys card
Two cards: documentation and links on top, key management below.

Key actions

Generate an API key

Click Generate API Key to open the Generate New API Key form.
Enter a Key Name that says where the key will live, for example "Cursor Integration".
Optionally set Expiration (days, optional). Leave it blank for a key that never expires.
Tick the scopes you need under Scopes (permissions). Each scope is a read or write grant for one area, from Read Frameworks through Write Internal Audits.
Click Generate API Key. Skipping the name or every scope shows "Provide a name and select at least one scope".
Copy the key from the banner that says "Save this API key now — it will not be shown again." using Copy, then Dismiss.
Generate New API Key form with name, expiration, and a grid of scope checkboxesGenerate New API Key form with name, expiration, and a grid of scope checkboxes
Pick the smallest set of scopes the client needs.

Revoke a key

Click the trash icon on the row. The dialog Revoke API key names the key and warns: "Any REST or MCP client using this key will immediately lose access. OAuth-issued tokens are unaffected. This action cannot be undone." Click Revoke Key. The row stays in the table with a Revoked badge.

Statuses and fields

ColumnMeaning
NameThe label you gave the key
Key PrefixThe first characters, enough to match against a client config
ScopesGranted permissions
Last UsedUpdated automatically on each REST or MCP call; "Never" until then
CreatedCreation time
ExpiresExpiry date, or none
ActionsRevoke

Tips and gotchas

The full key is shown once. If you lose it, revoke it and generate a new one; there is no way to display it again.

One key per client, named after the client. When something misbehaves the Last Used column tells you which integration is still calling, and you can revoke one without breaking the others.

Keys belong to the organization, not to you. Revoking your own membership does not revoke keys you created.

What Noru does not do

Noru does not rotate keys automatically, and it does not restrict a key to an IP range. A key with a write scope can change data exactly as an editor could through the UI.

Last updated on