Level 1· Lektion 10 von 13

Git para IA 3, el servidor GitHub MCP

Cómo darle a Claude acceso directo a tu GitHub. Issues, pull requests, workflows, todo por voz.

De qué va esto

Hasta ahora has usado Git como red de seguridad. Haces save states, creas branches, dejas que Claude Code construya dentro del editor.

Esta lección es el siguiente paso. Le das a Claude acceso directo a tu GitHub. Claude entonces puede leer issues, abrir pull requests por ti, mirar por qué tu última pipeline de CI fue roja, o revisar avisos de Dependabot.

Esto funciona a través del GitHub MCP Server. Es una herramienta oficial de GitHub, gratis, bien mantenida.

Qué es MCP, en pocas palabras

MCP significa Model Context Protocol. Es un estándar abierto que permite a herramientas de IA como Claude Code hablar con otros servicios. En vez de que Claude tenga que adivinar qué hay en tu GitHub, le pregunta a un servidor MCP que responde con datos reales.

No necesitas entender MCP en detalle para usarlo. Piensa en ello como un puerto USB. GitHub provee el conector, Claude lo acepta, listo.

Lo que hace el GitHub MCP Server (lista oficial de github/github-mcp-server):

Navegar repos, buscar código, leer commits
Crear, comentar, cerrar issues
Crear, revisar, fusionar pull requests
Disparar y leer pipelines de GitHub Actions
Recorrer alertas de Dependabot y hallazgos de seguridad
Notificaciones, discussions, gists, projects, labels, stargazers, users

19 toolsets en total. Los más importantes para empezar son repositories, issues, pull_requests, actions y code_security.

Por qué esto es realmente útil

Tres ejemplos concretos que dejan el valor claro.

Ejemplo 1: issue como tarea. Alguien abrió un issue en tu repo: "El login no funciona en Safari". Le dices a Claude: "Lee el issue 42 de mi repo y propón una implementación." Claude lee el issue, mira el código vinculado, escribe un plan. Tú haces los cambios, Claude abre al final un pull request con una descripción que cierra el issue.

Ejemplo 2: depurar CI sin navegador. Tu pipeline está roja. En vez de cambiar a github.com y bucear en logs, le dices a Claude: "¿Qué falló en la última ejecución del workflow de main?" Claude lee los logs, te da el error exacto, sugiere un fix.

Ejemplo 3: barrida de seguridad. "¿Qué alertas de Dependabot están abiertas en mis repos, y cuáles son críticas?" Claude las recorre, las ordena por severidad, te dice por dónde empezar. Te ahorra el scroll manual por cada repo.

Crear un personal access token

Antes de instalar el servidor necesitas un Personal Access Token (PAT). Es una llave que permite a Claude actuar como tú en GitHub.

Importante: dale los menos permisos posibles. Si solo quieres leer, dale solo permisos de lectura.

En github.com loguéate, arriba a la derecha click en tu avatar, "Settings", abajo a la izquierda "Developer settings", "Personal access tokens", "Tokens (classic)", "Generate new token".

Ajusta estos valores:

Note: "Claude MCP Server" (para que sepas después para qué era el token)
Expiration: 90 días (NO "no expiration")
Scopes: mínimo repo y read:org. Si además quieres gestionar workflows añade workflow.

Click en "Generate token". GitHub te muestra una cadena larga que empieza con ghp_. Cópiala AHORA, GitHub no te la va a mostrar otra vez. Métela en un gestor de contraseñas.

Instalar en Claude Code

Necesitas Claude Code instalado como CLI. En tu terminal:

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

Esa es la sintaxis oficial de la documentación de Claude Code (code.claude.com/docs/en/mcp). Reemplaza ghp_TU_TOKEN_AQUI con el token que copiaste arriba.

Eso es todo. Reinicia Claude Code, pregunta "list my repositories" o "what issues are open in MI-REPO", recibes datos reales.

Nota sobre la URL: el servidor hosted vive en api.githubcopilot.com/mcp. Funciona aunque no tengas suscripción a GitHub Copilot. El nombre confunde, pero el endpoint MCP es gratis con cualquier cuenta de GitHub.

Instalar en Claude Desktop

A fecha de 2026, Claude Desktop todavía no soporta la variante hosted vía OAuth. Necesitas la variante local con Docker.

Requisito: Docker Desktop instalado (gratis en docker.com). Si no has usado Docker nunca, ese es un tema aparte. Para empezar, ir vía Claude Code es suficiente.

Si Docker está instalado, abre el archivo de configuración de Claude Desktop:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Añade esto (o extiende la sección mcpServers si ya hay otros servidores ahí):

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_TU_TOKEN_AQUI"
      }
    }
  }
}

Reinicia Claude Desktop. En la lista de herramientas deberías ver "github" ahora.

Notas de seguridad

Tres cosas a recordar.

Primero: el PAT es como una contraseña. No lo pegues en Slack, no lo commitees, no lo enseñes en capturas de pantalla. Si el token se filtra, revócalo inmediatamente en github.com y genera uno nuevo.

Segundo: mantén los scopes mínimos. Si solo quieres leer issues, no des repo (acceso completo) sino public_repo o un fine-grained token con solo lectura sobre repos específicos.

Tercero: los fine-grained personal access tokens son mejores que los classic tokens, porque son configurables por repo y expiran automáticamente. Hay una pestaña "Fine-grained tokens" en la página de tokens, esa es la mejor opción una vez que estés cómodo con lo básico.

Qué te ahorras ahora

Sin el GitHub MCP Server, el flujo típico de principiante es un cambio constante de contexto entre editor, navegador, terminal. Lee issue en navegador, cambia a editor, vuelve para abrir el pull request, tercera pestaña para CI.

Con el MCP Server eso se va. Claude puede hacer todo eso desde la conversación, tú te quedas enfocado en lo que realmente quieres construir.

El efecto psicológico es mayor de lo que la gente espera. Conozco gente que solo después de MCP sintió que Claude es un compañero de equipo de verdad, no solo un ayudante que escribe rápido.

Qué puedes hacer ahora

Entender a grandes rasgos qué es MCP y para qué sirve el GitHub MCP Server
Crear un personal access token con scopes mínimos
Configurar el GitHub MCP Server en Claude Code o Claude Desktop
Tres flujos concretos que van notablemente mejor con MCP
Las notas de seguridad más importantes alrededor de los PATs

Con esto termina el mini-módulo "Git para IA". Ahora tienes la red de seguridad, la rutina y el tooling profesional. No necesitas más como operator. Si quieres ir más profundo, mira el Nivel 4 sobre sistemas de memoria. Con memory más Git más GitHub MCP tienes el stack core que los pros realmente usan en 2026.

Estás leyendo sin cuenta. Login guarda tu progreso para que retomes donde lo dejaste. Iniciar sesión →

← Git para IA 2, branches y revi Panorama de modelos 2026: qué →