Projekte und Mitglieder
Projekte auflisten, Aktivität und Versionen prüfen, Module einsehen und Mitgliedschaften verwalten, wenn der Benutzer die Rechte hat.
So funktioniert es
Model Context Protocol ist ein offener Standard, mit dem KI-Clients Werkzeuge externer Systeme über eine gemeinsame Schnittstelle nutzen können. Redmine MCP stellt diese Schnittstelle direkt in Redmine bereit, ohne einen separaten Integrationsdienst.
Der Server stellt spezielle MCP-Werkzeuge bereit, keinen uneingeschränkten Datenbankzugriff. Verfügbare Werkzeuge hängen von den Rechten des aktuellen Benutzers, dem Projektzugang und aktivierten Erweiterungen ab.
Projekte auflisten, Aktivität und Versionen prüfen, Module einsehen und Mitgliedschaften verwalten, wenn der Benutzer die Rechte hat.
Tickets suchen, anlegen und aktualisieren, Notizen und Anhänge hinzufügen, mit Beziehungen, Untertickets, Beobachtern und Kategorien arbeiten.
Tickets und Wiki-Seiten durchsuchen, Ticketlisten filtern und gespeicherte Redmine-Abfragen ausführen, ohne Filter im Client neu aufzubauen.
Zeitbuchungen lesen, anlegen und aktualisieren, Aktivitäten prüfen und mehrere Buchungen in einem Vorgang importieren.
Wiki-Seiten von Projekten lesen, anlegen und aktualisieren; Foren, Themen und Nachrichtenverläufe durchsuchen.
Projektdateien auflisten, Dateien und Anhänge hochladen, Metadaten von Anhängen prüfen und unterstützte Anhänge innerhalb dokumentierter Grenzen herunterladen.
Erste Schritte
Die Installation folgt dem üblichen Ablauf für Redmine-Plugins. Ein Administrator aktiviert MCP und vergibt Zugang; jeder Benutzer verbindet sich mit seinem eigenen Redmine-API-Schlüssel.
cd /path/to/redmine/plugins
git clone https://github.com/rkteam/redmine_mcp.gitcd /path/to/redmine
bundle install.cursor/mcp.json{
"mcpServers": {
"redmine": {
"url": "https://your-redmine.example.com/mcp",
"headers": {
"X-Redmine-API-Key": "your_api_key"
}
}
}
}Das genaue MCP-Konfigurationsformat kann je nach Client-Version variieren. Legen Sie API-Schlüssel nicht in der Versionskontrolle ab.
Das Plugin umgeht das Berechtigungsmodell von Redmine nicht. MCP-Zugang ersetzt weder Redmine-Berechtigungen noch Sichtbarkeitsregeln; er fügt eine zusätzliche Zugriffsprüfung hinzu.
Werkzeuge beachten die bestehenden Redmine-Berechtigungen und Sichtbarkeitsregeln des authentifizierten Benutzers.
Administratoren können Anlegen, Aktualisieren und Löschen sperren und nur lesende Werkzeuge verfügbar lassen.
Ausgewählte Schreibvorgänge enthalten Schutz vor widersprüchlichen Aktualisierungen und versehentlicher doppelter Ressourcenerstellung.
Redmine 6.0–7.0 · REST-API erforderlich
Erweiterbar aufgebaut
Andere Redmine-Plugins können eigene Werkzeuge, Ressourcen, Prompts und Fähigkeiten über die Redmine-MCP-Erweiterungs-API registrieren, ohne Redmine MCP selbst zu ändern. Administratoren wählen, welche erkannten Erweiterungen aktiviert werden.
Redmine MCP unterstützt derzeit Redmine 6.0–7.0. Protokoll- und SDK-Versionen stehen in der Kompatibilitätsdokumentation.
Jeder MCP-Client, der Streamable HTTP und benutzerdefinierte HTTP-Header unterstützt, kann sich verbinden. Die Dokumentation enthält ein Konfigurationsbeispiel für Cursor.
Jeder Benutzer authentifiziert sich mit seinem Redmine-API-Schlüssel im Header X-Redmine-API-Key. Die REST-API muss in Redmine aktiviert sein.
Ja. Das Plugin prüft die globale Berechtigung Use MCP zusätzlich zu den bestehenden Redmine-Berechtigungen und Sichtbarkeitsregeln des authentifizierten Benutzers.
Ja. Der Nur-Lesen-Modus blockiert Anlegen, Aktualisieren und Löschen und lässt Lesewerkzeuge verfügbar.
Nein. Der MCP-Client braucht nur Netzwerkzugang zum /mcp-Endpunkt von Redmine. Die Verbindung kann öffentlich oder privat sein, je nachdem, wo der Client läuft.
Ja. Andere Redmine-Plugins können eigene Werkzeuge, Ressourcen, Prompts und Fähigkeiten über die Redmine-MCP-Erweiterungs-API registrieren. Administratoren wählen, welche erkannten Erweiterungen aktiviert werden. Siehe die Erweiterungsanleitung.
Das Repository enthält Installationsschritte, Client-Konfiguration, die vollständige Werkzeugreferenz und Hinweise zur Fehlerbehebung.