Cómo usar GitHub con agentes de IA gratis (2026)

Sí, GitHub es gratis: el plan GitHub Free te ofrece repositorios públicos y privados ilimitados, colaboradores ilimitados y 2.000 minutos mensuales de GitHub Actions. Los agentes de IA también pueden utilizarlo con este plan. La propia documentación de GitHub indica que su servidor MCP oficial está «disponible para todos los usuarios de GitHub independientemente de su tipo de plan», por lo que Claude Code, Codex u OpenCode pueden leer issues, abrir pull requests y verificar ejecuciones de workflows sin necesidad de contratar un plan de pago de GitHub. Por lo que sí podrías tener que pagar es por el modelo del agente, aunque existe una vía para que eso también te cueste 0 $.

En resumen

Conecta el servidor MCP oficial de GitHub a tu agente de desarrollo mediante un personal access token de control granular (fine-grained). En GitHub Free, los límites verdaderamente relevantes son los minutos de Actions en repositorios privados, el límite de peticiones (rate limit) de la API REST y algunas funciones de colaboración exclusivas para repositorios públicos. El coste real proviene del agente: Claude Code y Codex requieren un plan de pago o créditos de API, mientras que OpenCode ofrece varios modelos gratuitos actualmente. En cuanto los agentes comiencen a realizar trabajo real, la integración de GitHub con Sharkly transforma los nuevos issues en Tareas que puedes asignar a un Agente.

Componente	¿Gratis?	Límite	Coste al superarlo
GitHub Free	Sí	2.000 minutos de Actions/mes en repos privados (gratis en públicos); 500 MB de almacenamiento en Packages	Un plan de pago de GitHub o minutos por consumo
Servidor MCP de GitHub	Sí, en todos los planes	Cuota REST de tu token: 5.000 peticiones/hora	Las herramientas vinculadas a funciones de pago requieren dicha suscripción
Copilot Free	Sí	2.000 autocompletados/mes, asignación no especificada de créditos de IA, sin agente en la nube	Copilot Pro o superior
Agente: modelo gratuito de OpenCode	Sí, por ahora	Modelos en promoción, tiempo limitado	OpenCode Zen o Go
Agente: Claude Code / Codex	No	Requiere un plan o clave de API	Tu plan de Claude o ChatGPT, o pago por tokens
Tablero de Sharkly	Actualmente gratis	Organizaciones de hasta 5 personas	7 $ por persona/mes, facturado anualmente

El plan gratuito de GitHub: los límites clave para agentes

GitHub Free es generoso en almacenamiento y usuarios, pero más restrictivo en los aspectos donde un agente suele ejercer mayor presión.

Minutos de Actions. La página de precios especifica 2.000 minutos al mes e indica que Actions es «gratuito para repositorios públicos». Un agente que abre pull requests activa tu CI en cada push. Si genera diez PRs al día con una suite de pruebas de seis minutos y dos pushes por PR, consumiría unos 3.600 minutos al mes; por tanto, en un repositorio privado el presupuesto de minutos puede ser el primer cuello de botella. Mantén la CI rápida o cancela las ejecuciones obsoletas usando un grupo de concurrency en el workflow.

Límites de peticiones (rate limits). Cada llamada a una herramienta MCP se convierte en una llamada a la API de GitHub realizada con tu token. La documentación de rate limits de la API REST de GitHub asigna a un personal token 5.000 peticiones por hora, con límites secundarios como unas 80 peticiones de creación de contenido por minuto. Un solo agente rara vez alcanzará estos límites, pero varios agentes compartiendo el mismo token sí pueden hacerlo.

Funciones exclusivas para repositorios públicos. En el plan Free, los code owners, los draft pull requests y las reglas de protección de entornos solo están disponibles para repositorios públicos. Si quieres que los agentes abran borradores (drafts) en un repositorio privado, necesitarás un plan de pago.

Copilot Free. Incluye hasta 2.000 sugerencias de código al mes, modo agente y compatibilidad con MCP en el editor, pero la página de planes señala que el agente en la nube de Copilot no está incluido y no especifica una cifra exacta para la cuota de créditos de IA. Considéralo como un asistente en el editor y no como un compañero de equipo al que puedas asignarle issues.

