Claude Code Integration

Claude Code is Anthropic’s CLI tool for AI-assisted development. With AnomalyArmor integration, you can monitor data quality, investigate issues, and manage alerts through natural conversation.

Setup

Option 1: Remote Server (Recommended)

Connect directly to AnomalyArmor’s hosted MCP server. No installation or API key required. You sign in with your AnomalyArmor account.

claude mcp add anomalyarmor --transport http https://mcp.anomalyarmor.ai/mcp

The first time you use a tool, Claude Code will open a browser window to sign in. After that, your session stays authenticated.

Option 2: Local Server (API Key)

For air-gapped environments or custom setups, run the MCP server locally:

pip install armor-mcp

Then add to your Claude Code MCP configuration (~/.claude/mcp.json):

{
  "mcpServers": {
    "anomalyarmor": {
      "command": "armor-mcp",
      "env": {
        "ANOMALYARMOR_API_KEY": "your-api-key"
      }
    }
  }
}

Get your API key from Settings > API Keys in the AnomalyArmor dashboard.

Option 3: Skills (Recommended for Slash Commands)

Install the /armor:* skills using the skills.sh CLI. Works with Claude Code, Cursor, Windsurf, Codex, and 40+ other agents:

npx skills add anomalyarmor/agents

Or install the native Claude Code plugin:

claude plugin install armor@anomalyarmor

Both options give you access to skills like /armor:status, /armor:alerts, and more. Source: github.com/anomalyarmor/agents. If you install the Claude Code plugin without an ARMOR_API_KEY or ~/.armor/config.yaml, the skills’ pre-tool-use hook mints a short-lived read-only API key and runs your prompt against a synthetic BalloonBazaar demo dataset. You get a real answer before you commit to a signup.

Safety rails ride automatically: the demo key has scope=read-only, expires after 1 hour, is rate-limited per IP, and points at synthetic data only. Writes return 403, at which point the skill surfaces a signup URL that preserves your exact question so it replays into the in-app agent after you finish signup.

Using Skills

With the plugin installed, use slash commands:

/armor:status    # Check data health
/armor:alerts    # View recent alerts
/armor:ask       # Ask questions about your data
/armor:analyze   # Trigger AI analysis

Example Conversations

Check Data Health

You: /armor:status

Claude: Here's your data health summary:

Overall Status: WARNING

Issues:
- 2 tables are stale (orders, customers)
- 1 unacknowledged schema change
- 3 alerts triggered in the last 24 hours

Recommended actions:
1. Check the orders ETL pipeline
2. Review schema change in users table

Investigate an Issue

You: Why is the orders table stale?

Claude: Let me investigate...

The orders table hasn't updated since yesterday 6:00 AM.

Root cause: The upstream staging.orders_raw table is also stale.
This appears to be related to an ETL job failure.

Lineage shows 7 downstream tables are affected:
- gold.daily_revenue
- gold.customer_metrics
- reporting.exec_dashboard
...

Recommended: Check your Airflow logs for the orders_etl DAG.

Query Alerts

You: What critical alerts fired this week?

Claude: Found 2 critical alerts this week:

1. [CRITICAL] Freshness SLA breach - orders
   Triggered: Monday 8:15 AM
   Status: Unresolved

2. [CRITICAL] Schema breaking change - users.email removed
   Triggered: Tuesday 3:30 PM
   Status: Acknowledged

Available Skills

Skill	Description
`/armor:status`	Health summary across all assets
`/armor:alerts`	Query and manage alerts
`/armor:connect`	Connect a new data source
`/armor:monitor`	Set up freshness monitoring
`/armor:ask`	Natural language Q&A
`/armor:analyze`	Trigger AI analysis
`/armor:quality`	Data quality checks
`/armor:lineage`	Explore data dependencies
`/armor:investigate`	Root cause analysis

You can also ask questions naturally without using slash commands. Claude will use the appropriate tools automatically.

Configuration

Remote Server (OAuth)

No configuration file needed. Authentication is handled automatically through your browser. To re-authenticate or check connection status:

/mcp

Select the anomalyarmor server to reconnect or view status.

Local Server / Plugin (API Key)

Set your API key in ~/.armor/config.yaml:

api_key: aa_live_your_key_here

Or use an environment variable:

export ARMOR_API_KEY="aa_live_your_key_here"

Verify Connection

Check that MCP tools are available:

claude mcp list

You should see anomalyarmor listed with a connected status.

Troubleshooting

Remote Auth: Browser Not Opening

Solution:

Run /mcp in Claude Code and select reconnect
If behind a proxy, you may need to use the local server option instead

Remote Auth: Empty Responses

If tools connect but return no data: Solution:

