Documentation
⭐️ Announcing Sigrid IDE integrations for Visual Studio Code, JetBrains, and Mendix Studio Pro.
You can use these integrations to check Sigrid findings as you work on your code, triage findings, and export findings to your issue tracker if you're not able to fix them right away.
Have you tried them? We'd love your feedback: Share it in our short survey.

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 Auto-fix Agents when you’re ready to tackle existing technical debt.

The pages above describe the tools. For a walkthrough of using them on a real codebase, see the guide for using agents.

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)

Follow instructions below to configure the MCP server manually:

Supported IDEs

Tool Connection Type Configuration Method Status
Cursor Direct HTTP MCP & Integrations panel ✅ Supported
VSCode w/ Github Copilot plugin HTTP via GitHub Copilot Agent mode → Tools menu ✅ Supported
VSCode native Proxy (mcp-remote) MCP settings ✅ Supported
Devin Desktop Direct HTTP MCP settings ✅ Supported
Claude Code Direct HTTP 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": {
    "Sigrid": {
      "url": "https://sigrid-says.com/mcp",
      "headers": {
        "Authorization": "Bearer <your_sigrid_token>"
      }
    }
  }
}

VSCode

Add:

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

Visual Studio

Devin Desktop

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

Note that the url key must be serverUrl.

Claude Code (manual)

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

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

OpenCode

{
  "mcp": {
    "Sigrid": {
      "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": {
  "Sigrid": {
    "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":
    {
        "Sigrid": {
            "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
guardrails:quality_check Guardrails MCP Checks code for maintainability issues and security vulnerabilities
maintainability:get_findings Auto-fix Agents MCP Retrieves ranked refactoring candidates for a given maintainability property
maintainability:get_ratings Auto-fix Agents MCP Returns current maintainability ratings for a system
security:get_findings Auto-fix Agents MCP Returns open security findings ranked by severity
reliability:get_findings Auto-fix Agents MCP Returns open reliability findings ranked by severity
opensourcehealth:get_risks Auto-fix Agents MCP Returns open source dependency risks across vulnerability, freshness, legal, activity, stability, and management
opensourcehealth:get_vulnerabilities Auto-fix Agents MCP Returns known CVEs in open source dependencies ranked by CVSS score
update_finding_status Auto-fix Agents MCP Updates the status and remarks of a Sigrid finding
architecture:get_internal Auto-fix Agents MCP Shows how the parts inside a directory relate to each other, to understand structure before changing it
architecture:get_external_dependencies Auto-fix Agents MCP Lists a file or directory’s incoming and outgoing dependencies, to find the blast radius of a change
architecture:get_worst_directories Auto-fix Agents MCP Returns the lowest-scoring architecture directories, ranked by impact

Tool selection

Only tools for your enabled Sigrid models are available. For example, if your organization has Maintainability and Security enabled, you will only see tools related to those capabilities.

To further restrict which tools are visible in a session, pass the X-Enabled-Tools header with a comma-separated list of tool names:

{
  "mcpServers": {
    "Sigrid": {
      "url": "https://sigrid-says.com/mcp",
      "headers": {
        "Authorization": "Bearer <your_sigrid_token>",
        "X-Enabled-Tools": "guardrails:quality_check, security:get_findings"
      }
    }
  }
}

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