Skip to main content

Group and user rules

Give a smart group or a single person different settings on one MCP server. A rule can turn tools on or off, require confirmation, change guardrail actions and enable or disable token saving without changing other users' settings.

Configure it on the server​

Go toQuilrAI consoleSettingsAI GatewayMCP Gatewayserver cardConfigureGroup & User Rules

The section reads: "Rules override the base settings for a smart group or a single user. User rules apply after group rules." The card's Scoped rules chip shows how many rules the server has.

Add a rule​

  1. Click Add rule.
  2. Under Applies to, select A smart group and choose the Smart group, or select A single user and enter the User email.
  3. Leave Rule active on. Turning it off stops applying this override; it does not block the server.
  4. Set only the overrides you need. Anything left at Inherit keeps the server's base setting.
  5. Click Save rule.

Each saved rule shows a Smart group or User tag, a summary of what it overrides, and Rule active or Rule inactive. Use Edit or Delete to change it.

To decide who may use the server at all, use Server access instead.

What a rule can override​

SectionSettingsOptions
Tool overridesEnabled, Confirmation, Justification for each toolInherit / On / Off
Token saving overridesSmart JSON compression, HTML to text, Markdown to text, Text compressionInherit / On / Off
Guardrail overridesRequest action, Response actionInherited / Monitor / Redact / Block
Data risk categories, Adversarial risk categoriesEnabled, Request, Response for each categoryInherit / On / Off and Inherited / Monitor / Redact / Block

With Justification on, the user must type a reason to approve a confirmed call; denying a call does not require one. Setting Confirmation to On also sets Justification to On. Justification needs Confirmation. See Human approval for how confirmation works.

How rules combine​

A person can belong to several smart groups. Their settings are built in three steps:

StepAppliesWhen rules disagree
1Server base settings-
2Every active rule for a smart group the person is inThe most restrictive setting takes precedence.
3The active rule for that person's emailReplaces the result of step 2 for every field it sets.

"Strictest" means, for each field:

FieldResult when groups disagree
Tool EnabledOff if any group turns it off.
Confirmation, JustificationOn if any group turns it on.
Guardrail actionsThe most restrictive action takes precedence (Block over Redact over Monitor).
Guardrail categoriesOn if any group turns it on.
Token saving strategiesOn if any group turns it on.

A user rule takes precedence, so it can make a group setting less restrictive.

Effective settings preview​

Review one user's effective settings after all rules apply.

  1. Under Effective settings preview, enter a User email.
  2. Click Resolve.

The preview lists the tools, any hidden tools, token saving and the guardrail actions for that person. Click Show full settings to see everything.

Going further with the Policy Engine​

When the Policy Engine is on for the MCP Gateway, this section turns read-only and published policies apply instead. Edit anyway changes the stored values, which are used only if the Policy Engine is disabled. See What happens to classic settings.

The Policy Engine has no separate rules list. Every rule can match on the caller (user email, smart groups, identity provider, client IP), so a group or user override becomes a rule on the card that owns the setting:

Override hereCard in Govern > Policy Engine > MCP Gateway
Tool EnabledInvocation (stage 3, Request) to refuse calls, and Discovery Visibility (stage 2) to hide the tool
Confirmation, JustificationHuman Approval
Guardrail actions and categoriesData & Adversarial Risks
Token saving strategiesToken Savings

The Invocation card decides whether a tool call may run. Its effect is Tool call access: allow or deny. Scenarios it covers that group and user rules cannot:

  • Combine caller and tool conditions. Deny destructive tools (the tool's destructive annotation, tags or risk) for one smart group across every server, instead of switching tools off server by server.
  • Condition on the agent or route. Allow a write tool from one agent but not another, or only when the call comes through OneMCP (route kind onemcp).
  • Cover a class of servers. Match MCP tags, auth type or system MCP instead of adding the same rule to each server.
contractors_no_destructive_toolsrequest

runs on requestpriority 800

WhenSmart groupsincludes (ignoring case)Contractors
andTool is destructiveistrue
Then
Tool call accessdeny

Overlapping policies resolve differently from this section: a deny is never undone by a more permissive rule, and priority settles single values. A person-specific allow therefore cannot loosen a group deny the way a user rule can here. See the Policy Engine overview, and simulate before you publish.