Proyectos y miembros
Listar proyectos, revisar la actividad y las versiones, inspeccionar módulos y gestionar la pertenencia al proyecto cuando el usuario tenga permiso.
Cómo funciona
Ofrezca a los clientes de IA un acceso controlado a Redmine
Model Context Protocol es un estándar abierto que permite a los clientes de IA usar herramientas de sistemas externos a través de una interfaz común. Redmine MCP proporciona esa interfaz directamente desde Redmine, sin un servicio de integración independiente.
- 60+
- herramientas integradas
- GPL v2+
- licencia de código abierto
- 6.0–7.0
- versiones de Redmine compatibles
Qué pueden hacer los clientes a través de Redmine MCP
El servidor expone herramientas MCP específicas en lugar de un acceso irrestricto a la base de datos. Las herramientas disponibles dependen de los permisos del usuario, el acceso a proyectos y las extensiones habilitadas.
Peticiones y comentarios
Buscar, crear y actualizar peticiones, añadir notas y adjuntos, trabajar con relaciones, subtareas, seguidores y categorías.
Búsqueda y consultas guardadas
Buscar peticiones y páginas Wiki, filtrar listas de peticiones y ejecutar consultas guardadas de Redmine sin reconstruir los filtros en el cliente.
Seguimiento del tiempo
Leer, crear y actualizar entradas de tiempo, inspeccionar tipos de actividad e importar varias entradas en una operación.
Wiki y foros
Leer, crear y actualizar páginas Wiki del proyecto; explorar foros, temas e hilos de mensajes.
Archivos y adjuntos
Listar archivos del proyecto, cargar archivos y adjuntos, inspeccionar metadatos de adjuntos y descargar adjuntos admitidos dentro de los límites documentados.
Primeros pasos
Instale el complemento y conecte un cliente
La instalación sigue el flujo estándar de los complementos de Redmine. Un administrador habilita MCP y asigna el acceso; cada usuario se conecta con su propia clave de API de Redmine.
- 1. Instalar Redmine MCPClone el repositorio git en el directorio de complementos de Redmine
cd /path/to/redmine/plugins git clone https://github.com/rkteam/redmine_mcp.git - 2. Instalar dependenciasDesde el directorio raíz de Redmine, instale las dependencias y reinicie Redmine
cd /path/to/redmine bundle install - 3. Habilitar MCP y la API RESTHabilite MCP en la configuración del complemento y el servicio web REST en la configuración de API de Redmine.
- 4. Asignar accesoHabilite el permiso global Use MCP para los roles necesarios. Los administradores tienen acceso a MCP automáticamente.
- 5. Configurar el clienteEstablezca la URL del servidor MCP en https://your-redmine.example.com/mcp y autentíquese con la clave de API de Redmine del usuario. La clave está disponible en Mi cuenta → Clave de acceso API.
Ejemplo de configuración de Cursor
.cursor/mcp.json{
"mcpServers": {
"redmine": {
"url": "https://your-redmine.example.com/mcp",
"headers": {
"X-Redmine-API-Key": "your_api_key"
}
}
}
}El formato exacto de la configuración MCP puede variar según la versión del cliente. No guarde las claves de API en el control de versiones.
Redmine sigue controlando el acceso
El complemento no elude el modelo de permisos de Redmine. El acceso MCP no sustituye los permisos ni las reglas de visibilidad de Redmine; añade una comprobación de acceso adicional.
Permisos y visibilidad
Las herramientas respetan los permisos y las reglas de visibilidad de Redmine del usuario autenticado.
Modo de solo lectura
Los administradores pueden bloquear las operaciones de creación, actualización y eliminación y mantener disponibles las herramientas de solo lectura.
Operaciones de escritura más seguras
Algunas operaciones de escritura incluyen protecciones frente a actualizaciones conflictivas y la creación accidental de recursos duplicados.
Compatibilidad
Redmine 6.0–7.0 · se requiere API REST
Pensado para ampliarse
Amplíe MCP desde otros complementos de Redmine
Otros complementos de Redmine pueden registrar sus propias herramientas, recursos, prompts y capacidades a través de la API de extensiones de Redmine MCP, sin modificar Redmine MCP. Los administradores eligen qué extensiones detectadas se habilitan.
Preguntas frecuentes sobre Redmine MCP
Redmine MCP admite actualmente Redmine 6.0–7.0. Consulte la documentación de compatibilidad para las versiones de protocolo y SDK.
Cualquier cliente MCP que admita Streamable HTTP y cabeceras HTTP personalizadas puede conectarse. La documentación incluye un ejemplo de configuración para Cursor.
Cada usuario se autentica con su clave de API de Redmine en la cabecera
X-Redmine-API-Key. La API REST debe estar habilitada en Redmine.Sí. El complemento comprueba el permiso global Use MCP además de los permisos y las reglas de visibilidad de Redmine del usuario autenticado.
Sí. El modo de solo lectura bloquea las operaciones de creación, actualización y eliminación y mantiene disponibles las herramientas de lectura.
No. El cliente MCP solo necesita acceso de red al endpoint /mcp de Redmine. La conexión puede ser pública o privada, según dónde se ejecute el cliente.
Sí. Otros complementos de Redmine pueden registrar sus propias herramientas, recursos, prompts y capacidades a través de la API de extensiones de Redmine MCP. Los administradores eligen qué extensiones detectadas se habilitan. Consulte la guía de extensiones.
Revise el código e instale Redmine MCP
El repositorio incluye los pasos de instalación, la configuración del cliente, la referencia completa de herramientas y una guía de resolución de problemas.
Nuestro bot en Telegram