Menu
Grafana Cloud

Configure RBAC permissions

Grafana Assistant access and functionality permissions are configurable through the Role-based access control (RBAC) function in Grafana Cloud. This page tells you how to configure Assistant access on an organizational level and control specific Assistant features like rules, Assistant Investigations, and MCP server management.

RBAC user-based roles

You can use RBAC permissions to control which users can access Grafana Assistant and use its features.

Basic organizational roles

The following basic roles provide access to Grafana Assistant functionality:

Basic RoleAccess
AdminFull access to all Assistant features including chat, investigations, MCP servers, and tenant-wide rule management.
EditorAccess to Assistant chat, investigations, and personal MCP server management.
ViewerBasic access to Assistant chat with read-only capabilities.
No basic roleNo access to Assistant unless additional Assistant roles are assigned.

These permissions apply to Assistant functionality across your Grafana instance.

Assistant-specific roles

You can also assign Assistant-specific roles to grant access independently of a user’s basic role. This is useful when you want to grant individual access to users who don’t have an Editor or Admin basic role.

Assistant RoleAccess
Assistant AdminCan manage both user and tenant-wide Assistant resources and settings including MCP servers and rules.
Assistant MCP UserCan use Grafana Assistant and add personal MCP servers in addition to basic functionality.
Assistant UserBasic access to Grafana Assistant with read-only capabilities and personal rule management.
Assistant Investigation UserCan use Assistant Investigations for advanced troubleshooting capabilities.

Configure Assistant access across Grafana

To grant a user permission to use Grafana Assistant with basic capabilities across your Grafana Cloud instance:

  1. Sign in to Grafana as an organization administrator.
  2. In the left navigation menu, click Administration > Users and access > Users.
  3. Search for the user whose permissions you want to update.
  4. In the Role field, assign the following role: Assistant > Assistant User.
  5. Click Apply to save the changes.

Configure investigation access

To allow a user to access Assistant Investigations for advanced troubleshooting:

  1. Sign in to Grafana as an organization administrator.
  2. In the left navigation menu, click Administration > Users and access > Users.
  3. Search for the user whose permissions you want to update.
  4. In the Role field, assign the following role: Assistant > Assistant Investigation User.
  5. Click Apply to save the changes.

Configure admin access

To grant a user administrative access to manage tenant-wide Assistant settings:

  1. Sign in to Grafana as an organization administrator.
  2. In the left navigation menu, click Administration > Users and access > Users.
  3. Search for the user whose permissions you want to update.
  4. In the Role field, assign the following role: Assistant > Assistant Admin.
  5. Click Apply to save the changes.

RBAC permissions

Grafana Assistant supports the following RBAC permissions:

PermissionDescriptionScope
plugins.app:accessAccess to the Assistant pluginplugins:id:grafana-assistant-app
grafana-assistant-app.chats:accessAccess to Assistant chat functionalityn/a
grafana-assistant-app.rules.user:readRead user-level rulesn/a
grafana-assistant-app.rules.user:createCreate user-level rulesn/a
grafana-assistant-app.rules.user:writeUpdate user-level rulesn/a
grafana-assistant-app.rules.user:deleteDelete user-level rulesn/a
grafana-assistant-app.rules.tenant:readRead tenant-level rulesn/a
grafana-assistant-app.rules.tenant:createCreate tenant-level rulesn/a
grafana-assistant-app.rules.tenant:writeUpdate tenant-level rulesn/a
grafana-assistant-app.rules.tenant:deleteDelete tenant-level rulesn/a
grafana-assistant-app.mcps.user:readRead user MCP serversn/a
grafana-assistant-app.mcps.user:createCreate user MCP serversn/a
grafana-assistant-app.mcps.user:writeUpdate user MCP serversn/a
grafana-assistant-app.mcps.user:deleteDelete user MCP serversn/a
grafana-assistant-app.mcps.tenant:readRead tenant MCP serversn/a
grafana-assistant-app.mcps.tenant:createCreate tenant MCP serversn/a
grafana-assistant-app.mcps.tenant:writeUpdate tenant MCP serversn/a
grafana-assistant-app.mcps.tenant:deleteDelete tenant MCP serversn/a
grafana-assistant-app.investigations:readRead investigationsn/a
grafana-assistant-app.investigations:createCreate investigationsn/a

To perform specific Assistant actions, users must be granted multiple permissions across the Assistant app and plugin system.

Assistant actionRequired permissionsApplicable scope
Basic chat accessgrafana-assistant-app.chats:accessn/a
plugins.app:accessplugins:id:grafana-assistant-app
Manage personal rulesgrafana-assistant-app.rules.user:read
grafana-assistant-app.rules.user:write
grafana-assistant-app.rules.user:create
grafana-assistant-app.rules.user:delete
n/a
plugins.app:accessplugins:id:grafana-assistant-app
grafana-assistant-app.chats:accessn/a
Manage personal MCP serversgrafana-assistant-app.mcps.user:read
grafana-assistant-app.mcps.user:write
grafana-assistant-app.mcps.user:create
grafana-assistant-app.mcps.user:delete
n/a
plugins.app:accessplugins:id:grafana-assistant-app
grafana-assistant-app.chats:accessn/a
Manage tenant rulesgrafana-assistant-app.rules.tenant:read
grafana-assistant-app.rules.tenant:write
grafana-assistant-app.rules.tenant:create
grafana-assistant-app.rules.tenant:delete
n/a
plugins.app:accessplugins:id:grafana-assistant-app
grafana-assistant-app.chats:accessn/a
Manage tenant MCP serversgrafana-assistant-app.mcps.tenant:read
grafana-assistant-app.mcps.tenant:write
grafana-assistant-app.mcps.tenant:create
grafana-assistant-app.mcps.tenant:delete
n/a
plugins.app:accessplugins:id:grafana-assistant-app
grafana-assistant-app.chats:accessn/a
Use investigationsgrafana-assistant-app.investigations:read
grafana-assistant-app.investigations:write
grafana-assistant-app.investigations:create
grafana-assistant-app.investigations:delete
n/a
plugins.app:accessplugins:id:grafana-assistant-app
grafana-assistant-app.chats:accessn/a

The Assistant Admin role includes all permissions required to manage Assistant functionality. The Assistant MCP User role includes permissions for chat and personal MCP server management. The Assistant User role includes basic chat access and personal rule management.