Cómo conectar GitHub MCP con Claude Code: guía paso a paso (2026)

¿Qué es GitHub MCP con Claude Code (y qué puede hacer)?

El servidor GitHub MCP es el puente que permite a Claude Code leer y actuar en GitHub directamente mediante lenguaje natural - sin salir de la terminal, sin copiar y pegar a mano. MCP (Model Context Protocol) es un estándar abierto que conecta la IA con herramientas externas; si el concepto es nuevo para ti, empieza por qué es MCP y cómo funciona.

Una vez conectado, puedes pedirle a Claude cosas como: listar tus repositorios e issues abiertas, crear una nueva issue, abrir un pull request, revisar el código de un PR, buscar código por descripción o leer un archivo dentro de un repositorio. En lugar de abrir el navegador y andar haciendo clic por GitHub, escribes una frase y Claude llama a la API de GitHub por ti. Eso es lo que lo diferencia de lanzar comandos gh sueltos: Claude entiende el contexto de toda tu sesión y elige la herramienta correcta por su cuenta.

Un ejemplo real: mientras arreglas un bug, puedes decir "encuentra la issue relacionada con este error de timeout y resume los comentarios", y Claude consultará GitHub, leerá la issue y responderá ahí mismo en la terminal - sin cambiar de ventana. Después de aplicar el parche, sigues con "abre un PR desde la rama actual y haz referencia a esa issue". Toda esa cadena de acciones ocurre en una sola conversación, manteniendo el contexto del código en el que estás trabajando. Por eso muchos devs dejan GitHub MCP conectado como herramienta por defecto, en lugar de activarlo y desactivarlo cada vez.

Antes de empezar (checklist)

Antes de añadir el servidor, haz una comprobación rápida de lo siguiente:

• Claude Code está instalado y funciona en tu terminal - si no, mira cómo instalar Claude Code.
• Una cuenta de GitHub con acceso a los repositorios en los que quieres que trabaje Claude.
• Elige un método de conexión: HTTP remoto (recomendado - rápido, nada que instalar) o Docker (si quieres el servidor corriendo en local en tu máquina). Para la mayoría, con HTTP remoto sobra.
• Si eliges Docker: instala Docker Desktop y tenlo abierto antes de añadir el servidor.

Toda esta guía lleva unos 5 a 10 minutos si vas por la vía del HTTP remoto.

La forma más rápida en 2026: instalar desde el marketplace oficial de plugins

En 2026, Claude Code ya trae un marketplace oficial de plugins integrado. La forma más rápida de poner en marcha GitHub MCP es escribir esto dentro de una sesión:

/plugin install github@claude-plugins-official

El marketplace claude-plugins-official se registra solo la primera vez que abres Claude Code de forma interactiva - si no aparece, añádelo manualmente con /plugin marketplace add anthropics/claude-plugins-official. Este plugin incluye un servidor GitHub MCP preconfigurado, y aun así eliges un alcance (User/Project/Local) que refleja la flag -s del Paso 2 de más abajo. Confirma que se conectó con /mcp o /plugin list --enabled.

⚠️ Aún sin confirmar: si instalar desde el plugin todavía te pide pegar un PAT, o si dispara automáticamente un inicio de sesión por OAuth/device flow - la documentación oficial no lo aclara, y actualizaré esta sección en cuanto lo verifique directamente.

Compensación: más rápido, pero con un control de alcance y permisos menos fino que la vía manual de 4 pasos de abajo - para uso en equipo o en producción, la vía manual sigue siendo la opción por defecto más segura, ya que eliges exactamente los permisos que necesitas.

¿Quieres ver otros plugins y servidores MCP además de GitHub? Mira los mejores plugins y MCP de Claude Code para 2026 (el enlace se activa cuando se publique el artículo).

Paso 1 - Crea un GitHub Personal Access Token (PAT)

GitHub MCP necesita un token para llamar a la API en tu nombre. GitHub tiene dos tipos de token: classic (permisos amplios basados en alcances) y fine-grained (permisos por repositorio). Usa un token fine-grained porque puedes limitarlo justo a los repositorios y permisos que necesitas, lo que minimiza el daño si el token llega a filtrarse:

