mcp-router MCP — Casos de uso, Instalar & Demo ao vivo

Name: mcp-router MCP Server
Author: mcp-router

Por que usar

Principais recursos

Toggle individual tools on/off per workspace/project
Centralized request logging and analytics
Works with Claude Desktop, Cursor, Cline, Windsurf
100% local — credentials never leave the device

Demo ao vivo

Como fica na prática

router.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "router": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "router",
      "command": "npx",
      "args": [
        "-y",
        "mcp-router"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "router": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-router"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add router -- npx -y mcp-router

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: mcp-router

How to manage 10+ MCP servers without config chaos

👤 Power users with MCPs piling up ⏱ ~20 min beginner

Quando usar: Your claude_desktop_config.json is a mile long and you don't know which servers are actually being used.

Pré-requisitos

MCP Router installed — Download from github.com/mcp-router/mcp-router/releases

Fluxo

Import existing config

Open MCP Router → Import → point at Claude Desktop's config✓ Copiado

→ All servers listed with status
Create workspaces per project

Create a workspace 'Client-Acme' and only enable GitHub + Sentry + Linear✓ Copiado

→ Minimal toolset for that project
Switch workspaces when switching projects

In MCP Router, switch active workspace. Restart Claude.✓ Copiado

→ Claude sees only the enabled MCPs

Resultado: Clean tool surfaces per project — less context pollution for the model.

Armadilhas

Claude caches tool list at session start — Always restart the client after switching workspace

Audit which MCP tools your agents actually use

👤 Anyone optimizing their setup ⏱ ~15 min beginner

Quando usar: You wonder if half your MCPs are ever actually called — cut the dead weight.

Fluxo

Let it log for a week

Enable request logging in MCP Router → use Claude normally for 7 days✓ Copiado

→ Log accumulates real usage
Review analytics

Open MCP Router → Analytics. Which servers were called <5 times? Sort by call count.✓ Copiado

→ Clear top / tail split
Disable or uninstall the tail

For servers in the bottom 25%, disable them or remove entirely✓ Copiado

→ Leaner setup

Resultado: Data-driven MCP pruning — faster startup, less tool-choice confusion.

Gate dangerous MCP tools behind explicit enable

👤 Security-conscious users ⏱ ~10 min intermediate

Quando usar: You have a GitHub MCP with write scopes but only want it on when you're actively fixing code.

Fluxo

Disable write tools by default

In MCP Router, disable create_issue, create_pull_request, delete_repo for the GitHub server. Keep reads on.✓ Copiado

→ Only read tools advertised to Claude
Enable briefly when needed

About to file a PR — enable create_pull_request, run the flow, disable again✓ Copiado

→ Short enabled windows; audit log captures the calls

Resultado: Default-deny for destructive operations.

Combine com: mcptools

Combinações

Combine com outros MCPs para 10× de alavancagem

router + mcptools

MCP Router for day-to-day, mcptools (guard) for scripted CI gating

Use MCP Router to disable github writes on my dev machine; in CI use mcp guard policy file.✓ Copiado

router + copilot

Discover new MCPs with copilot-mcp, manage them centrally with MCP Router

Install 3 new MCPs via copilot-mcp, then organize them into the 'Research' workspace in MCP Router.✓ Copiado

Custo e limites

O que custa rodar

Cota de API: N/A — desktop app
Tokens por chamada: N/A
Monetário: Free, open source
Dica: Use workspaces aggressively — each workspace keeps only the tools you need, reducing per-session token overhead

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Credentials stored locally in MCP Router's settings; never transmitted

Saída de dados: None from the router itself; downstream MCPs go wherever they normally do

Solução de problemas

Erros comuns e correções

Claude still sees disabled tools

Claude caches at session start — fully quit and relaunch (not just reload)

Verificar: Ask Claude to list its available tools

Import fails on large configs

Malformed JSON is the usual culprit. Validate config with jq . claude_desktop_config.json first

Server won't start from router

The router uses the same command as Claude — run it in a terminal manually to see the real error

Alternativas

mcp-router vs. outros

Alternativa	Quando usar	Troca
copilot-mcp (VSCode)	You live in VSCode and prefer extensions	VSCode-bound
Manual config editing	You have 1-3 MCPs total	No logging, no workspace switching

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills