GitHub MCP: guía de configuración y todo lo que permite

GitHub MCP es un conector que permite a Claude trabajar directamente con tus repositorios: leer código, abrir Issues y comentarlos, revisar pull requests y comprobar ejecuciones de flujos de trabajo, sin que tengas que pegar nada. Funciona con Model Context Protocol, el estándar abierto que Anthropic publicó para que los asistentes puedan llamar a herramientas externas mediante una única interfaz. GitHub mantiene un servidor oficial, y también existen implementaciones de la comunidad. La configuración es de las más sencillas del mundo de MCP: crea un token de acceso con permisos limitados, añade una entrada de servidor a la configuración de tu cliente de AI, reinicia y ya estarás conectado, normalmente en quince minutos. Lo que merece tu atención no es la configuración, sino a qué repositorios y qué permisos concedes.

¿Qué es GitHub MCP y en qué se diferencia de pegar código sin más?

MCP es un estándar sobre cómo un asistente solicita elementos a un sistema externo y recibe respuestas estructuradas. Un servidor es el adaptador que lo implementa. GitHub MCP es el adaptador para tus repositorios.

La diferencia con pegar código está en el alcance y el estado. El código pegado es una instantánea sin historial: Claude ve el archivo, pero no los tres commits que hicieron que tuviera ese aspecto, ni el Issue que explica por qué, ni la comprobación fallida que se ejecutó anoche. Con la conexión, Claude trabaja con el repositorio como un sistema activo, en lugar de con un fragmento de texto.

También elimina el paso en el que decides qué es relevante antes de que Claude vea nada. Ese paso es donde empiezan la mayoría de las malas revisiones de código con AI, porque el contexto que omitiste suele ser precisamente el que importaba.

¿Qué permite realmente GitHub MCP?

Trabajos concretos, no afirmaciones vagas sobre productividad.

  • Revisión de pull requests que incluye el diff y el debate. Claude lee los cambios, la descripción, los comentarios de revisión y el Issue vinculado en conjunto; después te indica qué es arriesgado en ese cambio concreto, en lugar de hablar del código en general.
  • Triaje de Issues a gran escala. Detección de duplicados, pasos de reproducción ausentes, etiquetado por área y una lista breve de los que realmente necesitan atención humana esta semana.
  • Arqueología del repositorio. Cuándo cambió esta función, qué pull request introdujo la marca, a qué Issue hace referencia este TODO. Respuestas con commits adjuntos en lugar de conjeturas.
  • Notas de la versión que reflejan la realidad. Generadas a partir de pull requests fusionadas en un intervalo, no de la memoria de alguien sobre el sprint.
  • Investigación de fallos de CI. Leer una ejecución fallida del flujo de trabajo, relacionar el error con el cambio que lo causó y proponer la solución como un diff.
  • Preguntas entre repositorios. Dónde se utiliza también este asistente obsoleto, qué servicios siguen llamando al endpoint antiguo.

Fíjate en lo que falta de esa lista: nada de ello es "escribe mi funcionalidad". Conectar un repositorio mejora lo que Claude sabe. No mejora cómo Claude evalúa el código, que es un problema distinto con una solución distinta.

¿Cómo se configura GitHub MCP?

Los comandos y endpoints específicos cambian con la suficiente frecuencia como para que copiarlos de un artículo no sea fiable. La estructura no cambia.

  1. Elige tu servidor. GitHub mantiene un servidor MCP oficial, que es la opción predeterminada más sensata. Por lo general, se puede usar como un endpoint alojado o ejecutarse localmente, y la opción local es la que debes elegir si tu organización es estricta con respecto a dónde viaja el contexto del código. También existen servidores de la comunidad, incluidos en los directorios públicos de MCP.
  2. Crea un token de acceso con permisos limitados. En la configuración de tu cuenta de GitHub, genera un token limitado a los repositorios específicos a los que quieras permitir el acceso, con solo los permisos que necesites. Los tokens de acceso detallado existen precisamente para esto. Algunos clientes admiten en su lugar un flujo de OAuth, que es más limpio cuando está disponible.
  3. Decide si será de lectura o de escritura antes que cualquier otra cosa. Solo lectura significa que Claude puede revisar, buscar y explicar. Escritura significa que Claude puede abrir incidencias, comentar y subir ramas. Empieza con solo lectura.
  4. Añade el servidor a la configuración MCP de tu cliente de AI. Claude Desktop, Claude Code y la mayoría de los editores compatibles con AI leen un archivo de configuración que enumera los servidores, los comandos de inicio y las credenciales. Una entrada.
  5. Reinicia el cliente y verifica. El cliente muestra los servidores conectados y las herramientas que exponen. Si aparecen las herramientas de GitHub, has terminado.
  6. Prueba con algo poco importante. Indícale un repositorio, pídele que resuma una solicitud de cambios abierta y confirma que la respuesta coincide con lo que puedes ver tú.

Si ya trabajas con Claude Code, esta combinación es la que más cambiará tu día a día, porque el asistente que edita tu copia de trabajo también puede ver la solicitud de cambios a la que se dirige esa copia.

¿Qué deberías tener en cuenta?

