Claude Code & Claude.ai

Claude Code is Anthropic's CLI agent. Handler connects via MCP with full OAuth support — the richest integration available.

Setup

There are two ways to connect Handler to Claude Code. OAuth is recommended because it handles authentication automatically and issues rotating tokens.

Option A — OAuth (recommended)

Run this single command in your terminal:

claude mcp add --transport http handler https://mcp.usehandler.dev/mcp

That's it. The first time you use a Handler tool, Claude will open your browser for OAuth authentication. After you authorize, the connection is persistent — no keys to manage or rotate.

Option B — API Key

If you prefer to use an API key (for CI environments, shared configs, or headless setups), add Handler to your ~/.claude.json:

{
  "mcpServers": {
    "handler": {
      "url": "https://mcp.usehandler.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk-hndlr-YOUR_KEY"
      }
    }
  }
}

Replace sk-hndlr-YOUR_KEY with the agent key from your Handler dashboard.

Usage

Once connected, start by checking what your agent can do:

// Ask Claude to check Handler status
"What superpowers do I have via Handler?"

// Claude calls handler_status and shows you:
// - Available superpowers
// - Current budget and remaining calls
// - Governance rules in effect
// - Connected services

Then use any superpower naturally in conversation:

// Research
"Search for the latest React 19 migration patterns"

// B2B intelligence
"Find the CTO of Vercel and enrich their profile"

// Financial data
"Get me the current NVIDIA stock price and recent news"

// Monitoring
"Check Twitter for mentions of our product launch"

Claude will pick the right superpower and task automatically based on your request. Every response includes cost and budget information so you always know what was spent.

Claude.ai

The same MCP configuration works in the Claude.ai web interface. To set it up:

https://mcp.usehandler.dev/mcp

Tips

• Start with handler_status. It shows your available superpowers, budget, governance rules, and connected services. It costs nothing.
• Use the task parameter for precision. Each superpower supports multiple tasks. If you want a specific action (like read instead of search), tell Claude which task to use.
• Check the budget in every response. Each Handler response includes a budget object showing remaining balance and calls. If you're close to a cap, you'll see it before hitting the limit.
• Connect services inline. If Claude tries to use a service that isn't connected yet (like GitHub or Gmail), Handler returns an OAuth URL. Click it, authorize, and retry — no separate setup needed.
• OAuth tokens rotate automatically. With Option A, you never need to manage keys. Handler issues short-lived JWTs behind the scenes while your agent key stays stable.