@caylex/permissions-widget

An embeddable React widget for managing per-tool permissions on a Caylex agent instance.

Lets your end users review which MCP tools their agent has access to and toggle them on or off — with optional persistence to your backend.

Installation

npm install @caylex/permissions-widget
# or
yarn add @caylex/permissions-widget

Peer dependencies:

npm install react react-dom antd @ant-design/cssinjs @emotion/cache @emotion/react @emotion/styled @ant-design/icons lodash.merge @caylex/shared

Usage

import { CaylexToolPermissionsWidget } from '@caylex/permissions-widget';

export function PermissionsPage() {
  return (
    <CaylexToolPermissionsWidget
      apiBaseUrl="https://api.caylex.ai/api/v1/"
      widgetToken="YOUR_WIDGET_TOKEN"
      theme="light"
      primaryColor="#3F58CF"
      persistPermissions
    />
  );
}

Configuration

See the CaylexToolPermissionsWidgetConfig type for all available props (theme colors, persistence, callbacks).

CDN usage

<div id="caylex-permissions"></div>
<script src="https://cdn.caylex.ai/permissions-widget.js"></script>
<script>
  CaylexPermissions.render('#caylex-permissions', {
    apiBaseUrl: 'https://api.caylex.ai/api/v1/',
    widgetToken: 'YOUR_WIDGET_TOKEN',
  });
</script>

License

Proprietary © Caylex