Inicio Rápido

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

Pon en marcha el GitScrum MCP Server en menos de 5 minutos. Al final de esta guía, tu asistente de IA tendrá acceso completo a tus workspaces, proyectos, tareas, sprints y más de GitScrum.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

Si no tienes Node.js instalado, descárgalo desde nodejs.org. Se recomienda la versión LTS.

Instalación

Opción 1: Ejecutar con npx (recomendado)

No se necesita instalación. El servidor MCP se ejecuta directamente a través de npx, que descarga y ejecuta la última versión automáticamente:

npx -y @gitscrum-studio/mcp-server

Este es el enfoque recomendado porque:

• Siempre usa la última versión
• No hay paquetes globales que mantener
• No se requieren actualizaciones manuales
• Funciona inmediatamente en todos los sistemas operativos

Opción 2: Instalación global

Si prefieres una instalación persistente:

npm install -g @gitscrum-studio/mcp-server

Después de la instalación global, el binario del servidor está disponible como gitscrum-mcp-server en tu PATH. Para actualizar después:

npm update -g @gitscrum-studio/mcp-server

Configura tu cliente

Elige tu cliente de IA y agrega el GitScrum MCP Server a su configuración.

Claude Desktop

Localiza el archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

Si el archivo no existe, créalo. Agrega la siguiente configuración:

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Si ya tienes otros servidores MCP configurados, agrega la entrada "gitscrum" dentro del objeto "mcpServers" existente:

{
  "mcpServers": {
    "existing-server": { ... },
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Reinicia Claude Desktop después de guardar el archivo de configuración. Las herramientas de GitScrum aparecen en la lista de herramientas de Claude automáticamente.

VS Code con GitHub Copilot

Crea o edita .vscode/mcp.json en la raíz de tu proyecto:

{
  "servers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Esta configuración se aplica al workspace actual. Para acceso global en todos los proyectos, agrégalo a la configuración de usuario de VS Code.

Después de guardar, GitHub Copilot detecta el servidor MCP automáticamente. Puedes verificar abriendo el chat de Copilot y preguntando sobre tu workspace de GitScrum.

Cursor

Abre la Configuración de Cursor y navega a la sección MCP, o edita el archivo de configuración directamente:

• macOS: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Reinicia Cursor después de guardar. Las herramientas de GitScrum aparecen en el listado de herramientas de Cursor.

Windsurf

Agrega lo siguiente a tu configuración MCP de Windsurf:

{
  "mcpServers": {
    "gitscrum": {
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  }
}

Continue (VS Code / JetBrains)

Agrega GitScrum a tu archivo de configuración de Continue (~/.continue/config.json):

{
  "mcpServers": [
    {
      "name": "gitscrum",
      "command": "npx",
      "args": ["-y", "@gitscrum-studio/mcp-server"]
    }
  ]
}

Autenticación

La primera vez que interactúes con el GitScrum MCP Server, necesitas autenticarte. El servidor usa OAuth 2.0 Device Authorization Grant — un flujo seguro basado en navegador.

Paso a paso

1. Dile a tu asistente de IA que inicie sesión. Escribe algo como:

`` Inicia sesión en GitScrum ``

1. El asistente de IA llama a auth_login y devuelve una URL de verificación y un código de usuario. Verás un mensaje como:

`` Abre esta URL en tu navegador: https://gitscrum.com/device Ingresa el código: ABCD-1234 ``

1. Abre la URL en tu navegador e ingresa el código mostrado. Inicia sesión en tu cuenta de GitScrum si se te solicita, luego aprueba la solicitud de acceso.

1. Dile a tu asistente de IA que complete la autenticación:

`` Completa el login de GitScrum ``

1. La IA llama a auth_complete y confirma que tu sesión está activa. Tu token de autenticación se almacena localmente en ~/.gitscrum/auth.json.

A partir de este momento, el servidor MCP se autentica automáticamente. Los tokens se renuevan en segundo plano, así que no necesitarás iniciar sesión de nuevo a menos que cierres sesión explícitamente o el token expire.

Verificar tu sesión

En cualquier momento, pregunta a tu asistente de IA:

Verifica el estado de autenticación de GitScrum

La herramienta auth_status devuelve el estado actual de tu sesión, incluyendo el usuario autenticado y el acceso al workspace.

Tus primeros comandos

Ahora que estás autenticado, prueba estos comandos para explorar lo que el servidor MCP puede hacer:

Explora tu workspace

Lista mis workspaces de GitScrum

Devuelve todos los workspaces a los que tienes acceso, con sus slugs y detalles.

Ver tus tareas

Muéstrame mis tareas para hoy

Obtiene las tareas asignadas a ti que están programadas para hoy, en todos los proyectos.

Obtener resumen del proyecto

Muéstrame los proyectos en mi workspace

Lista todos los proyectos en tu workspace actual con estadísticas y miembros del equipo.

Crear una tarea

Crea una tarea llamada "Actualizar documentación de API" en el proyecto Backend con alta prioridad

Crea una nueva tarea con el título, proyecto y prioridad especificados.

Verificar progreso del sprint

¿Cómo va el sprint actual?

Devuelve KPIs del sprint, métricas de progreso y datos de burndown del sprint activo.

Iniciar un temporizador

Inicia el seguimiento de tiempo en la tarea PROJ-42

Comienza una sesión de seguimiento de tiempo en la tarea especificada.

Obtener resumen de standup

¿Qué completó el equipo ayer?

Genera un resumen de standup con trabajo completado, bloqueadores y actividad de los contribuyentes.

Qué está disponible

Aquí hay una referencia rápida de lo que puedes hacer a través del servidor MCP:

Solución de problemas

"Command not found" o npx falla

Verifica que Node.js esté instalado y sea versión 18+:

node --version

Si la versión es inferior a 18, actualiza Node.js desde nodejs.org.

El servidor MCP no aparece en el cliente

• Claude Desktop: Reinicia la aplicación después de editar el archivo de configuración. Verifica que la sintaxis JSON sea válida.
• VS Code: Asegúrate de que el archivo .vscode/mcp.json esté en la raíz del workspace. Recarga la ventana (Ctrl+Shift+P → "Reload Window").
• Cursor: Reinicia Cursor después de editar el archivo de configuración.

La autenticación falla

• Asegúrate de abrir la URL de verificación correcta en un navegador donde tengas sesión iniciada en GitScrum.
• Ingresa el código exactamente como se muestra (incluyendo el guión).
• Completa el flujo del navegador dentro de 15 minutos — los códigos de dispositivo expiran.
• Si el código expiró, ejecuta auth_login de nuevo para obtener un nuevo código.

Errores "Unauthorized" después de la autenticación

Tu token puede haber expirado. Pregunta a tu asistente de IA:

Cierra sesión de GitScrum y vuelve a iniciar sesión

Esto limpia el token almacenado e inicia un nuevo flujo de autenticación.

Limitación de tasa

Si recibes errores 429, el servidor está siendo limitado por tasa. Espera unos minutos antes de hacer solicitudes adicionales. Los límites de tasa se restablecen automáticamente.

Próximos pasos

• Configuración: Configuración avanzada para todos los clientes, Docker, variables de entorno y argumentos personalizados.
• Autenticación: Profundización en el flujo OAuth 2.0 Device Grant, gestión de tokens y seguridad.
• Seguridad: Modelo de seguridad empresarial, restricciones de operación y mejores prácticas.
• Descripción General de MCP: Referencia completa de herramientas con las 29 herramientas y más de 160 operaciones.