Limitaciones honestas que conviene leer antes de que exista el token.

  • Un token es una llave para todo aquello a lo que puede acceder. Un token personal amplio en una cuenta de organización permite acceder a muchas cosas. Limítalo siempre a repositorios específicos.
  • El acceso de escritura convierte los errores en artefactos públicos. Un comentario no deseado en una incidencia visible para los clientes es un problema de otra categoría que un párrafo no deseado en tu ventana de chat.
  • El código sale de tu equipo. Todo lo que lee el asistente pasa a formar parte de una solicitud a un proveedor de AI. Si tu empresa tiene normas sobre el código fuente propietario, se aplican aquí, y el conector facilita mucho enviar bastante más de lo que pretendías.
  • Los repositorios grandes superan el contexto. Claude no puede contener tu monorepo. Las preguntas específicas funcionan. «Revisa toda la base de código» no.
  • Necesita un cliente técnico. Una aplicación de escritorio, un editor o un terminal, no una pestaña de chat del navegador.
  • El mantenimiento es real. Las API cambian, los servidores se reescriben y los formatos de configuración cambian. Esto es infraestructura, y la infraestructura necesita atención ocasional.

¿Y si quieres la revisión, no la configuración?

Esta es la distinción importante. GitHub MCP decide a qué puede acceder Claude. No dice nada sobre el estándar que aplica Claude una vez que llega allí. Conecta un repositorio a un asistente genérico y obtendrás comentarios genéricos, más rápido y en mayor volumen: objeciones menores de estilo, una sugerencia para añadir comentarios y una observación sobre los nombres.

Lo que cambia la calidad de la revisión es un método: qué comprobar primero, qué riesgos importan más que otros, qué significa un comentario bloqueante frente a una sugerencia y cómo redactar los hallazgos para que el autor pueda actuar sobre ellos. Eso es un archivo de Skill. Un documento breve de Markdown que subes una vez a Claude, dándole un rol y un estándar. Se instala en tres minutos, funciona con cualquier plan y funciona con MCP conectado o sin él.

El estándar de revisión, no la conexión

Yuri, Skill de AI para revisión de código
Yuri - Skill de AI para revisión de código

$29

esta Skill

Revisa en el orden en que lo haría un ingeniero sénior: corrección, después seguridad y casos límite, luego estructura y finalmente estilo, separando los problemas bloqueantes de las preferencias. Combínalo con un repositorio conectado y los comentarios de las solicitudes de incorporación de cambios dejan de ser ruido.

Ver a Yuri →

Si quieres algo que lleve una revisión completa de principio a fin en lugar de responder una pregunta cada vez, la versión agent gestiona la versión de varios pasos del mismo trabajo.

La versión de varios pasos

Albert, agent de revisión de código con AI
Albert - agent de revisión de código con AI

$32

este agent

Lleva una base de código o un conjunto de cambios desde la primera revisión hasta un informe escrito: clasificación por gravedad, notas de reproducción, diferencias sugeridas y un resumen que un responsable puede utilizar. Diseñado para cuando la revisión completa es el resultado final.

Ver a Albert →

Para la parte de canalización del repositorio

Rami, Skill de AI para DevOps
Rami - Skill de AI para DevOps

$29

esta Skill

Flujos de trabajo, seguridad de los despliegues, planes de reversión y modos de fallo que solo se aprenden por las malas. Útil desde el momento en que tu configuración de MCP empieza a leer ejecuciones de CI y quieres que la solución se razone correctamente.

Ver Rami →

El conjunto más amplio está en Skills de tecnología y desarrollo, con el desglose por roles en Skills de programación con AI para Claude. También hay 32 archivos gratuitos en la colección gratuita si quieres probar primero el formato sin coste.

En resumen:

GitHub MCP conecta Claude con repositorios, incidencias y pull requests mediante un token con alcance limitado y una sola entrada de configuración, y merece la pena configurarlo si revisas cambios con regularidad. Limita el alcance, empieza en modo de solo lectura. Para la calidad de la propia revisión, añade Yuri - Code Reviewer por 29 $, o Albert - AI Code Review Agent por 32 $ cuando toda la revisión sea el entregable.

GitHub MCP: preguntas frecuentes

¿Es oficial el servidor MCP de GitHub?

GitHub mantiene un servidor MCP oficial, que es por donde debería empezar la mayoría de la gente, y existen alternativas de la comunidad para necesidades específicas. Búscalos en los directorios públicos de servidores MCP en lugar de confiar en un enlace de una publicación de blog, incluida esta, ya que estos proyectos cambian.

¿Puede Claude abrir pull requests y subir código?

Solo si el token que creaste lo permite. Muchas configuraciones permanecen deliberadamente en modo de solo lectura, de modo que Claude revisa y explica mientras una persona se encarga de cualquier acción que escriba datos. Es un valor predeterminado razonable, y puedes ampliarlo más adelante cuando sepas cómo funciona el flujo de trabajo.

¿GitHub MCP funciona con repositorios privados?

Sí, sujeto al alcance del token, que es precisamente por lo que merece la pena pensar en el alcance. Un token con permisos detallados limitado a los dos repositorios en los que realmente trabajas es una configuración mucho mejor que uno que pueda acceder a toda una organización.

¿Sigo necesitando una skill de revisión de código una vez conectado GitHub MCP?

El acceso y los estándares son cosas diferentes. MCP muestra el diff a Claude. Una skill decide qué se considera un problema, en qué orden y cómo se documenta. Por eso los equipos generalmente usan ambos, como se explica en Claude Skills vs MCP y con más detalle en la guía del agent de revisión de código con AI.

~/get-started

Skills que funcionan. Sin palabrería.

Explora cada skill, prompt pack y agent de la tienda.

Explorar todas las habilidades →O prueba las herramientas gratuitas