Velocity

npx add-mcp 'https://velocity.quest/api/mcp'

Servidor MCP

Conecta agentes de IA a Velocity mediante el Protocolo de Contexto de Modelos.

¿Qué es MCP?

El Protocolo de Contexto de Modelos (MCP) es un estándar abierto que permite a los agentes de IA interactuar con herramientas externas a través de una interfaz unificada. Velocity incluye un servidor MCP integrado con 84 herramientas para seguimiento de incidencias, PRDs e historias de usuario, contexto de proyectos, eventos de espacio de trabajo, gestión de espacios de trabajo y usuarios, planificación de hojas de ruta, dominios personalizados, coordinación de agentes Claude y más.

Agentes de IA como Claude Code, Claude Desktop, Codex, Cursor y otros clientes compatibles con MCP pueden conectarse a Velocity y crear incidencias, buscar tareas, actualizar estados, gestionar proyectos, planificar hojas de ruta y configurar dominios, todo sin salir de su flujo de trabajo.

Disponibilidad y acceso

MCP está disponible para miembros actuales de espacios de trabajo en los planes Pro, Business o Enterprise. Los espacios de trabajo gratuitos no pueden usar MCP. Conéctate mediante OAuth del navegador o un token de conexión del espacio de trabajo desde Configuración → MCP. Las claves API personales no pueden autenticar MCP. Consulta configuración y solución de problemas.

La respuesta tools/list del servidor conectado es el catálogo actual de herramientas y esquemas de entrada. Una herramienta listada puede requerir alcance de escritura, rol de propietario/administrador, una habilitación de funcionalidad, configuración de integración o una concesión de trabajador gestionado. El acceso a la herramienta por sí solo no inicia un trabajador ni garantiza codificación autónoma, revisión, fusión o despliegue.

Casos de uso

• Asistentes de codificación con IA — crea informes de errores directamente desde revisiones de código
• Triaje automatizado — los agentes categorizan y priorizan incidencias entrantes
• Actualizaciones de estado — los agentes actualizan el progreso de incidencias a medida que completan trabajo
• Búsqueda y contexto — los agentes encuentran incidencias relacionadas para informar su trabajo
• Gestión de proyectos — los agentes leen proyectos, ciclos e hitos
• Planificación de hojas de ruta — los agentes gestionan elementos de hoja de ruta, versiones y votaciones
• Gestión de dominios — los agentes añaden y verifican dominios personalizados
• Coordinación de agentes de IA — los trabajadores configurados procesan incidencias, vinculan commits y rastrean el progreso del sprint

Herramientas disponibles

Estas tablas son herramientas seleccionadas. La referencia de herramientas también cubre planificación de PRD e historias, adjuntos privados, eventos de espacio de trabajo, monitoreo de incidencias/verificaciones y perfiles de entrega. MCP actualmente lee el contexto de proyectos/ciclos; usa la API GraphQL para crear proyectos, ciclos o hitos de proyecto.

PRDs e historias de usuario

Lee y edita PRDs, requisitos e historias; divide historias, vincula incidencias y crea incidencias a partir de propuestas de historias revisadas. Las herramientas de propuestas con IA requieren mcp:write, la habilitación de plan de IA correspondiente y créditos disponibles. Las propuestas requieren acciones separadas de revisión y guardado; la aprobación humana de PRD permanece en Velocity. Consulta De la idea a las incidencias.

Seguimiento de incidencias

Herramienta	Alcance	Descripción
list_issues	lectura	Lista incidencias con filtros por proyecto, estado, prioridad, asignado, etiqueta
get_issue	lectura	Obtiene detalles completos de una incidencia por ID o identificador (p. ej., ENG-123)
create_issue	escritura	Crea una nueva incidencia con título, descripción, prioridad, estado
update_issue	escritura	Actualiza los campos de una incidencia existente
search_issues	lectura	Búsqueda de texto completo en títulos y descripciones de incidencias
add_comment	escritura	Añade un comentario a una incidencia
list_comments	lectura	Lista todos los comentarios de una incidencia

Proyectos y ciclos

Herramienta	Alcance	Descripción
list_projects	lectura	Lista todos los proyectos con filtro opcional de estado
get_project	lectura	Obtiene detalles del proyecto, incluidos hitos y recuento de incidencias
list_cycles	lectura	Lista ciclos de sprint con filtro opcional de estado
get_cycle	lectura	Obtiene detalles del ciclo con recuentos de incidencias y progreso

Metadatos del espacio de trabajo

Herramienta	Alcance	Descripción
list_teams	lectura	Lista todos los equipos del espacio de trabajo
list_labels	lectura	Lista todas las etiquetas disponibles
list_statuses	lectura	Lista todos los estados de incidencias entre equipos
list_members	lectura	Lista miembros del espacio de trabajo con roles

