Projets et membres
Lister les projets, consulter l'activité et les versions, inspecter les modules et gérer les membres lorsque l'utilisateur en a la permission.
Fonctionnement
Offrez aux clients IA un accès contrôlé à Redmine
Model Context Protocol est un standard ouvert qui permet aux clients IA d'utiliser les outils de systèmes externes via une interface commune. Redmine MCP fournit cette interface directement depuis Redmine, sans service d'intégration séparé.
- 60+
- outils intégrés
- GPL v2+
- licence open-source
- 6.0–7.0
- versions Redmine prises en charge
Ce que les clients peuvent faire via Redmine MCP
Le serveur expose des outils MCP dédiés plutôt qu'un accès illimité à la base de données. Les outils disponibles dépendent des permissions de l'utilisateur, de l'accès aux projets et des extensions activées.
Demandes et commentaires
Rechercher, créer et mettre à jour des demandes, ajouter des notes et des pièces jointes, travailler avec les relations, sous-tâches, observateurs et catégories.
Recherche et requêtes enregistrées
Rechercher dans les demandes et les pages Wiki, filtrer les listes de demandes et exécuter les requêtes Redmine enregistrées sans reconstruire les filtres dans le client.
Suivi du temps
Lire, créer et mettre à jour les entrées de temps, consulter les types d'activités et importer plusieurs entrées en une opération.
Wiki et forums
Lire, créer et mettre à jour les pages Wiki des projets ; parcourir les forums, sujets et fils de messages.
Fichiers et pièces jointes
Lister les fichiers du projet, téléverser des fichiers et pièces jointes, consulter les métadonnées des pièces jointes et télécharger les pièces jointes prises en charge dans les limites documentées.
Pour commencer
Installer le plugin et connecter un client
L'installation suit le flux standard des plugins Redmine. Un administrateur active MCP et attribue l'accès ; chaque utilisateur se connecte avec sa propre clé d'API Redmine.
- 1. Installer Redmine MCPCloner le dépôt git dans le répertoire des plugins Redmine
cd /path/to/redmine/plugins git clone https://github.com/rkteam/redmine_mcp.git - 2. Installer les dépendancesDepuis la racine de Redmine, installer les dépendances et redémarrer Redmine
cd /path/to/redmine bundle install - 3. Activer MCP et l'API RESTActivez MCP dans les paramètres du plugin et le service web REST dans les paramètres d'API de Redmine.
- 4. Attribuer l'accèsActivez la permission globale Use MCP pour les rôles concernés. Les administrateurs ont automatiquement accès à MCP.
- 5. Configurer le clientDéfinissez l'URL du serveur MCP sur https://your-redmine.example.com/mcp et authentifiez-vous avec la clé d'API Redmine de l'utilisateur. La clé est disponible sous Mon compte → Clé d'accès API.
Exemple de configuration Cursor
.cursor/mcp.json{
"mcpServers": {
"redmine": {
"url": "https://your-redmine.example.com/mcp",
"headers": {
"X-Redmine-API-Key": "your_api_key"
}
}
}
}Le format exact de configuration MCP peut varier selon la version du client. Ne placez pas les clés d'API dans le contrôle de versions.
Redmine reste maître de l'accès
Le plugin ne contourne pas le modèle de permissions de Redmine. L'accès MCP ne remplace pas les permissions ni les règles de visibilité de Redmine ; il ajoute un contrôle d'accès supplémentaire.
Permissions et visibilité
Les outils respectent les permissions et règles de visibilité Redmine existantes de l'utilisateur authentifié.
Mode lecture seule
Les administrateurs peuvent bloquer les opérations de création, mise à jour et suppression tout en conservant les outils en lecture.
Opérations d'écriture plus sûres
Certaines opérations d'écriture incluent des protections contre les mises à jour conflictuelles et la création accidentelle de ressources en double.
Compatibilité
Redmine 6.0–7.0 · API REST requise
Conçu pour être étendu
Étendre MCP depuis d'autres plugins Redmine
D'autres plugins Redmine peuvent enregistrer leurs propres outils, ressources, prompts et capacités via l'API d'extension Redmine MCP, sans modifier Redmine MCP lui-même. Les administrateurs choisissent quelles extensions détectées sont activées.
FAQ Redmine MCP
Redmine MCP prend actuellement en charge Redmine 6.0–7.0. Consultez la documentation de compatibilité pour les versions de protocole et de SDK.
Tout client MCP qui prend en charge Streamable HTTP et les en-têtes HTTP personnalisés peut se connecter. La documentation inclut un exemple de configuration pour Cursor.
Chaque utilisateur s'authentifie avec sa clé d'API Redmine dans l'en-tête
X-Redmine-API-Key. L'API REST doit être activée dans Redmine.Oui. Le plugin vérifie la permission globale Use MCP en plus des permissions et règles de visibilité Redmine existantes de l'utilisateur authentifié.
Oui. Le mode lecture seule bloque les opérations de création, mise à jour et suppression tout en conservant les outils de lecture.
Non. Le client MCP a seulement besoin d'un accès réseau au point de terminaison /mcp de Redmine. La connexion peut être publique ou privée, selon l'endroit où le client s'exécute.
Oui. D'autres plugins Redmine peuvent enregistrer leurs propres outils, ressources, prompts et capacités via l'API d'extension Redmine MCP. Les administrateurs choisissent quelles extensions détectées sont activées. Voir le guide d'extension.
Consulter le code source et installer Redmine MCP
Le dépôt contient les étapes d'installation, la configuration du client, la référence complète des outils et un guide de dépannage.
Notre bot sur Telegram