Conector do GitHub
Nesta página
Atualizado em 2 de novembro de 2026. O Le Chat é agora o Vibe (ainda em chat.mistral.ai): um único agente para trabalho e código, que mantém as suas conversas, definições e subscrições. A experiência legada do Le Chat permanece acessível no modo Chat; no modo Work, os agentes são agora competências (invocadas com
@), as memórias constituem a base de conhecimento e a pesquisa profunda é a competência Deep Research. Os planos denominam-se agora Mistral Free, Pro, Team e Enterprise. Esta lição utiliza o nome Vibe; alguns menus aqui descritos podem ter alterado de nome ou localização.
GitHub Diretamente no Vibe
O GitHub é uma das integrações MCP mais poderosas no diretório do Vibe. Oferece-lhe acesso aos seus repositórios, issues, pull requests e ramos sem sair da conversa. Para uma equipa de desenvolvimento, o ganho de eficiência é significativo: tarefas rotineiras — triagem de issues, abertura de um PR, verificação de um ficheiro num ramo — deixam de exigir alternância constante com a interface web ou a recordação do comando Git correto.
Ligação e Autenticação
O conector autentica-se através de um Personal Access Token (PAT). A configuração decorre em quatro passos:
- Aceda ao GitHub em Settings > Developer settings > Personal access tokens
- Crie um novo token selecionando os scopes necessários (repositórios, issues, pull requests, etc.)
- No Vibe, abra o separador Connectors e selecione GitHub
- Cole o seu token e confirme
O token é armazenado de forma segura e vinculado exclusivamente à sua conta de utilizador. Se pertencer a uma organização no Vibe, os seus colegas não podem ver nem utilizar o seu token: cada pessoa liga-se com as suas próprias credenciais, e o scope visível para o Vibe corresponde exatamente ao que a pessoa ligada pode aceder.
A seleção do scope merece alguns segundos de reflexão. Eis os principais:
- repo: acesso total aos repositórios (leitura, escrita, criação de ramos e PRs)
- read:org: leitura de informações da organização
- write:discussion: participação em discussões
- admin:repo_hook: gestão de webhooks (raramente necessário)
Aplique o princípio do privilégio mínimo: comece com direitos limitados e regenere posteriormente um token mais abrangente se um caso de uso específico o justificar. Conceder um PAT repo completo apenas para consultar issues constitui um risco desnecessário.
Capacidades do Conector
Uma vez ligado, o Vibe cobre quatro domínios. Primeiro, a consulta: lista os seus repositórios e respetivos ramos, exibe o conteúdo de um ficheiro específico, navega no histórico de commits e verifica o estado da CI/CD. Relativamente às issues, lista as abertas, cria novas com título, descrição e etiquetas, adiciona comentários às existentes e altera o seu estado.
O trabalho em pull requests segue a mesma lógica: listar PRs abertos, criar um a partir de um ramo, consultar diffs e comentários de revisão e, finalmente, fazer o merge. Por fim, no próprio código, o Vibe cria um ramo a partir de outro, cria ou modifica um ficheiro num ramo específico e efetua o push das alterações. Esta última categoria exige maior cautela, uma vez que escreve no repositório.
Três Exemplos Práticos
Imagine uma manhã comum. Pretende verificar as tarefas pendentes:
“Show me open issues on the company/backend repo that have the ‘bug’ label and are unassigned.”
O Vibe invoca o conector, aplica os filtros e apresenta uma lista resumida. Dá seguimento na mesma conversa para atribuir, etiquetar ou comentar, sem nunca abrir o GitHub.
Segunda situação: deteta uma lacuna na documentação e dita o trabalho:
“Create a file docs/guide-migration.md on the docs/migration branch of the company/documentation repo with a guide explaining how to migrate from v2 to v3.”
O ficheiro é criado no ramo indicado e solicita de imediato o pull request associado. Terceira situação: prepara-se para uma revisão de código e deseja uma visão geral antes de se debruçar sobre os detalhes:
“What are the open pull requests on company/frontend? Give me a summary of changes for each.”
O Vibe lista os PRs, lê os diffs e produz um resumo estruturado que indica onde deve focar a sua atenção.
Dois Hábitos a Adotar
O primeiro diz respeito à ativação. O conector do GitHub expõe muitas ferramentas; numa conversa que não verse sobre código, desative-o. Verificará que o modelo seleciona a ferramenta correta com maior fiabilidade quando a lista é curta — isto aplica-se a qualquer sistema de agentes.
O segundo concerne às escritas. Sempre que o Vibe propuser criar um ficheiro, um ramo ou um pull request, a interface exibe os argumentos JSON antes da execução. Leia-os. Verifique em particular o nome do ramo de destino, pois confundir main com um ramo de trabalho leva a erros dispendiosos; de seguida, verifique o conteúdo do ficheiro criado ou modificado, seguido do título e da descrição do PR.
O Conector num Fluxo de Trabalho
O GitHub revela todo o seu potencial quando combinado com outros conectores MCP. Uma sequência típica envolve analisar uma ferramenta de suporte para detetar um erro reportado por um utilizador, verificar no GitHub se já existe um ticket, criar a issue caso contrário, criar depois um ramo, fazer o push de uma correção e abrir o pull request. Gere todo o fluxo a partir do Vibe, estando cada ação de escrita sujeita à sua validação.
Pontos-chave
- O conector do GitHub utiliza um Personal Access Token com scopes configuráveis
- Pode consultar, criar e modificar repositórios, issues e pull requests
- Cada ação de escrita requer a sua aprovação explícita na interface
- Desative o conector quando não estiver em uso para melhorar a precisão do modelo
- A combinação com outros conectores MCP cria fluxos de trabalho automatizados poderosos