Documentation

Sigrid MCP Integrations

Sigrid MCP integrations let AI coding tools use Sigrid’s analysis while you work — catching security and quality issues as they’re introduced, and driving down technical debt through guided refactoring.

Start with Guardrails for automatic quality checks on new code. Add Recipes when you’re ready to tackle existing technical debt.

Installation

The Sigrid AI Toolkit is a Claude Code plugin that automatically configures both the Sigrid MCP server and the associated skills. This is the easiest way to get started.

/plugin marketplace add Software-Improvement-Group/sigrid-ai-toolkit
/plugin install sigrid@sigrid-ai-toolkit

The installer will prompt for your Sigrid API token and store it securely in the system keychain.

Manual configuration (other IDEs)

For IDEs other than Claude Code, configure the MCP server manually:

Supported IDEs

Tool Connection Type Configuration Method Status
Cursor Direct HTTP MCP & Integrations panel ✅ Fully Supported
VSCode w/ Github Copilot plugin HTTP via GitHub Copilot Agent mode → Tools menu ✅ Supported
VSCode native Proxy (mcp-remote) MCP settings ✅ Supported
Windsurf Proxy (mcp-remote) MCP settings ✅ Supported
Claude Code Proxy (mcp-remote) CLI command ✅ Supported
OpenCode Direct HTTP opencode.json ✅ Supported
IntelliJ/PyCharm/WebStorm HTTP via AI Chat Manual JSON edit ✅ Supported

Connection types explained

Direct HTTP

HTTP via GitHub Copilot Extension

Proxy (mcp-remote)

Cursor / GitHub Copilot Plugin

{
  "mcpServers": {
    "SigridCode": {
      "url": "https://sigrid-says.com/mcp",
      "headers": {
        "Authorization": "Bearer <your_sigrid_token>"
      }
    }
  }
}

VSCode

Add:

{
  "servers": {
    "SigridCode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://sigrid-says.com/mcp",
        "--header",
        "Authorization: Bearer <your_sigrid_token>",
        "--allow-http"
      ]
    }
  }
}

Visual Studio

Windsurf

{
  "mcpServers": {
    "SigridCode": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://sigrid-says.com/mcp",
        "--header",
        "Authorization: Bearer <your_sigrid_token>",
        "--allow-http"
      ]
    }
  }
}

Claude Code (manual)

claude mcp add --transport http SigridCode https://sigrid-says.com/mcp --header "Authorization: Bearer <your_sigrid_token>"

Alternatively, using a proxy:

claude mcp add SigridCode -- npx mcp-remote https://sigrid-says.com/mcp --header "Authorization: Bearer <your_sigrid_token>" --allow-http

Replace <your_sigrid_token> with your actual Sigrid API token. Restart Claude Code after adding.

OpenCode

{
  "mcp": {
    "SigridCode": {
      "type": "remote",
      "url": "https://sigrid-says.com/mcp",
      "headers": {
        "Authorization": "Bearer <your_sigrid_token>"
      }
    }
  }
}

IntelliJ / PyCharm / WebStorm

Navigate to Tools > AI Assistant > Model Context Protocol (MCP) and add:

"mcpServers": {
    "CodeGuardrails": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://sigrid-says.com/mcp",
        "--header",
        "Authorization: Bearer <your_sigrid_token>",
        "--allow-http"
      ]
    }

IBM Bob

Navigate to Settings (the cogwheel icon inside the Bob chat window) > MCP. Configure a global or project-specific MCP server:

{
    "mcpServers":
    {
        "CodeGuardrails": {
            "type": "streamable-http",
            "url": "https://sigrid-says.com/mcp",
            "headers": {
              "Authorization": "Bearer <your_sigrid_token>"
            }
        }
    }
}

Note the extra outer brackets required for the configuration to validate successfully. Save the configuration and verify the connection on the settings page.

Available tools reference

Tool Product Description
code_quality_guardrails Guardrails MCP Checks code for maintainability issues and security vulnerabilities
refactoring_candidates Modernization Recipes MCP Retrieves ranked refactoring candidates for a given maintainability property
maintainability_ratings Modernization Recipes MCP Returns current maintainability ratings for a system
list_security_findings Modernization Recipes MCP Returns open security findings ranked by severity
list_reliability_findings Modernization Recipes MCP Returns open reliability findings ranked by severity
edit_finding_status Modernization Recipes MCP Updates the status and remarks of a Sigrid finding

Troubleshooting

Issue Solution
“Server not found” Verify token is valid
“mcp-remote not found” Run npm install -g mcp-remote
IntelliJ not working Check manual JSON file location for your OS
Connection fails Ensure –allow-http flag is present (proxy mode)
Bad Request: No valid session ID provided Restarting the client and/or simply enabling/disabling the MCP servers
AI Coding Assistant ignores MCP tool Try one of the recommended LLMs: GPT-5, Claude 4 series, Gemini 2.5 series or higher

On this page