Claude Code Integration
Integrate AIVory Guard with Claude Code, Anthropic’s official AI coding assistant, to enable real-time compliance and security scanning directly in your terminal.
- One-command setup - Install the MCP server with a single terminal command
- Free tier available - Start immediately with OWASP Top 10 checks, no API key required
- 18+ compliance standards - Full access unlocks GDPR, HIPAA, PCI-DSS, SOC2, and more
- Interactive remediation - Claude automatically fixes violations based on scan results
Prerequisites
Before you begin, ensure you have:
Quick Start
Choose your setup based on your needs:
Free Tier (No API Key Required)
Get started immediately with OWASP Top 10 compliance checks:
claude mcp add --transport stdio aivory -- npx -y @aivorynet/guard
Restart Claude Code and you’re ready to scan!
Full Access (With API Key)
For unlimited scanning and all 18+ compliance standards:
Step 1: Get your API key from app.aivory.net/tokens
Step 2: Configure with your API key:
claude mcp add \
--transport stdio \
--env AIVORY_API_KEY=your-api-key \
aivory \
-- npx -y @aivorynet/guard
Configuration
AIVory Guard automatically connects to https://app.aivory.net. No additional configuration needed!
Custom Backend URL (Self-Hosted)
If using a self-hosted backend:
claude mcp add \
--transport stdio \
--env AIVORY_SERVER_URL=https://your-backend.com \
--env AIVORY_API_KEY=your-api-key \
aivory \
-- npx -y @aivorynet/guard
Usage
Once configured, AIVory Guard tools are available in Claude Code.
Recommended Prompts
Use clear, direct prompts like:
"Please scan this code against AIVory for OWASP compliance and fix any violations."
"Use AIVory to check this file for GDPR compliance issues."
"Scan my authentication code with AIVory and fix security issues based on the feedback."
Example Workflow
You: "I just wrote this user login function. Please scan it with AIVory
for security compliance and fix any issues you find."
Claude will:
1. Use AIVory MCP tools to scan your code
2. Review the compliance violations returned
3. Implement fixes based on AIVory's recommendations
4. Re-scan to verify the fixes work
AIVory Claude Code Plugin
For enhanced features, install the official AIVory Claude Code plugin with slash commands.
# Add AIVory marketplace
/plugin marketplace add aivorynet/claude-marketplace
# Install plugin
/plugin install aiv
Verification
Test your installation to ensure everything is working correctly.
Check MCP Server Status
# List configured MCP servers
claude mcp list
# Should show:
# aivory - @aivorynet/guard (stdio)
Test the Connection
Ask Claude to verify the integration:
"Can you check if AIVory is working?"
Check Available Tools
You can also list all available MCP tools:
# List available MCP tools
/mcp
# You should see AIVory tools listed
Troubleshooting
MCP Server Not Found
If the server isn’t appearing in the list:
# List configured servers
claude mcp list
# Re-add if missing
claude mcp remove aivory
claude mcp add --transport stdio aivory -- npx -y @aivorynet/guard
Then restart Claude Code.
Connection Errors
If you see connection errors, verify the backend is accessible:
curl https://app.aivory.net/health
Should return: {"status":"healthy"}
If the health check fails, check your network connection and firewall settings.
Rate Limit Errors
Free tier users may see rate limits after 3 scans/day or 15 files/scan.
Solution: Upgrade to full access at app.aivory.net/register/plans
Support
Need help with your Claude Code integration?