Ir para o conteúdo
Promovaweb

Hooks, MCP e plugins do GitHub Copilot CLI

StayCloudVPS Agêntica

30% off na sua VPS Agêntica nos 2 primeiros meses

A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

Aproveitar a Black Friday

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

Os hooks do GitHub Copilot CLI executam comandos seus em pontos fixos da sessão, como o início, cada prompt, cada ferramenta e o fim do trabalho do agente. Os servidores MCP acrescentam ferramentas e fontes externas, enquanto os plugins juntam skills, agentes, hooks e servidores num pacote instalável.

Sumário da página

  1. Um comando disparado por um evento da sessão
  2. Onde os hooks moram
  3. Hooks que decidem permissões
  4. Servidores MCP trazem ferramentas de fora
  5. Plugins empacotam as peças
  6. Servidores de linguagem para entender o código
  7. Cada peça no lugar certo

Um comando disparado por um evento da sessão

Você quer que os testes rodem toda vez que o Copilot altera um arquivo de código. Escrever isso no arquivo de instruções orienta o agente, mas ele pode esquecer numa sessão longa. Um hook resolve de outro jeito: você declara um comando ligado a um evento. O próprio CLI executa esse comando quando o evento acontece. A documentação do GitHub cita esse exemplo de testes automáticos e também validação, registro de atividade, varredura de segurança e automação de fluxo.

Os eventos acompanham a vida da sessão. Há eventos para o início e o fim da sessão (sessionStart e sessionEnd), para cada prompt enviado, para antes e depois de cada ferramenta (preToolUse e postToolUse), para o fim do trabalho do agente (agentStop), para subagentes, para erros e para o momento anterior à compactação do histórico. A referência aceita os nomes no formato do CLI, como postToolUse, junto com apelidos como PostToolUse.

Onde os hooks moram

Os hooks do repositório ficam em arquivos JSON na pasta .github/hooks/, com um nome que descreve o propósito. Esses arquivos vão para o Git com o projeto. Os hooks do usuário ficam em ~/.copilot/hooks/ e valem em todas as suas sessões. A referência lista ainda o bloco hooks nos arquivos de settings do repositório e do usuário, os arquivos .claude/settings.json do repositório e os hooks de política, instalados pelo administrador na máquina, que carregam antes de todos os outros e não podem ser desligados.

Cada hook de comando define um campo bash, para Unix, um campo powershell, para Windows, ou o campo command, que serve aos dois. O timeoutSec define o tempo máximo, com 30 segundos como padrão. O exemplo oficial para macOS emite um som e abre uma janela quando o agente para e quando a sessão termina, com os eventos agentStop e sessionEnd.

  1. Ferramenta solicitada

    O agente quer rodar um comando ou editar um arquivo.

  2. Hook preToolUse

    O CLI executa o seu comando com os detalhes da chamada.

  3. Resposta do hook

    O JSON devolvido pode trazer allow, deny ou ask, com o motivo.

  4. Execução ou recusa

    A chamada roda, é negada ou segue para a aprovação manual da sessão.

Um hook preToolUse recebe a chamada da ferramenta e responde se ela roda. A resposta libera, recusa ou devolve a chamada ao fluxo normal de permissões.

Hooks que decidem permissões

O preToolUse vai além de registrar. Ele pode responder com um objeto JSON que libera, nega ou solicita confirmação para a ferramenta. O motivo da negativa chega ao agente como informação. A referência registra um detalhe de comportamento que pesa na escolha: um hook de comando que falha ou sai com código diferente de zero nega a chamada, mas um hook que estoura o tempo deixa a chamada seguir para o fluxo normal de permissões. No Autopilot, uma resposta ask vira negativa, porque não há ninguém para responder.

Quando a sandbox local está ligada, um hook pode falhar só por precisar ler um arquivo de configuração ou um cache fora dela. A documentação sugere o comando /sandbox policy para conferir o acesso antes de liberar qualquer coisa e avisa que arquivos como .npmrc podem guardar credenciais.

Servidores MCP trazem ferramentas de fora

O Model Context Protocol permite acrescentar ferramentas e fontes externas ao Copilot CLI. A documentação cita consultas a bancos, sistemas de issues, pipelines de CI e CD, diagramas, documentação especializada e calendários. O agente já vem com o servidor MCP do GitHub configurado, o que explica por que ele lista issues e pull requests sem nenhuma configuração extra. O comando /mcp mostra os servidores configurados e o nome de cada um, o mesmo nome usado nas opções de permissão.

O GitHub também oferece servidores MCP verificados, chamados de conectores. Você conecta um serviço uma vez e usa essa conexão nas superfícies compatíveis do Copilot, sem repetir a configuração nem o login em cada uma. O GitHub cuida da configuração e da autenticação desses servidores. Quando você sabe que um servidor específico resolve a tarefa, cite o nome dele no prompt. Com isso, o Copilot chega mais rápido à ferramenta certa.

Plugins empacotam as peças

Um plugin é um pacote que junta vários componentes de personalização numa unidade instalável. Você instala plugins de um marketplace registrado, de um repositório do GitHub, de uma URL Git, de uma subpasta de repositório ou de um caminho local. O CLI já vem com o marketplace awesome-copilot registrado. O comando copilot plugin marketplace list mostra os marketplaces. O copilot plugin install NOME@MARKETPLACE instala um plugin, com o equivalente /plugin dentro da conversa.

As skills que chegam por plugin saem pela gestão do plugin, não pelo comando de remoção de skills. O changelog da versão 1.0.112 mostra que a organização também pode exigir plugins, que o CLI prepara uma vez ao iniciar.

Servidores de linguagem para entender o código

O Copilot CLI aceita servidores do Language Server Protocol, que dão ao agente recursos como ir para a definição, informações ao passar o cursor e diagnósticos. O CLI não traz esses servidores: você instala cada um separadamente, como o typescript-language-server para TypeScript. A configuração fica em ~/.copilot/lsp-config.json, para todos os projetos, ou em .github/lsp.json, no repositório. O comando /lsp mostra o estado dos servidores configurados.

Cada peça no lugar certo

As quatro peças resolvem problemas diferentes. O hook garante que um comando rode num momento fixo, independentemente do que o modelo decidir. O servidor MCP amplia o que o agente consegue consultar e fazer fora do repositório. O plugin distribui um conjunto pronto para outros desenvolvedores instalarem. O servidor de linguagem dá ao agente definições e diagnósticos do código. Juntas, elas transformam o CLI no ambiente do seu projeto, sem mudar o agente que conversa com você.