Claude Auto-Approve MCP

Adiciona funcionalidade de aprovação automática para requisições MCP ao aplicativo Claude Desktop.

Documentação

Claude Auto-Approve MCP

Aviso A atualização de 1º de maio introduziu um botão "Always approve" - não use isso pois não pode ser desfeito! claude-autoapprove-mcp restaura a funcionalidade mais segura "Allow for this chat":

  • Configure aprovações permanentes na configuração
  • Tome decisões por conversa para outras ferramentas
  • Altere decisões em conversas mais recentes Isso fornece controle granular enquanto mantém a segurança.

Se você acidentalmente usou o botão "Always approve", como uma solução alternativa você pode renomear o mcp no arquivo claude_desktop_config.json para outra coisa. Exemplo: git->git_new. Se a Anthropic corrigir esse bug no futuro, talvez não precisemos mais de claude-autoapprove-mcp.

Um MCP para reiniciar o Claude Desktop App com a porta de depuração habilitada e injetar um JavaScript nele, que estende o Claude com a funcionalidade de aprovação automática de MCP. Ele usa a biblioteca claude-autoapprove por baixo dos panos.

Como funciona

O servidor MCP reiniciará o Claude Desktop App com a porta de depuração habilitada e injetará um JavaScript nele, que estende o Claude com a funcionalidade de aprovação automática de MCP.

Não tenha medo se após a primeira inicialização do aplicativo ele for fechado imediatamente. Isso é um comportamento esperado.

Instalação

Instalando uv (se você ainda não tem)

Após instalar o uv, certifique-se de que ele esteja disponível no seu PATH.

MacOS

Brew
brew install uv
MacPorts
sudo port install uv

Windows

winget install --id=astral-sh.uv  -e

Outras opções de instalação

Você pode encontrar outras opções de instalação no guia de instalação do uv.

Adicione ao seu claude_desktop_config.json

{
    "mcpServers": {
        "claude-autoapprove-mcp": {
            "command": "uvx",
            "args": [
                "claude-autoapprove-mcp"
            ],
            "autoapprove": [
                "autoapproved_tools",
                "autoblocked_tools"
            ]
        }
    }
}

Reinicie o Claude Desktop se ele já estiver em execução.

Argumentos

ParâmetroDescrição
portOpcional. O número da porta para escutar, o padrão é 19222
persistOpcional. Funciona apenas no macOS (no momento). Se especificado, instala um pequeno script de monitoramento que reiniciará o Claude Desktop com a porta de depuração habilitada, se ele não estiver rodando com a porta de depuração. Isso permite detecção precoce e reinício automático, então você não precisa esperar por um reinício (apenas na primeira vez). Também instala um LaunchAgent, para que seja iniciado no login. Se você remover o argumento --persist, o script de monitoramento será removido e o LaunchAgent será desinstalado.
{
    "mcpServers": {
        "claude-autoapprove-mcp": {
            "command": "uvx",
            "args": [
                "claude-autoapprove-mcp",
                "--port", "19222",
                "--persist"
            ]
        }
    }
}

Configuração

Você pode adicionar os parâmetros autoapprove e autoblock a cada servidor MCP, o claude-autoapprove-mcp lerá essa configuração e a aplicará à instância em execução.

ParâmetroDescrição
autoapproveLista de nomes de ferramentas que devem ser aprovados automaticamente
autoblockLista de nomes de ferramentas que devem ser bloqueados automaticamente
{
    "mcpServers": {
        "claude-autoapprove-mcp": {
        "command": "uvx",
            "args": [
                "claude-autoapprove-mcp"
            ],
        "autoapprove": [
            "autoapproved_tools"
        ],
        "autoblock": [
        ]
    },
    "project-mem-mcp": {
        "command": "uvx",
        "args": [
            "project-mem-mcp",
            "--allowed-dir", "/Users/wallner/Developer/MCP",
            "--allowed-dir", "/Users/wallner/Developer/Projects/ByCompany/BacktestGuy"
        ],
        "autoapprove": [
            "get_project_memory",
            "set_project_memory",
            "update_project_memory"
        ],
        "autoblock": [
        ]
    },
    "browsermcp": {
      "command": "npx",
      "args": [
        "@browsermcp/mcp@latest"
      ],
      "autoapprove": [
        "browser_get_console_logs",
        "browser_snapshot"
      ],
      "autoblock": [
        "browser_screenshot"
      ]
    }
}

Uso

Basta executar o Claude Desktop. Ele não é invasivo, não altera nada no aplicativo (apenas se você usar o argumento --persist), apenas injeta um JavaScript na instância em execução. Então você pode instalar atualizações normalmente (mesmo ao usar o argumento --persist). Ele usa um recurso da maioria dos aplicativos baseados em Electron: porta de depuração remota.

Se você quiser listar todas as ferramentas que são aprovadas automaticamente, pode usar o seguinte prompt no Claude Desktop:

list all tools that are auto-approved

Se você quiser listar todas as ferramentas que são bloqueadas automaticamente, pode usar o seguinte prompt no Claude Desktop:

list all tools that are auto-blocked

Segurança

A porta de depuração remota permite que qualquer aplicativo no seu localhost (sua máquina) se conecte ao Claude Desktop App em execução. Isso pode ser um risco de segurança, porque qualquer aplicativo ou script pode se conectar a ele e executar código arbitrário no contexto do Claude Desktop App. Isso pode ser usado para fins maliciosos. É um risco baixo, se você souber o que está rodando no seu computador.

Portanto, tenha cuidado ao usar este recurso e use por sua conta e risco.

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para detalhes.

Contribuindo

Se você quiser contribuir para este projeto, faça um fork do repositório e crie um pull request.