Integrações

Windsurf (Devin Desktop)

Configure o zn-gate no Windsurf (Devin Desktop, Cascade) em dois minutos: adicione-o como servidor MCP e veja o que o zn-gate ainda não cobre ali.

Ver .md

Início rápido (sem precisar programar)

  1. Verifique se o Node.js está instalado. Abra um terminal (na maioria dos editores: menu Terminal → New Terminal; ou o aplicativo Terminal do seu computador), digite node --version e pressione Enter. Se aparecer um número de versão (18 ou superior), continue. Se aparecer "command not found", instale a versão LTS em nodejs.org e reinicie o Windsurf.

  2. Abra o arquivo de configuração do MCP: no macOS e no Linux, ~/.config/devin/mcp_config.json; no Windows, %APPDATA%\devin\mcp_config.json. Se ele não existir, crie-o. (~ é a sua pasta de usuário. Versões mais antigas do Windsurf usavam ~/.codeium/windsurf/mcp_config.json, não verificado.)

  3. Cole o seguinte:

    {
  "mcpServers": {
    "zn-gate": {
      "command": "npx",
      "args": [
        "-y",
        "zn-gate",
        "mcp"
      ]
    }
  }
}

    Se o arquivo já tiver uma seção "mcpServers", adicione apenas a parte "zn-gate": {...} dentro dela.

  4. Salve o arquivo e atualize os servidores MCP no painel do Cascade (ou reinicie o aplicativo).

Status: estes passos seguem a documentação do Windsurf; ainda não foram verificados por nós no Windsurf.

O que o zn-gate protege no Windsurf e o que não protege

No Windsurf, o zn-gate funciona como um servidor MCP: o agente pode pedir a ele que verifique um prompt, uma chamada de ferramenta ou um resultado de ferramenta (analyze_prompt, check_tool_call, check_tool_result). O agente decide quando chamar essas ferramentas, então, por si só, isso não é uma proteção automática.

No Windsurf
Verificações do zn-gate disponíveis para o agente (MCP) Sim
Seus outros servidores MCP verificados quanto a prompt injection e segredos Sim, se você os encapsular (abaixo)
Bloqueia leituras de .env e de arquivos de credenciais Não
Remove segredos da saída do shell e do conteúdo de arquivos Não
Bloqueia um segredo colado no chat Não

O Cascade tem hooks: pre_mcp_tool_use, pre_run_command e pre_read_code podem bloquear uma ação (código de saída 2), mas a documentação deles não descreve uma forma de os hooks alterarem a saída de uma ferramenta, e o zn-gate ainda não instala hooks para o Cascade. Assim, no Windsurf o zn-gate não bloqueia leituras do seu .env ou de arquivos de credenciais e não remove segredos da saída do shell nem do conteúdo de arquivos. Se você precisar disso hoje, use o zn-gate com Claude Code, Codex CLI, Cursor ou OpenCode: veja compat.md.

Referência técnica

Onde fica a configuração

macOS e Linux: ~/.config/devin/mcp_config.json. Windows: %APPDATA%\devin\mcp_config.json.

Verifique a saída dos seus outros servidores MCP

Para verificar a saída dos outros servidores MCP que você usa no Windsurf, inicie cada servidor local por meio do zn-gate: substitua o comando dele por npx e coloque -y zn-gate shield -- antes do comando e dos argumentos originais. Por exemplo, um servidor iniciado com uvx mcp-server-fetch fica assim:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": [
        "-y",
        "zn-gate",
        "shield",
        "--",
        "uvx",
        "mcp-server-fetch"
      ]
    }
  }
}

Cada resultado desse servidor é então verificado quanto a prompt injection, e os segredos que o zn-gate reconhece são removidos, antes de o agente vê-lo. O zn-gate init, que faz isso automaticamente para Claude Desktop, Claude Code, Cursor, Codex e OpenCode, não edita as configurações do Windsurf.

Documentação do Windsurf