Clear auth and re-authenticate: remove the server with claude mcp remove anomalyarmor, then re-add it
Verify you have data sources connected in the AnomalyArmor dashboard

Skills Not Loading

Solution:

Verify plugin installed: claude plugin list
Restart Claude Code
Check for updates: claude plugin update armor@anomalyarmor

API Key Auth Error

Solution:

Verify API key is set correctly in your MCP config or env var
Check key permissions in AnomalyArmor dashboard
Regenerate key if needed

Next Steps

Common Questions

How do I add the AnomalyArmor MCP server to Claude Code?

Run

claude mcp add anomalyarmor https://mcp.anomalyarmor.ai/mcp --transport http --header "Authorization: Bearer $ARMOR_API_KEY"

. Or add it to ~/.claude.json manually under mcpServers. Both methods are equivalent. Restart Claude Code to pick up the change.

Do I need a Claude API key to use AnomalyArmor in Claude Code?

You need a Claude Code install (which authenticates to Anthropic separately) and an AnomalyArmor API key. Get the AnomalyArmor key from Settings → API Keys. Claude Code itself handles Anthropic auth via its own login flow.

Can I try AnomalyArmor in Claude Code without creating an account?

Yes - use the demo flow. Claude Code will auto-mint a short-lived demo key (1-hour expiry, read-only) the first time you invoke an AnomalyArmor skill. To get your own data, sign up at app.anomalyarmor.ai/sign-up and swap in a real API key.

Why do some AnomalyArmor actions in Claude Code ask for confirmation while others don’t?

Read-only tools (check freshness, list alerts, describe asset) execute immediately. Mutating tools (create metric, dismiss alert, update tag) require confirmation via Claude Code’s tool-use approval flow so you never accidentally change state. You can trust-list specific tools in Claude Code’s settings.

Skills Reference

Complete skills documentation

MCP Server

Advanced MCP configuration

Python SDK

Programmatic access

API Reference

REST API documentation

API Overview

API Reference

API Guides

SDKs

CLI

Integrations

AI Agents

Claude Code Integration

Setup

Option 1: Remote Server (Recommended)

Option 2: Local Server (API Key)

Option 3: Skills (Recommended for Slash Commands)

Using Skills

Example Conversations

Check Data Health

Investigate an Issue

Query Alerts

Available Skills

Configuration

Remote Server (OAuth)

Local Server / Plugin (API Key)

Verify Connection

Troubleshooting

Remote Auth: Browser Not Opening

Remote Auth: Empty Responses

Skills Not Loading

API Key Auth Error

Next Steps

Common Questions

How do I add the AnomalyArmor MCP server to Claude Code?

Do I need a Claude API key to use AnomalyArmor in Claude Code?

Can I try AnomalyArmor in Claude Code without creating an account?

Why do some AnomalyArmor actions in Claude Code ask for confirmation while others don’t?

Skills Reference

MCP Server

Python SDK

API Reference

​Setup

​Option 1: Remote Server (Recommended)

​Option 2: Local Server (API Key)

​Option 3: Skills (Recommended for Slash Commands)

​Demo mode (no signup required)

​Using Skills

​Example Conversations

​Check Data Health

​Investigate an Issue

​Query Alerts

​Available Skills

​Configuration

​Remote Server (OAuth)

​Local Server / Plugin (API Key)

​Verify Connection

​Troubleshooting

​Remote Auth: Browser Not Opening

​Remote Auth: Empty Responses

​Skills Not Loading

​API Key Auth Error

​Next Steps

​Common Questions

​How do I add the AnomalyArmor MCP server to Claude Code?

​Do I need a Claude API key to use AnomalyArmor in Claude Code?

​Can I try AnomalyArmor in Claude Code without creating an account?

​Why do some AnomalyArmor actions in Claude Code ask for confirmation while others don’t?

Skills Reference

MCP Server

Python SDK

API Reference

Setup

Option 1: Remote Server (Recommended)

Option 2: Local Server (API Key)

Option 3: Skills (Recommended for Slash Commands)

Demo mode (no signup required)

Using Skills

Example Conversations

Check Data Health

Investigate an Issue

Query Alerts

Available Skills

Configuration

Remote Server (OAuth)

Local Server / Plugin (API Key)

Verify Connection

Troubleshooting

Remote Auth: Browser Not Opening

Remote Auth: Empty Responses

Skills Not Loading

API Key Auth Error

Next Steps

Common Questions

How do I add the AnomalyArmor MCP server to Claude Code?

Do I need a Claude API key to use AnomalyArmor in Claude Code?

Can I try AnomalyArmor in Claude Code without creating an account?

Why do some AnomalyArmor actions in Claude Code ask for confirmation while others don’t?