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.

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
sigrid_refactoring_candidates Modernization Recipes MCP Retrieves ranked refactoring candidates for a given maintainability property
edit_sigrid_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