logo

RedmineKanban

Login

So funktioniert es

Geben Sie KI-Clients einen kontrollierten Zugang zu Redmine

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.

60+
integrierte Werkzeuge
GPL v2+
Open-Source-Lizenz
6.0–7.0
unterstützte Redmine-Versionen

Was Clients über Redmine MCP tun können

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 und Mitglieder

Projekte auflisten, Aktivität und Versionen prüfen, Module einsehen und Mitgliedschaften verwalten, wenn der Benutzer die Rechte hat.

Tickets und Kommentare

Tickets suchen, anlegen und aktualisieren, Notizen und Anhänge hinzufügen, mit Beziehungen, Untertickets, Beobachtern und Kategorien arbeiten.

Suche und gespeicherte Abfragen

Tickets und Wiki-Seiten durchsuchen, Ticketlisten filtern und gespeicherte Redmine-Abfragen ausführen, ohne Filter im Client neu aufzubauen.

Zeiterfassung

Zeitbuchungen lesen, anlegen und aktualisieren, Aktivitäten prüfen und mehrere Buchungen in einem Vorgang importieren.

Wiki und Foren

Wiki-Seiten von Projekten lesen, anlegen und aktualisieren; Foren, Themen und Nachrichtenverläufe durchsuchen.

Dateien und Anhänge

Projektdateien auflisten, Dateien und Anhänge hochladen, Metadaten von Anhängen prüfen und unterstützte Anhänge innerhalb dokumentierter Grenzen herunterladen.

Erste Schritte

Plugin installieren und Client verbinden

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.

  1. 1. Redmine MCP installierenKlonen Sie das Git-Repository in das Redmine-Plugin-Verzeichnis
    cd /path/to/redmine/plugins
    git clone https://github.com/rkteam/redmine_mcp.git
  2. 2. Abhängigkeiten installierenInstallieren Sie die Abhängigkeiten im Redmine-Stammverzeichnis und starten Sie Redmine neu
    cd /path/to/redmine
    bundle install
  3. 3. MCP und REST-API aktivierenAktivieren Sie MCP in den Plugin-Einstellungen und den REST-Webdienst in den API-Einstellungen von Redmine.
  4. 4. Zugang vergebenAktivieren Sie die globale Berechtigung Use MCP für die erforderlichen Rollen. Administratoren haben automatisch MCP-Zugang.
  5. 5. Client konfigurierenSetzen Sie die MCP-Server-URL auf https://your-redmine.example.com/mcp und authentifizieren Sie sich mit dem Redmine-API-Schlüssel des Benutzers. Der Schlüssel liegt unter Mein Konto → API-Zugangsschlüssel.
Beispielkonfiguration für Cursor.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.

Redmine behält die Kontrolle über den Zugang

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.

Berechtigungen und Sichtbarkeit

Werkzeuge beachten die bestehenden Redmine-Berechtigungen und Sichtbarkeitsregeln des authentifizierten Benutzers.

Nur-Lesen-Modus

Administratoren können Anlegen, Aktualisieren und Löschen sperren und nur lesende Werkzeuge verfügbar lassen.

Sicherere Schreibvorgänge

Ausgewählte Schreibvorgänge enthalten Schutz vor widersprüchlichen Aktualisierungen und versehentlicher doppelter Ressourcenerstellung.

Kompatibilität

Redmine 6.0–7.0 · REST-API erforderlich

Erweiterbar aufgebaut

MCP über andere Redmine-Plugins erweitern

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-FAQ

  • 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.

Quellcode prüfen und Redmine MCP installieren

Das Repository enthält Installationsschritte, Client-Konfiguration, die vollständige Werkzeugreferenz und Hinweise zur Fehlerbehebung.