El servidor MCP en sí. La documentación de configuración de MCP de GitHub añade una condición: «Si una funcionalidad requiere una licencia de pago de GitHub o Copilot, la herramienta MCP equivalente requerirá la misma suscripción». Los issues, pull requests, repositorios y logs de Actions funcionan en el plan Free; las herramientas que gestionan el agente en la nube de Copilot, no.

Cómo conectar GitHub a Claude Code, Codex u OpenCode

El repositorio github-mcp-server documenta dos formas de ejecutarlo: el endpoint alojado por GitHub en https://api.githubcopilot.com/mcp/ o una imagen local de Docker. La versión alojada no requiere instalar nada, así que conviene empezar por ahí.

1. Crea un personal access token de control granular (fine-grained). Otórgale acceso únicamente a los repositorios con los que el agente deba interactuar, con permisos de lectura y escritura en Issues y Pull requests, y de lectura en Contents y Actions. Las guías de GitHub mencionan el scope clásico repo, pero un token fine-grained limitado a unos pocos repositorios es una opción mucho más segura para un agente.

2a. Claude Code. Desde un terminal convencional, según la guía de Claude de GitHub:

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

A continuación, ejecuta claude mcp list y confirma que github esté conectado.

2b. Codex. La guía de Codex de GitHub lee el token desde una variable de entorno para evitar que quede guardado en el archivo de configuración:

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

Ejecuta /mcp dentro de Codex para ver las herramientas disponibles.

2c. OpenCode. Añade lo siguiente a opencode.json en la raíz del proyecto, según la guía de OpenCode de 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}"
      }
    }
  }
}

La sintaxis {env:...} mantiene el token en tu entorno de terminal y no en un archivo que podrías incluir por error en un commit.

3. Reduce los toolsets. Los toolsets por defecto son context, repos, issues, pull_requests y users. Menos herramientas implica gastar menos contexto en descripciones de tools. El servidor local también admite el flag --read-only, una opción razonable para empezar con un agente dedicado solo a clasificar o priorizar tareas (triage).

4. Pídele una tarea pequeña. Una petición como «Enumera los issues abiertos con la etiqueta bug en este repo y resume los tres más antiguos» permite validar el token, el servidor y el agente en un único prompt.

La opción de 0 $

Esta es la combinación que actualmente tiene coste cero: GitHub Free, el servidor MCP alojado con un token fine-grained y OpenCode utilizando uno de sus modelos gratuitos.

El nivel gratuito de OpenCode no requiere registro ni clave de API. Lo probamos el 16 de octubre de 2026 (OpenCode 1.19.2 mediante npx opencode-ai@latest): una tarea de escritura y ejecución se completó en 32 segundos con opencode/deepseek-v4.1-flash-free. La documentación de OpenCode Zen incluye actualmente ese modelo como gratuito, junto con glm-5.3-flash-free y otros, e indica que su proveedor ofrece retención cero y no entrena con tus datos. Otros modelos gratuitos de la misma lista sí podrían usar tus datos, así que revisa bien las condiciones antes de utilizarlos en un repositorio privado.

Los límites reales que debes tener en cuenta:

Los modelos gratuitos son promocionales. Zen señala que la mayoría son gratuitos «por tiempo limitado». Anticípate al día en que el tuyo deje de estar disponible.
El nivel gratuito solo responde a OpenCode. Si intentas llamar al mismo endpoint desde un script, devolverá un error HTTP 403 FreeTierError.
Los minutos de Actions siguen contando. El agente es gratuito, pero la CI que activa en un repositorio privado no es ilimitada.
Claude Code y Codex no entran en esta opción. Claude Code requiere un plan de pago de Claude o créditos de API; Codex necesita un plan de ChatGPT o una API key de OpenAI.

Del chat a la asignación de tareas

Pegar «arregla el issue #142» en un terminal funciona bien para una persona individual. Sin embargo, para un equipo, el verdadero salto productivo consiste en asignar el issue a un agente y recibir el resultado en un espacio visible para todos.

Sharkly cuenta con una integración nativa con GitHub para ello, detallada en su documentación de integración con GitHub:

