Servidor MCP de GitHub: instalación, token y trazado de llamadas

Servidor MCP de GitHub: instalación local o remota según el README, toolsets mínimos, modo de solo lectura, token con permisos limitados y trazas.
GitHub MCP server : installation, jeton et traçage des appels

El servidor MCP de GitHub (GitHub MCP server) es el servidor MCP oficial de GitHub: permite a un agente de código leer repositorios, abrir issues, comentar pull requests o inspeccionar workflows de Actions, sin pasar por un script casero. El repositorio github/github-mcp-server cuenta con unas 33 700 estrellas a mediados de octubre de 2026, y es típicamente el servidor MCP que un equipo conecta primero a su agente.

Esta facilidad tiene un precio para la operación. Un agente que puede escribir en tus repositorios con el token de un desarrollador es un actor más en tu cadena de entrega. Esta guía sigue el README y la documentación del proyecto: instalar el servidor, elegir las herramientas expuestas, limitar los permisos del token y conservar un rastro de cada llamada. Para los fundamentos del protocolo, consulta nuestra explicación del Model Context Protocol.

Aclaración de honestidad: span.observer no ha instalado este software para este artículo. Los comandos proceden del README y de la documentación del repositorio, y las capturas siguientes son extractos renderizados a partir de esos archivos.

Servidor MCP de GitHub: lo que dice el repositorio

  • Editor y licencia: GitHub, licencia MIT (archivo LICENSE del repositorio).
  • Lenguaje: Go; el README pide go build para compilar el binario.
  • Cifras releídas el 16 de octubre de 2026 en la página del repositorio: unas 33 700 estrellas, unos 5 200 forks, 1 191 commits en la rama principal. La última release mostrada es la v2.0.2, del 8 de octubre.
  • Dos modos: un servidor local (proceso lanzado por tu cliente MCP, en Docker o como binario) y un servidor remoto alojado por GitHub en la dirección https://api.githubcopilot.com/mcp/. El README precisa que el modo remoto requiere VS Code 1.101 o posterior para el MCP remoto y OAuth.

El servidor no es una aplicación de Dynatrace y no depende de ningún producto de Dynatrace. La parte de observabilidad se aplica tanto a Dynatrace SaaS como a Dynatrace Managed, porque se apoya en OpenTelemetry en el lado del agente.

Recorrido por la configuración

El punto de entrada local es la imagen Docker pública ghcr.io/github/github-mcp-server. El README da su declaración en un cliente MCP, con un token solicitado en tiempo de ejecución en lugar de escrito en el archivo:

Extracto del README de github-mcp-server: configuración JSON de un cliente MCP que lanza la imagen Docker ghcr.io/github/github-mcp-server con la variable GITHUB_PERSONAL_ACCESS_TOKEN leída desde una entrada enmascarada

Línea por línea: -i mantiene abierta la entrada estándar, lo que exige el transporte stdio; --rm elimina el contenedor al terminar; -e GITHUB_PERSONAL_ACCESS_TOKEN transmite la variable sin que aparezca en el comando; la entrada promptString con "password": true pide el token al arrancar.

Instalación paso a paso

Paso 1 — Elegir local o remoto

El modo local mantiene la ejecución en el equipo o en el servidor de compilación, lo que facilita el aislamiento (consulta el aislamiento de un servidor MCP STDIO). El modo remoto evita Docker, pero desplaza la vigilancia al lado del cliente, ya que no tienes ningún proceso que observar.

Paso 2 — Instalar el servidor local

Con Docker en marcha, la documentación de instalación de Claude Code indica este comando para declarar el servidor con un token:

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

Sin Docker, el README propone compilar desde un clon:

go build -o github-mcp-server ./cmd/github-mcp-server
./github-mcp-server stdio

El comando stdio lee GITHUB_PERSONAL_ACCESS_TOKEN del entorno. Comprueba la lista con claude mcp list, como recomienda la guía. Atención: poner el token en claro en el comando lo guarda en la configuración del cliente; es preferible una variable de entorno o la entrada enmascarada del JSON anterior.

Paso 3 — Reducir las herramientas expuestas

Por defecto, el servidor activa los toolsets context, repos, issues, pull_requests y users. El README lista también, entre otros, actions, code_security, dependabot, gists, projects y secret_protection, y un valor especial all. Cada herramienta expuesta consume contexto del agente y amplía su superficie: activa solo lo que la tarea necesita.

Extracto del README de github-mcp-server: líneas de comando con las opciones --toolsets, --tools y --read-only, y comando docker run con las variables GITHUB_PERSONAL_ACCESS_TOKEN y GITHUB_READ_ONLY

La variable GITHUB_TOOLSETS prevalece sobre la opción --toolsets si ambas están presentes. El modo de solo lectura (--read-only o GITHUB_READ_ONLY=1) tiene prioridad: las herramientas de escritura se ignoran aunque se pidan con --tools. La guía de configuración añade --exclude-tools, que prevalece sobre todas las inclusiones.

Autenticación: el token de permisos mínimos

