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
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
- Click Add rule.
- Under Applies to, select A smart group and choose the Smart group, or select A single user and enter the User email.
- Leave Rule active on. Turning it off stops applying this override; it does not block the server.
- Set only the overrides you need. Anything left at Inherit keeps the server's base setting.
- 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
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:
"Strictest" means, for each field:
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.
- Under Effective settings preview, enter a User email.
- 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:
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
destructiveannotation, 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.
runs on requestpriority 800
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.
Related
- Server access - allow or deny groups and users on the server.
- Security guardrails - the base guardrail settings rules override.
- Token saving - the base token saving strategies.
- Tool visibility - base tool settings and confirmation.
- Policy Engine overview - how cards, stages and priorities work.