CanopyIQ CanopyIQ / Documentation / MCP Server Setup
← Back to Docs

MCP Server Setup for Claude Code

Complete guide to integrating CanopyIQ MCP server with Claude Code for security monitoring and approval workflows.

Quick Start (30 seconds)

1

Install

npm install -g canopyiq-mcp-server

Install the MCP server globally

2

Configure

Add to Claude Code config:

claude_desktop_config.json

Done!

Restart Claude Code and you're secured

Step 1: Install CanopyIQ MCP Server

Install via npm (recommended)

npm install -g canopyiq-mcp-server

Alternative: Use npx (no global install)

npx canopyiq-mcp-server --version

This method doesn't require global installation and always uses the latest version.

Step 2: Configure Claude Code

Find your Claude Code configuration file:

📁 macOS Location:

~/Library/Application Support/Claude/claude_desktop_config.json

📁 Windows Location:

%APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "canopyiq": {
      "command": "npx",
      "args": ["canopyiq-mcp-server", "--api-key", "YOUR_API_KEY_HERE"]
    }
  }
}

🔑 API Key: Get your API key from your CanopyIQ Dashboard or create a free account.

Step 3: Restart Claude Code

✅ Setup Complete!

Close and reopen Claude Code. CanopyIQ will now monitor and secure all your tool usage.

What you'll get:

  • • Real-time logging of all Claude tool calls
  • • Human approval workflows for risky operations
  • • Policy enforcement and rate limiting
  • • Slack/email notifications for security events
  • • Complete audit trail for compliance

Advanced Configuration

Environment Variables

CANOPYIQ_API_KEY - Your API key
CANOPYIQ_SERVER_URL - Custom server URL
CANOPYIQ_TIMEOUT - Request timeout (default: 30s)

Command Line Options

--api-key - Specify API key directly
--server-url - Custom CanopyIQ server
--debug - Enable debug logging

Troubleshooting

❌ MCP server not appearing in Claude Code?

  • • Verify the config file path is correct for your OS
  • • Check JSON syntax with a validator
  • • Ensure Claude Code was completely restarted
  • • Check terminal for npm/npx installation errors

⚠️ Authentication errors?

  • • Verify your API key is correct
  • • Check that your CanopyIQ account is active
  • • Ensure no extra spaces in the configuration

💡 Need help?

Contact our support team at support@canopyiq.ai or join our community for help with setup and configuration.