API Keys and AI Agent Settings

Accessing Integration Settings

Navigate to Settings > Integrations (or AI Agent) from the settings sidebar.

AI Agent Configuration

Enabling the AI Agent

Toggle the AI agent on or off for your organization. When enabled, the AI assistant icon appears in the navigation for admins.

Approval Requirements

Configure which agent actions require admin approval before execution:

• Delete operations: Require approval before the agent deletes any records
• Bulk operations: Require approval for actions that affect multiple records at once
• Approval expiry: Set how long a pending approval remains active before expiring (in hours)

These controls let you balance automation speed with safety.

Agent Actions Queue

When the AI agent or an external integration performs an action that requires approval:

1. The action is added to the queue
2. An admin reviews the pending action
3. The admin approves or rejects it
4. If approved, the action is executed

View pending actions from the Agent Actions section in integration settings.

API Keys

API keys allow external tools and integrations to interact with your CrewHR data.

Creating an API Key

1. Go to the API Keys section
2. Click Create API Key
3. Give the key a descriptive name (e.g., "MCP Integration" or "Reporting Tool")
4. The key is generated and displayed once. Copy it immediately as it will not be shown again.

Using API Keys

Include the API key in requests to the CrewHR API:

X-API-Key: your-api-key-here

API keys are scoped to your tenant (organization). All data accessed through the API is limited to your organization's data.

Revoking API Keys

1. Find the key in the API Keys list
2. Click Revoke or Delete
3. The key is immediately invalidated

Revoke keys that are no longer needed or that may have been compromised.

Activity Log

The activity log shows all actions performed by external agents and API integrations:

• What action was performed
• When it happened
• The result (success or failure)

This provides an audit trail for all automated and external interactions with your data.

MCP (Model Context Protocol)

CrewHR supports MCP for AI agent integration. MCP allows external AI tools to query and interact with your scheduling data in a structured way.

To use MCP:

1. Create an API key (see above)
2. Configure your external AI tool with the CrewHR MCP endpoint
3. Use the API key for authentication

Tips

• Use descriptive key names: Name your API keys based on what system uses them so you can track and manage them easily
• Revoke unused keys: Periodically review your API keys and revoke any that are no longer in use
• Start with approval required: When first enabling the AI agent, require approval for all action types until you are comfortable with how it operates
• Monitor the activity log: Review agent activity regularly to ensure integrations are working as expected