logo

RedmineKanban

Login

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. 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. 2. Zainstaluj zależnościZ katalogu głównego Redmine zainstaluj zależności i zrestartuj Redmine
    cd /path/to/redmine
    bundle install
  3. 3. Włącz MCP i REST APIWłącz MCP w ustawieniach wtyczki oraz usługę internetową REST w ustawieniach API Redmine.
  4. 4. Nadaj dostępWłącz globalne uprawnienie Use MCP dla wymaganych ról. Administratorzy mają dostęp do MCP automatycznie.
  5. 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.