Como usar o GitHub com agentes de IA gratuitamente (2026)

Sim, o GitHub é gratuito: o plano GitHub Free oferece repositórios públicos e privados ilimitados, colaboradores ilimitados e 2.000 minutos de GitHub Actions por mês. Agentes de IA também podem utilizá-lo nesse plano. A própria documentação do GitHub afirma que o seu servidor MCP oficial está “disponível para todos os usuários do GitHub, independentemente do tipo de plano”, permitindo que o Claude Code, o Codex ou o OpenCode leiam issues, abram pull requests e verifiquem execuções de workflows sem a necessidade de um plano pago do GitHub. O que pode ter custo é o modelo de IA do agente — e há um caminho que mantém isso a $0 também.

TL;DR

Conecte o servidor MCP oficial do GitHub ao seu agente de programação usando um personal access token detalhado (fine-grained). No GitHub Free, os limites mais relevantes são os minutos do Actions em repositórios privados, o limite de requisições da API REST e alguns recursos de colaboração exclusivos de repositórios públicos. O verdadeiro custo está no agente: o Claude Code e o Codex exigem um plano pago ou créditos de API, enquanto o OpenCode roda diversos modelos gratuitos atualmente. Quando os agentes começarem a trabalhar de verdade, a integração do Sharkly com o GitHub converte novas issues em Tarefas (Tasks) que você pode atribuir a um Agente.

Componente	Gratuito?	O limite	O que você paga ao exceder
GitHub Free	Sim	2.000 minutos de Actions/mês em repositórios privados (repositórios públicos são gratuitos); 500 MB de armazenamento no Packages	Um plano pago do GitHub ou minutos avulsos
GitHub MCP server	Sim, em todos os planos	Limite REST do seu token: 5.000 requisições/hora	Ferramentas atreladas a recursos pagos exigem a respectiva assinatura
Copilot Free	Sim	2.000 autocompletes/mês, cota de AI Credits não informada, sem agente na nuvem	Copilot Pro ou superior
Agent: OpenCode free model	Sim, por enquanto	Modelos promocionais, por tempo limitado	OpenCode Zen ou Go
Agent: Claude Code / Codex	Não	Exige plano ou chave de API	Seu plano do Claude ou ChatGPT, ou tokens
Sharkly board	Atualmente gratuito	Organizações de até 5 pessoas	$7 por pessoa/mês, faturado anualmente

Plano gratuito do GitHub: os limites mais importantes para agentes

O GitHub Free é generoso em armazenamento e usuários, mas é mais restrito justamente onde os agentes costumam exigir mais.

Minutos de Actions. A página de preços lista 2.000 minutos por mês, e o Actions é “Gratuito para repositórios públicos”. Um agente que cria pull requests aciona sua CI a cada push. Dez PRs de agentes por dia com uma suíte de testes de seis minutos, cada um com dois pushes, consumiriam cerca de 3.600 minutos no mês. Em um repositório privado, portanto, a cota de minutos pode ser a primeira barreira. Mantenha a CI rápida ou cancele execuções obsoletas com um grupo de concurrency no workflow.

Limites de requisições (rate limits). Cada chamada de ferramenta MCP se transforma em uma chamada à API do GitHub feita com o seu token. A documentação de limites de taxa da API REST do GitHub concede a um token pessoal 5.000 requisições por hora, além de limites secundários, como cerca de 80 requisições de criação de conteúdo por minuto. Um único agente raramente atinge qualquer um deles; múltiplos agentes compartilhando o mesmo token podem atingir.

Recursos exclusivos de repositórios públicos. No plano Free, code owners, rascunhos de pull requests (draft PRs) e regras de proteção de ambiente estão disponíveis apenas para repositórios públicos. Se você quiser que os agentes criem drafts em um repositório privado, precisará de um plano pago.

Copilot Free. Inclui até 2.000 autocompletes de código por mês, modo agente e suporte a MCP no editor, mas a página de planos indica que o agente em nuvem do Copilot não está incluso, e a franquia de AI Credits não é informada numericamente. Trate-o como um assistente no editor, e não como um colega de equipe a quem você pode delegar issues.

