Claude Code

Connect Scrubby to Claude Code through the MCP server.

Setup

Add the MCP server

Add this to your project's .mcp.json file. Create it in the repository root if it doesn't exist:

{
  "mcpServers": {
    "scrubby": {
      "type": "http",
      "url": "https://mcp.scrubby.ai/mcp"
    }
  }
}

Authenticate

The first time Claude Code connects, it opens a browser window for GitHub OAuth. Sign in with your GitHub account. If the session later expires, run /mcp in Claude Code to reconnect.

Index a repository

Ask Claude Code to index the repository you're working in:

"Index this repo with Scrubby — it's owner/repo-name."

See Your First Index for what happens next.

Using Scrubby

Scrubby's usage instructions are delivered to Claude Code automatically over MCP, so it consults Scrubby before editing files, answering architecture questions, and reviewing changes. You can also ask for specific tools directly:

"Run scrubby_review on this file before editing it."
"Run scrubby_review_changeset on my changed files."
"What domains does Scrubby see in this repo?"

The full set of tools is documented in the MCP Tools reference.

Troubleshooting

Session expired — run /mcp to reconnect.
Repository not indexed — ask Claude Code to run scrubby_index with the repo in owner/repo form.
Tools not appearing — confirm .mcp.json is in the project root and the URL is correct. See Editor Not Connecting.