Hoja de ruta

Herramienta	Alcance	Descripción
list_roadmap_items	lectura	Lista elementos de hoja de ruta con filtros de estado, categoría y versión
create_roadmap_item	escritura	Crea un nuevo elemento de hoja de ruta
update_roadmap_item	escritura	Actualiza un elemento de hoja de ruta existente
delete_roadmap_item	escritura	Elimina un elemento de hoja de ruta
vote_roadmap_item	escritura	Alterna la votación en un elemento de hoja de ruta
list_roadmap_versions	lectura	Lista todas las versiones de hoja de ruta (lanzamientos)
create_roadmap_version	escritura	Crea una nueva versión de hoja de ruta
get_roadmap_settings	lectura	Obtiene la visibilidad de la hoja de ruta y la configuración de votación
update_roadmap_settings	escritura	Actualiza la configuración de la hoja de ruta

Espacio de trabajo y usuario

Herramienta	Alcance	Descripción
list_workspaces	lectura	Lista espacios de trabajo del usuario; OAuth devuelve solo el espacio de trabajo conectado
create_workspace	escritura	Crea un nuevo espacio de trabajo (el usuario se convierte en propietario)
delete_workspace	escritura	Elimina permanentemente un espacio de trabajo (solo propietario)
get_workspace	lectura	Obtiene detalles del espacio de trabajo actual (nombre, plan, recuento de miembros)
update_workspace	escritura	Actualiza el nombre del espacio de trabajo (la descripción no es compatible)
get_current_user	lectura	Obtiene el perfil del usuario autenticado
update_current_user	escritura	Actualiza el nombre para mostrar o el avatar del usuario
list_user_api_keys	lectura	Lista claves API personales (prefijo velu_)
create_user_api_key	escritura	Crea una clave API personal (devuelve la clave una sola vez)
revoke_user_api_key	escritura	Revoca una clave API personal

Dominios personalizados

Herramienta	Alcance	Descripción
list_domains	lectura	Lista dominios personalizados con estado de verificación
add_domain	escritura	Añade un dominio personalizado con instrucciones de configuración de DNS
verify_domain	escritura	Verifica el estado de verificación del dominio
remove_domain	escritura	Elimina un dominio personalizado

Flujo de trabajo del agente

Herramienta	Alcance	Descripción
transition_issue	escritura	Mueve la incidencia a un estado por nombre (p. ej., "En progreso") en lugar de UUID
get_my_issues	lectura	Obtiene incidencias asignadas al usuario autenticado, filtradas por grupo de estado
get_active_sprint	lectura	Obtiene el ciclo activo con recuentos de incidencias y progreso
link_commit	escritura	Registra un SHA de commit contra una incidencia
link_pr	escritura	Registra una URL de solicitud de extracción contra una incidencia
get_issue_context	lectura	Contexto enriquecido de incidencia: comentarios, actividades, etiquetas, eventos vinculados
get_pending_agent_runs	lectura	Obtiene ejecuciones pendientes de API o Claude Code para un trabajador local
update_agent_run	escritura	Actualiza el estado, los tokens y el resultado de una ejecución de agente

Recursos

El servidor MCP también expone estos recursos de solo lectura para contexto rápido:

URI	Descripción
velocity://workspace	Metadatos del espacio de trabajo (nombre, slug, plan, recuentos de miembros/equipos)
velocity://issues	Incidencias recientes (últimas 20, ordenadas por tiempo de actualización)
velocity://projects	Todos los proyectos con estado y progreso
velocity://roadmap	Elementos de hoja de ruta, versiones y descripción general de configuración
velocity://domains	Dominios personalizados con estado de verificación

Limitaciones de credenciales

Las conexiones OAuth no pueden listar, crear o revocar claves API personales, incluso cuando esas herramientas aparecen en el catálogo. Gestiona las claves en la configuración de Velocity o usa un token de conexión para estas herramientas. Los tokens de conexión tienen capacidades de cuenta más amplias; mantenlos privados y revoca conexiones no utilizadas.

Ámbitos

Las concesiones OAuth de MCP usan estos ámbitos. Los tokens de conexión de Configuración → MCP incluyen ambos:

• mcp:read — Herramientas y recursos de lectura, sujetos a restricciones de credenciales y funcionalidades
• mcp:write — Herramientas de escritura, sujetas a verificaciones de políticas de rol, funcionalidad y trabajador (solicitar con mcp:read)

Próximos pasos

• Configuración y autenticación — inicia sesión o crea un token de conexión y configura tu cliente
• Referencia de herramientas — documentación detallada de parámetros para cada herramienta