beginner⏱️ 10-20 minutes📅 Updated July 2026

Step-by-step guide to integrate MCP SO MCP server with Roo Code. Enhanced Roo Code functionality with MCP SO integration.

MCP SO + Roo Code: Complete MCP Integration

MCP SO is a MCP server that Connect the world with MCP. Find awesome MCP servers. Build AI agents quickly..

When integrated with Roo Code, you can:

  • Access MCP SO functionality through Roo Code

This guide provides step-by-step instructions to set up MCP SO in Roo Code, including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

  • MCP SO will be fully integrated and operational
  • You can use MCP SO tools directly in Roo Code
  • All MCP SO capabilities will be available for your workflows

Prerequisites

Before starting, ensure you have:

  • Roo Code installed and configured
  • Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install MCP SO

Configuration

Step 2: Configure Roo Code

  1. Locate your configuration file:

    • Windows: %USERPROFILE%\.roo\mcp_settings.json
    • macOS: ~/.roo/mcp_settings.json
    • Linux: ~/.roo/mcp_settings.json
  2. Add server configuration:

{
  "mcpServers": {
    "mcp-so": {
      "command": "npx",
      "args": ["-y", "mcp-so"],
      "env": {
        
      }
    }
  }
}

  1. Restart Roo Code

Completely quit and restart Roo Code to load the new configuration.

Examples

Once configured, you can use MCP SO in Roo Code:

Testing Your Setup

  1. Start a new conversation in Roo Code
  2. Ask Roo Code to list available tools
  3. Try using MCP SO functionality

Test prompts:

  • "Type @ and verify MCP SO appears in the tools list"
  • "Ask: "Use MCP SO to help with my task""
  • "Check Roo Code output panel for server connection status"

Troubleshooting

Common Issues

MCP Server Not Connecting

Symptoms: Server not appearing in tools list, Connection timeout, MCP tools unavailable

Cause: Incorrect configuration or server not starting

Solution:

  • Verify mcp_settings.json syntax is correct
  • Check that Node.js and npx are installed and in PATH
  • View Roo Code output panel for error messages
  • Test server command manually in terminal: npx -y {server_id}
  • Ensure environment variables are properly set

Permission Denied Errors

Symptoms: Cannot execute commands, File access denied, Terminal commands blocked

Cause: Roo Code requires explicit permission for file and command operations

Solution:

  • Review and approve permission requests when prompted
  • Check VS Code workspace trust settings
  • Enable necessary permissions in Roo Code settings
  • Verify file and folder permissions on your system

API Key or Model Issues

Symptoms: Authentication failed, Model not responding, No AI completions

Cause: AI model API key not configured or invalid

Solution:

  • Verify API key is correctly set in Roo Code settings
  • Check API key has sufficient credits/quota
  • Test with a different AI model provider
  • Review Roo Code output panel for API error details

Custom Mode Not Working with MCP

Symptoms: MCP tools not available in custom mode, Mode cannot access server

Cause: Custom mode configuration does not include MCP tool permissions

Solution:

  • Edit custom mode configuration to include MCP tools
  • Add "Use MCP" to available tools in mode definition
  • Ensure mode has appropriate permissions for external tools
  • Test with default mode first to verify MCP server works

Extension Conflicts

Symptoms: Roo Code not responding, VS Code performance issues, Unexpected behavior

Cause: Conflicts with other AI coding extensions

Solution:

  • Disable other AI coding extensions (Cline, Continue, etc.)
  • Restart VS Code after disabling conflicting extensions
  • Check VS Code extension logs for conflict errors
  • Use only one AI coding assistant extension at a time

MCP SO not appearing in Roo Code

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

  • Verify configuration syntax
  • Check MCP SO installation
  • Restart Roo Code
  • Check logs for error messages

Next Steps

Now that MCP SO is integrated with Roo Code:

  • Explore all MCP SO capabilities through Roo Code
  • Check out other MCP servers that work with Roo Code
  • Join the MCP community for tips and support
  • Consider contributing to MCP SO development

Need Help?

Related Resources

More Integrations

Explore other MCP servers that work with Roo Code

Need Help?

Join the MCP community for support and discussions

MCP SO + Roo Code: MCP Setup Guide (2026)