Desenvolvedor do Domclick ensinou o OpenCode a se configurar sozinho: MCP, skills e permissões em poucas noites

Vladimir Bandov, desenvolvedor backend do Domclick, publicou no Habr um relato sobre a configuração de um agente de código no OpenCode Desktop. A primeira meia hora de configuração passou sem problemas, mas depois veio o caos de habilidades (skills), servidores MCP, permissões e vários arquivos de configuração. Encontrar uma abordagem que funcionasse levou algumas noites livres. O autor chama o resultado de "preguiçoso": talvez gaste mais tokens, mas o agente ajuda a configurar a si mesmo e não sai fazendo coisas por conta própria.

Onde a configuração quebra

Segundo Bandov, a barreira de entrada é mais alta do que sugerem os vídeos de tutorial. Instalar o agente leva poucos minutos. Fazer com que ele trabalhe de forma previsível é mais difícil. O autor aponta três problemas.

Primeiro: entidades demais. Skills, MCP, permissions e diferentes níveis de configuração precisam estar na cabeça ao mesmo tempo. Em certo momento, ele deixou de lembrar para que servia cada skill.

Segundo: a ordem das ações. Era preciso explicar ao agente, várias vezes, que primeiro vem o plano, depois os acessos e as configurações, e só então a execução de comandos no terminal.

Terceiro: a hiperiniciativa. O agente dava passos desnecessários, inventava e implementava coisas que não faziam parte da tarefa. Em um repositório de trabalho, esse é o principal risco: o código excedente precisa ser lido e revertido.

Abordagem preguiçosa: o agente configura a si mesmo

A ideia que dá título ao artigo é esta: gerenciar a configuração "pelas mãos do próprio agente". Em vez de editar arquivos manualmente e decorar a sintaxe, o desenvolvedor define a tarefa, e o agente propõe um plano e faz as alterações: conecta o MCP, adiciona skills e escreve as permissões. O autor detalha os passos completos e os prompts no original; o anúncio não traz esse material.

Para quem não acompanhou, um pouco de contexto. MCP (Model Context Protocol) é um protocolo aberto que a Anthropic apresentou em novembro de 2024 para conectar ferramentas externas e fontes de dados aos modelos. OpenCode é um agente de código open source que roda no terminal e em um cliente desktop. As permissões de ação nele são definidas por configuração, no esquema "permitir, perguntar, negar". Quando os servidores MCP se multiplicam e cada um traz dezenas de ferramentas, a administração manual rapidamente vira trabalho braçal.

O limite de uso também importa. Bandov não delega ao agente o papel de desenvolvedor pleno. Para ele, o agente é um assistente: prepara o plano, executa passos claros e pergunta onde é preciso manter o controle. Esse modo de trabalho também explica a disposição de pagar com tokens pelas iterações extras de planejamento.

O que se sabe pelo anúncio

• Ferramenta: OpenCode Desktop.
• Autor: Vladimir Bandov, desenvolvedor backend do Domclick.
• Tempo: cerca de 30 minutos até o ponto em que a configuração manual ficou cansativa; mais algumas noites para chegar a um esquema funcional.
• Componentes: habilidades (skills), MCP, permissions, várias configurações.
• Principal problema: o agente faz trabalho que não lhe foi pedido.
• Custo da solução: possivelmente, mais tokens gastos.
• O anúncio não traz medições de economia de tempo nem de custo.

Como aplicar isso no seu dia a dia

Do material, dá para tirar algumas regras práticas que não dependem de um cliente específico.

Comece pelo plano. Se o agente deve primeiro descrever os passos e só depois ganhar acesso aos comandos, registre isso nas regras do projeto para não repetir em cada conversa.

É melhor definir as permissões de forma restritiva por padrão. A leitura de arquivos pode ser liberada; escrita e comandos de shell devem exigir confirmação. Relaxe as restrições de forma pontual, para uma tarefa específica.

Conecte os MCPs um a um e veja quais ferramentas cada um adiciona ao contexto. Cada servidor consome tokens com descrições e amplia a superfície para erros.

Mantenha no git os arquivos de configuração que o agente edita e revise-os pelo diff. Se ele altera as próprias permissões, você precisa ver isso antes do commit.

Por fim, meça. Se o esquema "preguiçoso" realmente custa mais tokens, avalie isso em tarefas reais ao longo de uma semana e compare com o tempo que você deixou de gastar na configuração manual.