IA by DNACX

#5 no GitHub · Agir no código

Como instalar o servidor MCP do GitHub: passo a passo

Conecta a IA ao GitHub. Com ele, o assistente lê repositórios e arquivos de código, cria e atualiza issues e pull requests, acompanha execuções do GitHub Actions e analisa alertas de segurança, tudo por conversa.

Para quem
Quem usa GitHub e quer que o Claude Code leia e mexa em repositórios, issues e pull requests.
Estrelas (07/11/2026)
34.300, #5 no ranking
Licença
MIT
Repositório
github/github-mcp-server

Passo a passo

Antes de começar: Docker instalado e rodando (para a versão local usada neste passo a passo); Um token de acesso pessoal do GitHub (Personal Access Token); Um cliente MCP compatível, como o Claude Code.

  1. Escolha entre servidor hospedado ou local

    O README descreve duas formas. O servidor remoto é hospedado pelo GitHub e é o jeito mais fácil, mas exige um cliente que aceite servidores remotos. A versão local roda em um contêiner Docker. Este passo a passo segue a versão local com o comando do Claude Code que o README traz.

  2. Instale e abra o Docker

    A versão local roda dentro de um contêiner. Instale o Docker e deixe-o aberto antes de seguir.

  3. Crie um token de acesso pessoal no GitHub

    O README manda criar um Personal Access Token e liberar só as permissões que você aceita dar à IA. Guarde o token em um lugar seguro, sem colar em arquivos que vão para o repositório.

  4. Guarde o token numa variável do terminal

    Troque your_token_here pelo seu token. O README recomenda guardar o token em variável de ambiente.

    Comando
    export GITHUB_PAT=your_token_here

  5. Registre o servidor no Claude Code

    Rode este comando no terminal. Ele cadastra o servidor chamado github e usa o contêiner Docker oficial.

    Comando
    claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

  6. Se quiser só leitura, ligue o modo somente leitura

    O README tem um modo que oferece só ferramentas de leitura, sem alterar repositórios, issues ou pull requests. Ele aparece em um exemplo com Docker, usando a variável GITHUB_READ_ONLY=1. Para usar com o comando do passo anterior, é preciso adicionar essa variável, e o README não mostra esse comando pronto para o Claude Code.

Primeiro teste

O README não traz um pedido de teste. Peça uma tarefa simples e confira se o servidor entra em ação.

Cuidados

  • O token dá à IA o poder que as permissões dele permitirem. O README recomenda conceder só o necessário e usar tokens separados por projeto.
  • O README recomenda renovar os tokens periodicamente e nunca enviá-los ao controle de versão.
  • O modo somente leitura (--read-only) impede alterações em repositórios, issues e pull requests.
  • O modo lockdown filtra conteúdo de repositórios públicos para reduzir o risco de injeção de comandos, mas o próprio README diz que não é uma barreira de autorização.
  • Texto de issues e pull requests de terceiros pode ter instruções escondidas, por isso o README cita o risco de injeção de comandos (prompt injection).

Como desfazer

O README não traz um passo de remoção do servidor. Ele só diz como atualizar o login do Docker se o download da imagem falhar.

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README não diz qual cota ou custo de uso se aplica à conta do GitHub.
  • O README não detalha quais permissões exatas do token cada ferramenta exige. Confira a lista de ferramentas antes de liberar.
  • O comando do Claude Code não traz o modo somente leitura pronto. Confira a documentação do cliente antes de adaptar.
  • Não está confirmado como o servidor se comporta em português.

Dúvidas

Preciso instalar algo no computador?

Na versão local, sim: o Docker. O servidor remoto hospedado pelo GitHub não pede isso, mas exige um cliente que aceite servidores remotos.

A IA pode apagar ou alterar meu código?

Depende das permissões do token e do modo. Com o modo somente leitura ligado, o README diz que só as ferramentas de leitura ficam disponíveis.

Dá para usar sem criar token?

O README diz que, no github.com, os botões de instalação com um clique usam login por OAuth no navegador. O comando do Claude Code mostrado neste passo a passo usa token.

A DNACX usa o servidor MCP do GitHub?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próximo da lista

← #4 Playwright MCP · #6 MCP for Blender →

Ver os 15 MCPs

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de github/github-mcp-server, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.