Los issues se convierten en Tareas. Un propietario (Owner) o administrador de la organización instala la GitHub App y selecciona los repositorios. Al vincular un repositorio a un Espacio (Space), los nuevos issues se sincronizan como Tareas. Los issues existentes no se importan. La sincronización unidireccional fluye de GitHub hacia Sharkly; además, un Espacio puede tener un repositorio con sincronización bidireccional.
Los pull requests se vinculan automáticamente. Si incluyes el ID de la Tarea en el nombre de la rama, en el título de la PR o en su descripción, Sharkly intentará vincular la PR con la Tarea correspondiente. Hacer merge de una PR no altera el estado de la Tarea; cerrar o reabrir un issue sincronizado sí puede hacerlo.
Asigna la Tarea a un Agente. El Agente ejecuta Claude Code, Codex u OpenCode en tu propio equipo (Computer), ejecutando cada Tarea en un git worktree aislado, y reportando el progreso y los resultados directamente en la Tarea.

Hay una limitación importante: la GitHub App no concede al Agente permisos de clonación. Para clonar se sigue utilizando la clave SSH o las credenciales HTTPS de la máquina (Computer), configuradas como repositorios en el Agente o en el Espacio.

¿Y qué ocurre con el servidor MCP durante una ejecución en Sharkly? La documentación de Sharkly no menciona MCP. Nuestra conclusión: como el Agente ejecuta la propia CLI del agente en el worktree del repositorio, un archivo .mcp.json a nivel de proyecto commiteado en el repositorio (o la configuración de usuario en ese equipo) debería cargarse durante la ejecución. Haz una prueba básica (smoke test) con una Tarea pequeña antes de depender de ello. El artículo sobre cómo asignar un issue de GitHub a un agente de IA explica el flujo paso a paso, y GitHub Agent HQ explicado analiza el enfoque propio de GitHub para la asignación de agentes.

El panel es actualmente gratuito para organizaciones de hasta 5 personas, los Agentes y los Equipos (Computers) no consumen licencias (seats), y el gasto de los modelos corre por cuenta de tus propias suscripciones o claves de API. Mantén el contexto, el progreso, los bloqueos, los resultados y la revisión humana en un único lugar, desde el issue hasta el merge.

Puntos a tener en cuenta

Un token compartido significa un límite de peticiones compartido. Asigna a cada agente su propio token fine-grained para evitar que un agente muy activo agote la cuota de los demás.
Nunca incluyas el token en texto plano dentro de .mcp.json. Claude Code expande ${VAR} en las cabeceras de .mcp.json, así que incluye la variable en el commit y mantén el valor en la máquina.
Los draft PRs en repositorios privados requieren un plan de pago. En el plan Free, pídele al agente que abra PRs estándar incluyendo «WIP» en el título.
Los pushes del agente consumen minutos de Actions. Añade un grupo de concurrency con cancel-in-progress: true para cancelar ejecuciones obsoletas.
Las herramientas del agente en la nube de Copilot fallan en Free. Es una limitación por requerir licencia de pago, no un fallo de configuración de tu token.

Preguntas frecuentes

¿GitHub es gratis? Sí. GitHub Free incluye repositorios públicos y privados ilimitados, colaboradores ilimitados, 2.000 minutos de Actions al mes para repositorios privados y 500 MB de almacenamiento para Packages.

¿El servidor MCP de GitHub es gratis? Sí. GitHub afirma que está disponible para todos los usuarios sin importar su plan. Las herramientas vinculadas a funciones de pago, como el agente en la nube de Copilot, sí requieren la suscripción correspondiente.

¿Qué no incluye el plan gratuito de GitHub para los agentes? Minutos ilimitados de Actions en repositorios privados, draft pull requests y code owners en repositorios privados, ni el agente en la nube de Copilot.

¿Puedo ejecutar un agente de desarrollo en GitHub por 0 $? Sí, combinando OpenCode con un modelo gratuito, GitHub Free y el servidor MCP alojado. Ten presente que los modelos gratuitos son promociones por tiempo limitado, por lo que es previsible tener que cambiar más adelante. Para comparar costes entre distintos modelos, consulta cuánto cuesta ejecutar un equipo de agentes en niveles gratuitos y económicos, y para mantener organizado el trabajo de varios agentes, revisa gestión de proyectos para Claude Code.