Monte seu hackbot, parte 3: MCP e a CLI

A parte dois montou um agente com duas ferramentas suas. Este post o conecta a ferramentas compartilhadas pelo Model Context Protocol, adiciona uma checagem de escopo automática, e roda o resultado pelo terminal ou pelo seu editor. Se MCP é novidade para você, leia antes o que é MCP, e o que são agentes de IA e uso de ferramentas para a ideia mais ampla.

#Das suas ferramentas para ferramentas compartilhadas

As duas ferramentas que você escreveu funcionam, e deixam de ser suficientes no momento em que você quer lookups de CVE, uma base de conhecimento ou leituras da web sem codar cada uma. MCP é um jeito padrão de um agente usar ferramentas que outra pessoa escreveu e roda, então seu loop pode chamá-las sem código novo. O Model Context Protocol define o formato, e muitos clientes e servidores já o falam.

#O que a NotHoly expõe por MCP

A CLI da NotHoly traz um servidor MCP local. Ele roda sobre entrada e saída padrão e usa o seu login da CLI, então nenhuma chave vai para qualquer arquivo de config.

Suba o servidor e registre-o em um cliente. Para o agente próprio da CLI da NotHoly, as ferramentas de pesquisa já estão presentes, então isso importa mais quando você liga as ferramentas da NotHoly a outro agente.

claude mcp add notholy -- notholy mcp

Qualquer cliente MCP lê a mesma forma de JSON.

{"mcpServers": {"notholy": {"command": "notholy", "args": ["mcp"]}}}

As ferramentas funcionam com qualquer modelo, então um agente rodando um modelo do catálogo, ou qualquer outro, ainda alcança os dados de CVE e de base de conhecimento da NotHoly. O modelo decide quando chamá-las, e os resultados voltam como dado para o loop ler.

#Uma checagem de escopo com notholy engage

Seu agente em Python confia em você para ler cada comando pelo escopo. A CLI pode checar por você. O notholy engage registra o que o programa deixa você tocar e lê o alvo de cada comando antes dele rodar.

notholy engage init --name acme-web --scope "*.example.com,api.example.com" --exclude vpn.example.com
notholy connect claude

Com um engagement ativo, um comando no escopo passa pela aprovação normal, e um alvo fora do escopo faz você digitar o host e loga o override. O notholy connect claude instala a mesma checagem como um hook nos comandos de shell, onde um comando fora do escopo é negado de imediato. A checagem lê o texto do comando e não resolve nomes, então pega erros e não é um sandbox. É a versão automática do hábito de aprovação da parte dois.

#Rode pela CLI e pelo editor

Agora você tem três jeitos de rodar um agente, e eles compartilham uma conta. Seu próprio loop em Python é o que você entende por inteiro e pode mudar. A CLI da NotHoly roda um agente pronto no terminal com esses guardrails embutidos. E o notholy connect ou notholy run aponta um agente de editor para modelos e ferramentas da NotHoly, então o mesmo loop roda onde você lê código.

notholy run claude

O notholy run ajusta o ambiente para um processo sem tocar na sua config global. O notholy connect escreve a config e pode desfazer. De qualquer jeito, o modelo roda na NotHoly, os comandos rodam na sua máquina, e as ferramentas de pesquisa vêm por MCP.

#Quando usar qual

Use o seu próprio agente para aprender e para controlar exatamente o que roda. Use o agente da CLI quando quiser os guardrails sem mantê-los. Use a integração com o editor quando o trabalho é ler e mudar código. Os três mantêm a mesma divisão da parte um: o modelo planeja, a sua máquina age, e cada comando é seu para aprovar.

#A seguir nesta trilha

O agente acha e confirma; você ainda tem que ser pago por isso. Escrever relatórios de bug bounty com IA transforma as suas notas em um relatório que um triager aceita.