Descripción General de MCP
GitScrum MCP Server proporciona a los asistentes de IA acceso operacional completo a tu stack de gestión de proyectos a través del Model Context Protocol.
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.
GitScrum MCP Server conecta asistentes de IA a tu workspace de GitScrum a través del Model Context Protocol. Expone 29 herramientas con más de 160 operaciones en 6 categorías, dándole a tu asistente de IA las mismas capacidades operacionales que tu equipo usa diariamente en la aplicación web de GitScrum — gestión de tareas, planificación de sprints, seguimiento de tiempo, CRM, analíticas y más.
Todo lo que tu equipo hace en la aplicación web de GitScrum, tu asistente de IA ahora puede hacerlo a través de conversación en lenguaje natural.
¿Qué es el Model Context Protocol?
El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA interactuar con herramientas externas y fuentes de datos de forma estructurada y segura. En lugar de copiar y pegar datos entre tu herramienta de gestión de proyectos y tu asistente de IA, MCP crea un puente directo.
Con el GitScrum MCP Server en funcionamiento, tu asistente de IA puede:
- Consultar tus workspaces, proyectos y tareas en tiempo real
- Crear y actualizar tareas, sprints, historias de usuario y épicas
- Registrar tiempo, generar informes de standup y revisar analíticas
- Gestionar clientes, facturas y propuestas a través de ClientFlow CRM
- Buscar en todo tu stack de gestión de proyectos
Todo esto sucede a través de lenguaje natural. Le haces una pregunta o le das una instrucción a tu asistente de IA, y este llama a las herramientas apropiadas de GitScrum MCP en segundo plano.
Por qué usar MCP para la gestión de proyectos
La gestión de proyectos tradicional requiere un cambio constante de contexto — abrir pestañas del navegador, navegar por dashboards, rellenar formularios. MCP elimina esa fricción al permitir que tu asistente de IA maneje el trabajo operacional mientras tú te concentras en lo que importa.
Operaciones en lenguaje natural. En lugar de navegar por menús para crear una tarea, di "Crea un bug de alta prioridad en el proyecto Auth para el problema de timeout en login" y el asistente de IA se encarga del mapeo de campos, selección de proyecto y creación de la tarea.
Inteligencia entre herramientas. Tu asistente de IA puede correlacionar datos entre herramientas. Pregunta "¿Qué proyectos están por encima del presupuesto y tienen tareas atrasadas?" y consultará seguimiento de presupuesto, filtros de tareas y datos de sprint en una sola conversación.
Automatización sin scripts. Flujos de trabajo complejos que requerirían scripts de API se convierten en conversacionales. "Crea un sprint para la próxima semana, agrega los 5 elementos principales del backlog y asígnalos al equipo de frontend" ejecuta múltiples operaciones secuencialmente.
Visibilidad para todo el equipo. Cualquier miembro del equipo con un cliente compatible con MCP puede interactuar con los mismos datos del proyecto. Desarrolladores, gerentes y stakeholders se benefician del acceso conversacional al stack de gestión de proyectos.
Categorías de herramientas
El GitScrum MCP Server organiza sus 29 herramientas en seis categorías. Cada herramienta usa un parámetro consolidado action, reduciendo los tokens de contexto del LLM en aproximadamente un 80% comparado con definiciones de herramientas individuales.
Core
Las herramientas fundamentales para las operaciones diarias de gestión de proyectos.
| Herramienta | Acciones clave | Propósito |
|---|---|---|
task | my today get create update complete subtasks filter by_code duplicate move notifications | Gestión completa del ciclo de vida de tareas |
sprint | list all get kpis create update stats reports progress metrics | Planificación y seguimiento de sprints |
workspace | list get | Navegación de workspaces |
project | list get stats tasks workflows types efforts labels members | Configuración y datos del proyecto |
time | active start stop logs analytics team reports productivity timeline | Seguimiento de tiempo y productividad |
Planificación
Herramientas para gestión del backlog, mapeo de historias y configuración de flujos de trabajo.
| Herramienta | Acciones clave | Propósito |
|---|---|---|
user_story | list get create update all | Gestión de historias de usuario |
epic | list create update | Planificación a nivel de épicas |
label | list create update attach detach toggle | Taxonomía de etiquetas |
task_type | list create update assign | Configuración de tipos de tarea |
workflow | create update | Etapas del flujo Kanban |
Colaboración
Herramientas para comunicación del equipo, documentación y gestión del conocimiento.
| Herramienta | Acciones clave | Propósito |
|---|---|---|
discussion | all channels channel messages send search unread markread createchannel update_channel | Mensajería y canales del equipo |
comment | list add update | Comentarios en tareas y elementos |
wiki | list get create update search | Documentación del proyecto |
note | list get create update share revisions | Notas personales y compartidas |
note_folder | list create update move | Organización de notas |
search | — | Búsqueda de texto completo en todos los datos |
ClientFlow CRM
Herramientas de gestión de relaciones con clientes, facturación y propuestas.
| Herramienta | Acciones clave | Propósito |
|---|---|---|
client | list get create update contacts interactions add_interaction | Gestión de clientes |
invoice | list get stats create update issue send mark_paid | Ciclo de vida de facturas |
proposal | list get stats create update send approve reject convert | Gestión de propuestas |
clientflow_dashboard | 8 informes | Analíticas y reportes de CRM |
clientflowcrossworkspace | 4 informes | Datos CRM entre workspaces |
Insights PRO
Analíticas avanzadas, automatización de standups y monitoreo de presupuesto.
| Herramienta | Acciones clave | Propósito |
|---|---|---|
standup | summary completed blockers team stuck digest contributors | Informes automatizados de standup |
analytics | 10 informes | Analíticas del dashboard del manager |
activity | feed userfeed notifications activities taskworkflow | Feed de actividad y pista de auditoría |
budget | projectsatrisk overview consumption burn_down alerts events | Seguimiento y alertas de presupuesto |
Autenticación
Herramientas de gestión segura de sesiones.
| Herramienta | Descripción |
|---|---|
auth_login | Iniciar flujo OAuth 2.0 device code |
auth_complete | Completar autorización basada en navegador |
auth_status | Verificar sesión actual y validez del token |
auth_logout | Limpiar credenciales almacenadas localmente |
Clientes compatibles
El GitScrum MCP Server funciona con cualquier cliente que implemente el Model Context Protocol. Clientes probados y verificados:
| Cliente | Plataforma | Configuración |
|---|---|---|
| Claude Desktop | macOS, Windows | claudedesktopconfig.json |
| GitHub Copilot | VS Code | .vscode/mcp.json |
| Cursor | macOS, Windows, Linux | Configuración MCP de Cursor |
| Windsurf | macOS, Windows, Linux | Configuración MCP de Windsurf |
| Continue | VS Code, JetBrains | Configuración de Continue |
Todos los clientes usan el mismo binario del MCP Server. La única diferencia es la ubicación y formato del archivo de configuración de cada cliente.
Modelo de seguridad
El GitScrum MCP Server está diseñado con el principio de mínimo privilegio con múltiples capas de protección.
| Capa | Protección |
|---|---|
| Operaciones | Solo CREATE, READ, UPDATE. DELETE está bloqueado tanto en la capa MCP como en la API. |
| Autenticación | OAuth 2.0 Device Grant (RFC 8628) — las credenciales nunca tocan el servidor MCP. |
| Transporte | Comunicación solo HTTPS con TLS 1.2 mínimo. |
| Almacenamiento de tokens | Sistema de archivos local (~/.gitscrum/auth.json) con permisos restringidos. |
| Limitación de tasa | Bloqueo automático tras intentos fallidos de autenticación. |
Sin operaciones DELETE. Esta es una decisión de diseño deliberada. Los asistentes de IA no deberían poder destruir permanentemente datos del proyecto. Todas las operaciones destructivas deben realizarse a través de la aplicación web GitScrum Studio, donde se requiere confirmación humana.
Ejemplos de conversaciones
Aquí hay ejemplos prácticos de lo que puedes lograr a través de lenguaje natural:
Tú: "¿Qué tengo pendiente hoy?"
IA: Obtiene tus tareas programadas para hoy en todos los proyectos.
Tú: "Crea un sprint para la próxima semana con los 5 principales elementos del backlog"
IA: Crea el sprint, asigna las tareas y establece la línea de tiempo.
Tú: "Muéstrame qué proyectos están por encima del presupuesto"
IA: Devuelve datos de burn-down y señala proyectos en riesgo.
Tú: "Envía la propuesta Q1 a Acme Corp"
IA: Crea la propuesta, adjunta el cliente y la envía.
Tú: "¿Qué entregó el equipo esta semana?"
IA: Genera un resumen de standup con trabajo completado y bloqueadores.Arquitectura
El MCP Server se ejecuta como un proceso local en tu máquina. Se comunica con los clientes de IA a través del Model Context Protocol (transporte stdio) y con la API de GitScrum a través de HTTPS.
┌────────────────┐ MCP (stdio) ┌──────────────┐ HTTPS ┌─────────────┐
│ Asistente IA │ ◄──────────────────► │ MCP Server │ ◄───────────► │ GitScrum API │
│ (Claude, etc) │ │ (local) │ │ (cloud) │
└────────────────┘ └──────────────┘ └─────────────┘- Asistente IA envía llamadas a herramientas a través del protocolo MCP
- MCP Server valida solicitudes, gestiona la autenticación y reenvía a la API de GitScrum
- API de GitScrum procesa la solicitud con control de acceso completo y devuelve datos estructurados
El servidor es stateless entre sesiones excepto por el token de autenticación almacenado localmente. Ningún dato del proyecto se almacena en caché o se guarda en disco.
Requisitos
| Requisito | Mínimo |
|---|---|
| Node.js | 18.0.0 o superior |
| npm | 8.0.0 o superior |
| Cuenta de GitScrum | Plan gratuito o de pago |
| Cliente MCP | Cualquier cliente compatible con MCP |
Próximos pasos
- Inicio Rápido: Instala y autentícate en menos de 5 minutos.
- Configuración: Configuración detallada para Claude Desktop, GitHub Copilot, Cursor y otros clientes.
- Autenticación: Profundización en el flujo OAuth 2.0 Device Grant.
- Seguridad: Modelo de seguridad empresarial, manejo de errores y mejores prácticas.