Skip to main content

Set up Agent Monitor for Claude Code

Install the MintMCP plugin to send Claude Code activity to Agent Monitor.

Agent Monitor setup page

Install the plugin​

Run these commands in Claude Code:

/plugin marketplace add mintmcp/mintmcp-claude-code
/plugin install monitor

This installs the plugin from our GitHub repository.

Set the organization key​

Get your organization key from the Agent Monitor Setup page, then choose a distribution approach.

Individual setup​

Each user adds the key to ~/.claude/settings.json:

{
  "env": {
    "MINTMCP_ORG_KEY": "llmorgkey_XXXXXXXXXXXXXXXXXXXXXXXXXX"
  }
}

Optional: Set MINTMCP_USER to customize the display name in logs (defaults to $USER).

Managed settings (claude.ai)​

Use this when you want to distribute the key org-wide without MDM. The key rolls out to all users immediately; users still install the plugin themselves.

  1. Go to claude.ai/admin-settings/claude-code.
  2. Add MINTMCP_ORG_KEY to the managed-settings.json configuration:
{
  "env": {
    "MINTMCP_ORG_KEY": "llmorgkey_XXXXXXXXXXXXXXXXXXXXXXXXXX"
  }
}
claude.ai admin settings showing managed-settings.json with MINTMCP_ORG_KEY configured
  1. Save the settings.

On the next Claude Code launch, each user sees a confirmation screen asking them to accept the new environment variable. The key takes effect after they confirm.

Claude Code confirmation screen prompting the user to accept the new MINTMCP_ORG_KEY environment variable

Users do not need to edit settings.json themselves — the key is applied automatically once they confirm.

MDM configuration​

For enterprise deployments where you need staged rollouts, configure the plugin and key via MDM. See the Agent Monitor Setup page for MDM configuration options.

Verify​

After setup, activity appears in Live Activity.

Other clients​