En github.com, el README describe una conexión OAuth en el primer uso, con el token guardado solo en memoria. Un token de acceso personal definido en GITHUB_PERSONAL_ACCESS_TOKEN tiene prioridad sobre OAuth. Para un token clásico, el README sugiere como mínimo repo, read:packages (acceso a la imagen Docker) y read:org (equipos), e invita a conceder solo los permisos que aceptas confiar al agente.

Extracto de docs/scope-filtering.md de github-mcp-server: tabla que compara el filtrado de herramientas según el tipo de autenticación, token clásico, OAuth, token fine-grained y GitHub App

Esta tabla cuenta para la operación: con un token clásico (ghp_), el servidor oculta al arrancar las herramientas para las que el token no tiene los scopes; con un token fine-grained o una GitHub App, no hay ningún filtrado y es la API la que deniega. En este segundo caso, la restricción viene del propio token, no del servidor.

El modo lockdown (--lockdown-mode) limita el contenido de repositorios públicos que llega al agente a los autores con acceso de escritura, para reducir el riesgo de inyección de prompt. El README lo describe como un filtro «best-effort», no como una frontera de autorización. El riesgo de instrucciones ocultas en una issue se detalla en nuestro artículo sobre el envenenamiento de herramientas MCP, y las buenas prácticas generales en cómo proteger un servidor MCP.

Trazar las llamadas del servidor

El README no describe ninguna exportación de trazas ni de métricas por parte del propio servidor. La trazabilidad viene, por tanto, de tres lugares.

  • El cliente del agente. Claude Code, por ejemplo, emite mediante OpenTelemetry un evento claude_code.tool_result con tool_name, success, duration_ms y mcp_server_scope, y atribuye tokens y costes a mcp_server.name y mcp_tool.name. La puesta en marcha se describe en supervisar un agente de código en la empresa. Los parámetros de las herramientas solo se incluyen con OTEL_LOG_TOOL_DETAILS=1: evítalo mientras no controles lo que sale hacia tus logs.
  • Las convenciones de OpenTelemetry para MCP (estado Development): un span de cliente llamado {mcp.method.name} {target}, por ejemplo tools/call get_file_contents, con mcp.method.name y gen_ai.tool.name. El procedimiento está en observar los agentes MCP con OpenTelemetry.
  • En el lado de GitHub. Según el README, las peticiones de API del modo STDIO se identifican como github-mcp-server/<version>, con el nombre y la versión del cliente MCP entre paréntesis. Para distinguir varias instancias (github.com y un GitHub Enterprise Server, por ejemplo), el README documenta GITHUB_MCP_SERVER_NAME y GITHUB_MCP_SERVER_TITLE.

Límites y puntos abiertos

  • Un agente con herramientas de escritura puede modificar repositorios: la barrera de seguridad es el token y la solo lectura, no la cortesía del prompt.
  • El contenido de las issues y de las pull requests es una entrada no fiable; el modo lockdown reduce el riesgo sin suprimirlo.
  • El proyecto avanza rápido: el README señala que el tag v2.0.0 precede a una corrección de la ruta del módulo Go y no puede servir como módulo. Fija la versión de la imagen en lugar de seguir la última.
  • Los nombres de herramientas y de toolsets citados aquí proceden del README del día; compruébalos tras cada actualización.

Cómo comprobar que funciona

  1. claude mcp list muestra el servidor github; tu cliente lista las herramientas esperadas, y solo esas.
  2. Con --read-only, pide al agente que cree una issue: la herramienta de escritura debe estar ausente.
  3. En tu backend de OpenTelemetry (Dynatrace SaaS o Managed, u otro), una llamada a una herramienta aparece con su nombre, su duración y su estado.

Buenas prácticas

  • Empieza en solo lectura con los toolsets repos e issues, y amplía según la necesidad.
  • Usa un token dedicado, de vida corta, nunca el de un administrador.
  • Registra las llamadas de escritura y revísalas tras cada incidente, sin buscar culpables.
  • Mantén el token fuera de los argumentos de las herramientas y de las trazas.

Preguntas frecuentes

¿Conviene el servidor local o el remoto?

El local da más control (aislamiento, versión fijada); el remoto evita Docker pero deja que GitHub aloje el servidor. La elección depende de tu política de ejecución.

¿Qué permisos mínimos necesita un token?

El README sugiere repo, read:packages y read:org para un token clásico. Redúcelos si no usas ni la imagen Docker ni los equipos.

¿Envía el servidor trazas de OpenTelemetry por sí mismo?

El README no las describe. Traza en el lado del cliente del agente, o consulta nuestra guía del servidor Chrome DevTools MCP para otro servidor de la misma serie.

Conclusión

El servidor MCP de GitHub merece la pena: oficial, con licencia MIT, bien documentado. Su buen uso se resume en cuatro ajustes: local o remoto, toolsets mínimos, token limitado, solo lectura por defecto. Queda trazar cada llamada en el lado del cliente para poder responder a «quién hizo qué, y cuándo». Fuentes: repositorio github/github-mcp-server.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
NVIDIA OpenShell runtime agents IA : isoler et auditer

NVIDIA OpenShell runtime para agentes de IA: aislar y auditar

Next Post
Chrome DevTools MCP : perf web et débogage par un agent de code

Chrome DevTools MCP: rendimiento web y depuración con un agente de código

Related Posts