O próprio servidor MCP. A documentação de configuração do MCP do GitHub acrescenta um limite: “Se um recurso exigir uma licença paga do GitHub ou do Copilot, a ferramenta MCP equivalente exigirá a mesma assinatura”. Issues, pull requests, repositórios e logs do Actions funcionam no plano Free; ferramentas que controlam o agente em nuvem do Copilot, não.

Como conectar o GitHub ao Claude Code, Codex ou OpenCode

O repositório github-mcp-server descreve duas maneiras de executá-lo: pelo endpoint hospedado do GitHub em https://api.githubcopilot.com/mcp/ ou por uma imagem Docker local. A opção hospedada não exige nada instalado, sendo o melhor ponto de partida.

1. Crie um personal access token detalhado (fine-grained). Conceda acesso apenas aos repositórios com os quais o agente deve interagir, com permissão de leitura e escrita em Issues e Pull requests e de leitura em Contents e Actions. Os guias do GitHub mencionam o escopo clássico repo; um token fine-grained restrito a repositórios específicos é uma escolha muito mais segura para um agente.

2a. Claude Code. Em um terminal comum, de acordo com o guia do Claude no GitHub:

claude mcp add --transport http github https://api.githubcopilot.com/mcp \
  -H "Authorization: Bearer YOUR_GITHUB_PAT"

Em seguida, execute claude mcp list e confirme se o github está conectado.

2b. Codex. O guia do Codex no GitHub lê o token a partir de uma variável de ambiente, garantindo que ele nunca fique salvo no arquivo de configuração:

export GITHUB_PAT_TOKEN=your_token
codex mcp add github --url https://api.githubcopilot.com/mcp/ \
  --bearer-token-env-var GITHUB_PAT_TOKEN

Execute /mcp dentro do Codex para ver as ferramentas.