1. Ve a GitHub -> tu avatar -> Settings.
2. Baja hasta el final del menú de la izquierda y elige Developer settings.
3. Elige Personal access tokens -> Fine-grained tokens -> Generate new token.
4. Ponle un nombre (por ejemplo claude-code-mcp) y define una expiración razonable (30 a 90 días).
5. En Repository access, elige Only select repositories y marca solo los repositorios que quieres que Claude toque.
6. En Permissions -> Repository permissions, concede el mínimo que necesitas: Contents (leer/escribir archivos), Issues y Pull requests. Si trabajas con una organización, añade read:org.
7. Haz clic en Generate token y copia el token de inmediato.

Advertencia de seguridad: GitHub muestra el token solo una vez. Cópialo y guárdalo en un lugar seguro (un gestor de contraseñas). NO hagas commit del token en un repositorio, y no lo pegues en ningún archivo versionado con git. Concede acceso de escritura solo cuando de verdad quieras que Claude cree o edite contenido por su cuenta.

Paso 2 - Añade el servidor GitHub MCP (recomendado: HTTP remoto)

Esta es la forma más rápida y no necesita Docker. Abre una terminal, reemplaza YOUR_PAT por el token que acabas de crear y ejecuta:

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

Si prefieres una configuración en formato JSON (útil cuando quieres tenerla lista para copiar), usa esta alternativa:

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_PAT"}}'

Elige el alcance de la configuración con la flag -s:

• -s local (por defecto): se aplica solo a esta máquina, en el directorio actual.
• -s user: compartido entre todos tus proyectos - útil cuando quieres GitHub MCP siempre disponible y el token fuera de cualquier repositorio.
• -s project: se guarda en .mcp.json y se comparte con todo el equipo a través de git. Cómodo para equipos, pero ten cuidado: nunca dejes que un token real acabe en este archivo.

Por ejemplo, para compartirlo en todos los proyectos, añade -s user al final del comando claude mcp add de arriba. La sintaxis completa de claude mcp add está en la documentación oficial de MCP de Claude Code (actualizada en 2026).

Una nota sobre OAuth: a fecha de 08/2026, el flujo OAuth aún no es totalmente compatible con el GitHub MCP remoto en Claude Code, así que usar un PAT como se muestra arriba es el enfoque más fiable.

Paso 3 (alternativa) - Ejecuta GitHub MCP con Docker (local)

Si quieres el servidor corriendo por completo en tu máquina (por ejemplo, para tener control total o ejecutarlo en un entorno aislado), usa la imagen oficial ghcr.io/github/github-mcp-server. Asegúrate de que Docker Desktop esté abierto y luego ejecuta:

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

¿Cuándo deberías elegir Docker en vez de HTTP remoto? Aquí tienes una comparación rápida:

No uses el paquete npm obsoleto

Este es el error más común. Muchas guías antiguas (en todos los idiomas) todavía te dicen que instales @modelcontextprotocol/server-github con npm. Ese paquete de la comunidad quedó obsoleto allá por 04/2025 - seguirlo lleva a un servidor que no conecta o a errores crípticos. El enfoque correcto en 2026 es HTTP remoto o la imagen Docker oficial del repositorio github/github-mcp-server (la fuente oficial de GitHub, actualizada en 2026).

Paso 4 - Verifica y pruébalo

Después de añadir el servidor, confirma que aparece como "Connected":

claude mcp list

Deberías ver github con estado de conectado. A continuación, abre Claude Code y escribe:

/mcp

El comando /mcp lista todas las herramientas de GitHub disponibles ahora. Ahora prueba unos cuantos prompts reales:

• "Lista mis repositorios de GitHub."
• "Crea una issue en owner/repo con el título: Improve the setup docs."
• "Resume los pull requests abiertos en este repositorio."

Si Claude devuelve los datos correctos y puede crear una issue, ya está todo conectado.

Solución de errores comunes

La mayoría de los problemas de conexión de GitHub MCP se reducen a tres causas: un token equivocado o permisos que faltan, usar por error el método de instalación antiguo, o no reiniciar Claude Code después de añadir el servidor. Si algo va mal, compara tu síntoma con la tabla de abajo:

Consejo general: ante la duda, ejecuta claude mcp remove github y añádelo de nuevo desde cero - eso resuelve la mayoría de los problemas de configuración.

Seguridad y privilegio mínimo (read-only, toolsets)

Dar a un agente acceso de escritura a GitHub es cómodo, pero hay un riesgo real: un prompt vago podría hacer que Claude cree una issue o un PR que no pretendías, y un token filtrado con permisos demasiado amplios afectaría a muchos repositorios. Unas cuantas reglas para ir con seguridad:

• Concede un token mínimo: selecciona solo los repositorios que necesitas y solo los permisos que usas.
• Nunca hagas commit de tokens: prefiere -s user para que el token quede fuera de cualquier repositorio; si tienes que usar -s project, pasa el token mediante una variable de entorno en vez de escribirlo en texto plano.
• Usa read-only cuando solo necesitas leer: el servidor GitHub MCP admite un modo read-only y te deja activar o desactivar toolsets individuales - limítalo para que Claude solo pueda leer, no escribir, cuando solo quieres revisar o consultar algo.
• Ponle una expiración corta al token y revócalo cuando termines.

Siendo honesta: ninguna configuración es perfectamente segura una vez que le entregas acceso de escritura a una IA - mantén el token con un alcance bien ajustado y revisa dos veces las acciones importantes.

Siguiente paso: automatiza tu flujo de git con Claude Code

Una vez que GitHub MCP esté funcionando, el siguiente paso natural es dejar que Claude se encargue de todo el ciclo de vida de un cambio: crear una rama, hacer commit siguiendo un estándar, abrir un PR y revisar. De eso trata automatizar tu flujo de git con Claude Code (el enlace se activa cuando se publique el artículo).

Preguntas frecuentes (FAQ)

¿GitHub MCP es gratis?

El servidor GitHub MCP en sí (tanto el HTTP remoto como la imagen Docker oficial) es gratis. Solo necesitas una cuenta de GitHub y un Personal Access Token. Las acciones siguen contando para los límites normales de peticiones de la API de GitHub de tu cuenta.

¿Hace falta Docker?

No. El método recomendado es el HTTP remoto - solo un comando claude mcp add --transport http, sin Docker. Docker solo hace falta si quieres el servidor corriendo en local en tu máquina.

¿Qué alcances necesita el PAT?

Con un token fine-grained, concede como mínimo Contents, Issues y Pull requests en los repositorios concretos que quieres usar. Añade read:org si trabajas dentro de una organización. No concedas más de lo que necesitas.

¿Cómo elimino el servidor GitHub MCP?

Ejecuta claude mcp remove github. Si el servidor se añadió bajo un alcance distinto, vuelve a especificar ese alcance (por ejemplo -s user) al eliminarlo.

¿En qué se diferencia de la CLI gh?

gh es una herramienta de línea de comandos en la que escribes cada comando manualmente. GitHub MCP deja que Claude llame a la API de GitHub según el contexto de la conversación - haces una petición en lenguaje natural, Claude elige la herramienta y la ejecuta, y puede encadenarla con otros pasos en la misma sesión.

¿Ya funciona OAuth?

A fecha de 08/2026, OAuth aún no es totalmente compatible con el GitHub MCP remoto en Claude Code, así que un PAT sigue siendo la forma fiable y recomendada de conectar.

Conclusión

En solo cuatro pasos - crear un PAT -> añadir el servidor por HTTP remoto -> verificar con claude mcp list y /mcp -> probarlo - le has dado a Claude Code la capacidad de leer y actuar en GitHub mediante lenguaje natural. Los puntos clave: usa HTTP remoto o la imagen Docker oficial, evita el paquete npm obsoleto y mantén tu token con un alcance bien ajustado y fuera de cualquier repositorio. ¿Lo quieres aún más rápido y puedes vivir con menos control de alcance? Vale la pena probar el comando /plugin install github@claude-plugins-official de arriba. Para entender mejor los fundamentos, lee qué es MCP y cómo funciona; para profundizar más en la automatización, mira el flujo de git con Claude Code (enlace cuando esté activo). ¿Necesitas el comando /mcp y otros slash commands? Mira los slash commands en Claude Code.