Plugin Redmine open-source gratuit

Connecter des clients IA à Redmine via MCP

Redmine MCP exécute un serveur Model Context Protocol dans Redmine. Les clients IA avec prise en charge MCP peuvent travailler avec les demandes, projets, entrées de temps, pages Wiki et fichiers selon les permissions existantes de chaque utilisateur.

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.

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.

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.

RedmineKanban

Notre bot sur Telegram

Notre chaîne sur Telegram

[email protected]

Développement personnalisé Redmine Cloud Blog Politique de confidentialité Contacts Conditions générales Politique de Remboursement