2c. OpenCode. Adicione o trecho a seguir ao opencode.json na raiz do projeto, conforme o guia do OpenCode no GitHub:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "github": {
      "type": "remote",
      "url": "https://api.githubcopilot.com/mcp/",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

A sintaxe {env:...} mantém o token nas variáveis do seu ambiente, não em um arquivo que você possa comitar acidentalmente.

3. Reduza os conjuntos de ferramentas (toolsets). Os conjuntos padrão são context, repos, issues, pull_requests e users. Menos ferramentas significam menos espaço de contexto consumido com descrições. O servidor local também aceita a flag --read-only, um ponto de partida bastante sensato para um agente responsável apenas por triagem.

4. Faça um pedido simples. “Liste as issues abertas com o rótulo bug neste repositório e resuma as três mais antigas” valida o token, o servidor e o agente em um único prompt.

A rota a custo zero ($0)

Esta é a combinação que não custa nada hoje: GitHub Free, o servidor MCP hospedado com um token fine-grained e o OpenCode rodando um de seus modelos gratuitos.

O plano gratuito do OpenCode não exige cadastro nem chave de API. Nós o executamos em 16 de outubro de 2026 (OpenCode 1.19.2 via npx opencode-ai@latest): uma tarefa de escrita e execução foi concluída em 32 segundos no opencode/deepseek-v4.1-flash-free. A documentação do OpenCode Zen lista esse modelo como gratuito hoje, ao lado de glm-5.3-flash-free e outros, e informa que seu provedor mantém retenção zero e não treina modelos com os seus dados. Outros modelos gratuitos na mesma lista podem utilizar seus dados, portanto leia as observações antes de apontar algum deles para um repositório privado.

Os limites reais:

Modelos gratuitos são promocionais. O Zen classifica a maioria deles como gratuitos “por tempo limitado”. Planeje-se para o dia em que o seu modelo sair do ar.
O nível gratuito atende apenas ao OpenCode. Chamar o mesmo endpoint via script retorna o erro HTTP 403 FreeTierError.
Os minutos de Actions continuam contando. O agente é gratuito, mas a CI que ele aciona em repositórios privados não é ilimitada.
Claude Code e Codex não fazem parte dessa rota. O Claude Code exige um plano pago do Claude ou créditos de API; o Codex requer um plano do ChatGPT ou uma chave de API da OpenAI.

Do chat à atribuição de tarefas

Colar “corrija a issue #142” no terminal funciona para uma pessoa. Para um time, o passo realmente útil é atribuir a issue a um agente e acompanhar o resultado onde todos possam ver.

O Sharkly conta com uma integração nativa com o GitHub exatamente para isso, descrita na documentação de integração com o GitHub:

Issues se transformam em Tasks. O proprietário (Owner) ou administrador da organização instala o GitHub App e escolhe os repositórios. Ao vincular um repositório a um Space, novas issues criadas são sincronizadas como Tasks. Issues existentes não são importadas. A sincronização unidirecional flui do GitHub para o Sharkly; um Space também pode ter um repositório com sincronização bidirecional.
Pull requests vinculam-se automaticamente. Inclua um Task ID no nome da branch, no título ou no corpo do PR e o Sharkly tentará associar o PR à Task. Fazer o merge de um PR não altera o status da Task; fechar ou reabrir uma issue sincronizada pode alterá-lo.
Atribua a Task a um Agent. O Agent executa o Claude Code, o Codex ou o OpenCode no seu próprio Computer, rodando cada Task em um worktree isolado do Git, e retorna o progresso e os resultados diretamente para a Task.

Um detalhe importante: o GitHub App não concede permissão de clone ao Agent. A clonagem ainda depende da chave SSH ou das credenciais HTTPS configuradas no Computer como repositórios no Agent ou no Space.

E quanto ao servidor MCP dentro de uma execução no Sharkly? A documentação do Sharkly não aborda o MCP. Nossa conclusão: como o Agent executa a CLI do próprio agente no worktree do repositório, um arquivo .mcp.json no escopo do projeto comitado no repositório (ou a configuração de usuário naquele Computer) deve ser carregado na execução. Faça um teste simples (smoke test) com uma Task pequena antes de depender desse fluxo. O artigo Como atribuir uma issue do GitHub a um agente de IA detalha o processo, e o artigo GitHub Agent HQ explicado traz a visão do próprio GitHub sobre a atribuição de agentes.

O quadro é atualmente gratuito para organizações de até 5 pessoas, Agents e Computers não ocupam licenças (seats) e os custos dos modelos continuam nas suas próprias assinaturas ou chaves. Mantenha contexto, progresso, bloqueios, resultados e revisão humana reunidos em um só lugar, da issue ao merge.

Pontos de atenção

Um token compartilhado significa limite de requisições compartilhado. Crie um token fine-grained próprio para cada agente, evitando que um agente sobrecarregado limite a taxa dos demais.
Nunca coloque o token em texto puro no .mcp.json. O Claude Code expande ${VAR} nos cabeçalhos de .mcp.json, portanto comite apenas o nome da variável e mantenha o valor no Computer.
Draft PRs em repositórios privados exigem plano pago. No Free, instrua o agente a abrir PRs convencionais incluindo “WIP” no título.
Pushes do agente consomem minutos de Actions. Adicione um grupo de concurrency com cancel-in-progress: true para cancelar execuções obsoletas.
Ferramentas do agente em nuvem do Copilot falham no Free. Essa é uma regra de licença paga, e não um problema com o seu token.

FAQ

O GitHub é gratuito? Sim. O GitHub Free inclui repositórios públicos e privados ilimitados, colaboradores ilimitados, 2.000 minutos de Actions por mês em repositórios privados e 500 MB de armazenamento no Packages.

O servidor MCP do GitHub é gratuito? Sim. O GitHub afirma que ele está disponível para todos os usuários, independentemente do tipo de plano. Ferramentas atreladas a recursos pagos, como o agente em nuvem do Copilot, exigem a respectiva assinatura.

O que o plano gratuito do GitHub não inclui para agentes? Minutos ilimitados de Actions em repositórios privados, draft pull requests e code owners em repositórios privados, além do agente em nuvem do Copilot.

É possível rodar um agente de programação no GitHub a $0? Sim, combinando o OpenCode em um modelo gratuito com o GitHub Free e o servidor MCP hospedado. Como os modelos gratuitos são promoções por tempo limitado, prepare-se para migrar no futuro. Para conhecer alternativas de custos entre modelos, veja quanto custa rodar uma equipe de agentes em planos gratuitos e econômicos e, para manter o trabalho de múltiplos agentes organizado, confira gestão de projetos para Claude Code.