Progetti e membri
Elencare i progetti, consultare attività e versioni, ispezionare i moduli e gestire i membri del progetto quando l'utente ha il permesso.
Come funziona
Offrite ai client IA un accesso controllato a Redmine
Model Context Protocol è uno standard aperto che consente ai client IA di usare gli strumenti di sistemi esterni tramite un'interfaccia comune. Redmine MCP fornisce questa interfaccia direttamente da Redmine, senza un servizio di integrazione separato.
- 60+
- strumenti integrati
- GPL v2+
- licenza open-source
- 6.0–7.0
- versioni Redmine supportate
Cosa possono fare i client tramite Redmine MCP
Il server espone strumenti MCP dedicati invece di un accesso illimitato al database. Gli strumenti disponibili dipendono dai permessi dell'utente, dall'accesso ai progetti e dalle estensioni abilitate.
Segnalazioni e commenti
Trovare, creare e aggiornare segnalazioni, aggiungere note e allegati, lavorare con relazioni, sottoattività, osservatori e categorie.
Ricerca e query salvate
Cercare segnalazioni e pagine Wiki, filtrare gli elenchi di segnalazioni ed eseguire le query Redmine salvate senza ricostruire i filtri nel client.
Registrazione del tempo
Leggere, creare e aggiornare gli inserimenti di tempo, ispezionare i tipi di attività e importare più inserimenti in un'unica operazione.
Wiki e forum
Leggere, creare e aggiornare le pagine Wiki del progetto; sfogliare forum, argomenti e thread dei messaggi.
File e allegati
Elencare i file del progetto, caricare file e allegati, ispezionare i metadati degli allegati e scaricare gli allegati supportati entro i limiti documentati.
Per iniziare
Installate il plugin e collegate un client
L'installazione segue il flusso standard dei plugin Redmine. Un amministratore abilita MCP e assegna l'accesso; ciascun utente si collega con la propria chiave API Redmine.
- 1. Installare Redmine MCPClonate il repository git nella directory dei plugin di Redmine
cd /path/to/redmine/plugins git clone https://github.com/rkteam/redmine_mcp.git - 2. Installare le dipendenzeDalla directory radice di Redmine, installate le dipendenze e riavviate Redmine
cd /path/to/redmine bundle install - 3. Abilitare MCP e l'API RESTAbilitate MCP nelle impostazioni del plugin e il servizio web REST nelle impostazioni API di Redmine.
- 4. Assegnare l'accessoAbilitate il permesso globale Use MCP per i ruoli necessari. Gli amministratori hanno accesso a MCP automaticamente.
- 5. Configurare il clientImpostate l'URL del server MCP su https://your-redmine.example.com/mcp e autenticatevi con la chiave API Redmine dell'utente. La chiave è disponibile in Il mio account → Chiave di accesso API.
Esempio di configurazione Cursor
.cursor/mcp.json{
"mcpServers": {
"redmine": {
"url": "https://your-redmine.example.com/mcp",
"headers": {
"X-Redmine-API-Key": "your_api_key"
}
}
}
}Il formato esatto della configurazione MCP può variare in base alla versione del client. Non salvate le chiavi API nel controllo di versione.
Redmine resta in controllo dell'accesso
Il plugin non aggira il modello di permessi di Redmine. L'accesso MCP non sostituisce i permessi né le regole di visibilità di Redmine; aggiunge un ulteriore controllo di accesso.
Permessi e visibilità
Gli strumenti rispettano i permessi e le regole di visibilità Redmine esistenti dell'utente autenticato.
Modalità di sola lettura
Gli amministratori possono bloccare le operazioni di creazione, aggiornamento ed eliminazione mantenendo disponibili gli strumenti di sola lettura.
Operazioni di scrittura più sicure
Alcune operazioni di scrittura includono protezioni contro aggiornamenti in conflitto e la creazione accidentale di risorse duplicate.
Compatibilità
Redmine 6.0–7.0 · API REST richiesta
Progettato per essere esteso
Estendete MCP da altri plugin Redmine
Altri plugin Redmine possono registrare i propri strumenti, risorse, prompt e capacità tramite l'API di estensione Redmine MCP, senza modificare Redmine MCP. Gli amministratori scelgono quali estensioni rilevate abilitare.
FAQ su Redmine MCP
Redmine MCP supporta attualmente Redmine 6.0–7.0. Consultate la documentazione di compatibilità per le versioni di protocollo e SDK.
Qualsiasi client MCP che supporti Streamable HTTP e intestazioni HTTP personalizzate può collegarsi. La documentazione include un esempio di configurazione per Cursor.
Ogni utente si autentica con la propria chiave API Redmine nell'intestazione
X-Redmine-API-Key. L'API REST deve essere abilitata in Redmine.Sì. Il plugin verifica il permesso globale Use MCP oltre ai permessi e alle regole di visibilità Redmine esistenti dell'utente autenticato.
Sì. La modalità di sola lettura blocca creazione, aggiornamento ed eliminazione e mantiene disponibili gli strumenti di lettura.
No. Il client MCP ha bisogno solo di accesso di rete all'endpoint /mcp di Redmine. La connessione può essere pubblica o privata, a seconda di dove viene eseguito il client.
Sì. Altri plugin Redmine possono registrare i propri strumenti, risorse, prompt e capacità tramite l'API di estensione Redmine MCP. Gli amministratori scelgono quali estensioni rilevate abilitare. Vedere la guida alle estensioni.
Consultate il codice e installate Redmine MCP
Il repository contiene i passaggi di installazione, la configurazione del client, il riferimento completo agli strumenti e una guida alla risoluzione dei problemi.
Il nostro bot su Telegram