Darmowa wtyczka open-source do Redmine

Podłącz klientów AI do Redmine przez MCP

Redmine MCP uruchamia serwer Model Context Protocol wewnątrz Redmine. Klienci AI z obsługą MCP mogą pracować z zadaniami, projektami, wpisami czasu, stronami Wiki i plikami zgodnie z istniejącymi uprawnieniami każdego użytkownika.

Jak to działa

Zapewnij klientom AI kontrolowany dostęp do Redmine

Model Context Protocol to otwarty standard, który pozwala klientom AI korzystać z narzędzi systemów zewnętrznych przez wspólny interfejs. Redmine MCP udostępnia ten interfejs bezpośrednio z Redmine, bez osobnej usługi integracyjnej.

60+: wbudowanych narzędzi
GPL v2+: licencja open-source
6.0–7.0: obsługiwane wersje Redmine

Co klienci mogą robić przez Redmine MCP

Serwer udostępnia dedykowane narzędzia MCP zamiast nieograniczonego dostępu do bazy danych. Dostępne narzędzia zależą od uprawnień użytkownika, dostępu do projektów i włączonych rozszerzeń.

Projekty i członkowie

Wyświetlaj listę projektów, przeglądaj aktywność i wersje, sprawdzaj moduły i zarządzaj członkostwem w projekcie, gdy użytkownik ma uprawnienie.

Zadania i komentarze

Wyszukuj, twórz i aktualizuj zadania, dodawaj uwagi i załączniki, pracuj z relacjami, zadaniami podrzędnymi, obserwatorami i kategoriami.

Wyszukiwanie i zapisane zapytania

Wyszukuj zadania i strony Wiki, filtruj listy zadań i uruchamiaj zapisane zapytania Redmine bez ponownego budowania filtrów w kliencie.

Rejestracja czasu

Odczytuj, twórz i aktualizuj wpisy czasu, sprawdzaj typy aktywności i importuj kilka wpisów w jednej operacji.

Wiki i fora

Czytaj, twórz i aktualizuj strony Wiki projektu; przeglądaj fora, tematy i wątki wiadomości.

Pliki i załączniki

Wyświetlaj listę plików projektu, przesyłaj pliki i załączniki, sprawdzaj metadane załączników i pobieraj obsługiwane załączniki w udokumentowanych limitach.

Pierwsze kroki

Zainstaluj wtyczkę i podłącz klienta

Instalacja przebiega według standardowego schematu wtyczek Redmine. Administrator włącza MCP i nadaje dostęp; każdy użytkownik łączy się własnym kluczem API Redmine.

1. Zainstaluj Redmine MCPSklonuj repozytorium git do katalogu wtyczek Redmine

cd /path/to/redmine/plugins
git clone https://github.com/rkteam/redmine_mcp.git

2. Zainstaluj zależnościZ katalogu głównego Redmine zainstaluj zależności i zrestartuj Redmine
```
cd /path/to/redmine
bundle install
```
3. Włącz MCP i REST APIWłącz MCP w ustawieniach wtyczki oraz usługę internetową REST w ustawieniach API Redmine.
4. Nadaj dostępWłącz globalne uprawnienie Use MCP dla wymaganych ról. Administratorzy mają dostęp do MCP automatycznie.
5. Skonfiguruj klientaUstaw URL serwera MCP na https://your-redmine.example.com/mcp i uwierzytelnij się kluczem API Redmine użytkownika. Klucz jest dostępny w Moje konto → Klucz dostępu API.

Przykład konfiguracji Cursor.cursor/mcp.json

{
  "mcpServers": {
    "redmine": {
      "url": "https://your-redmine.example.com/mcp",
      "headers": {
        "X-Redmine-API-Key": "your_api_key"
      }
    }
  }
}

Dokładny format konfiguracji MCP może zależeć od wersji klienta. Nie umieszczaj kluczy API w systemie kontroli wersji.

Redmine zachowuje kontrolę nad dostępem

Wtyczka nie omija modelu uprawnień Redmine. Dostęp MCP nie zastępuje uprawnień ani reguł widoczności Redmine; dodaje dodatkową kontrolę dostępu.

Uprawnienia i widoczność

Narzędzia respektują istniejące uprawnienia i reguły widoczności uwierzytelnionego użytkownika Redmine.

Tryb tylko do odczytu

Administratorzy mogą zablokować operacje tworzenia, aktualizacji i usuwania, pozostawiając dostępne narzędzia tylko do odczytu.

Bezpieczniejsze operacje zapisu

Wybrane operacje zapisu obejmują zabezpieczenia przed sprzecznymi aktualizacjami i przypadkowym ponownym utworzeniem zasobów.

Zgodność

Redmine 6.0–7.0 · wymagane REST API

Zaprojektowane do rozszerzania

Rozszerzaj MCP z innych wtyczek Redmine

Inne wtyczki Redmine mogą rejestrować własne narzędzia, zasoby, prompty i możliwości przez API rozszerzeń Redmine MCP, bez modyfikowania samego Redmine MCP. Administratorzy wybierają, które wykryte rozszerzenia włączyć.

FAQ Redmine MCP

Redmine MCP obecnie obsługuje Redmine 6.0–7.0. Wersje protokołu i SDK znajdziesz w dokumentacji zgodności.
Każdy klient MCP, który obsługuje Streamable HTTP i niestandardowe nagłówki HTTP, może się połączyć. Dokumentacja zawiera przykład konfiguracji dla Cursor.
Każdy użytkownik uwierzytelnia się kluczem API Redmine w nagłówku X-Redmine-API-Key. REST API musi być włączone w Redmine.
Tak. Wtyczka sprawdza globalne uprawnienie Use MCP oprócz istniejących uprawnień i reguł widoczności uwierzytelnionego użytkownika Redmine.
Tak. Tryb tylko do odczytu blokuje tworzenie, aktualizację i usuwanie, pozostawiając dostępne narzędzia odczytu.
Nie. Klient MCP potrzebuje tylko dostępu sieciowego do endpointu /mcp Redmine. Połączenie może być publiczne lub prywatne, w zależności od miejsca uruchomienia klienta.
Tak. Inne wtyczki Redmine mogą rejestrować własne narzędzia, zasoby, prompty i możliwości przez API rozszerzeń Redmine MCP. Administratorzy wybierają, które wykryte rozszerzenia włączyć. Zobacz instrukcję rozszerzeń.

Przejrzyj kod i zainstaluj Redmine MCP

Repozytorium zawiera kroki instalacji, konfigurację klienta, pełne zestawienie narzędzi i wskazówki diagnostyczne.

RedmineKanban

Nasz bot w Telegramie

Nasz kanał w Telegramie

[email protected]

Dostosowane tworzenie Redmine Cloud Blog Polityka prywatności Kontakty Warunki i zasady Polityka Zwrotów