Server MCP

Server MCP

Il server MCP (Model Context Protocol) consente agli assistenti AI e agli strumenti basati sull’AI di collegarsi all’organizzazione ProcessMind e di accedere direttamente ai dati dei processi. Invece di sviluppare un’integrazione personalizzata, è sufficiente configurare il client MCP per utilizzare il server di ProcessMind; l’assistente potrà quindi consultare processi, modelli, ruoli, utenti e statistiche dei processi tramite gli strumenti MCP standard.

Che cos’è MCP?

MCP è uno standard aperto che definisce come le applicazioni AI (il «client», ad esempio un ambiente di sviluppo o un assistente AI) si collegano a fonti di dati e strumenti esterni (il «server»). Per l’AI, funziona come una porta USB-C: un unico standard di connessione consente agli assistenti di accedere a numerosi strumenti e risorse. ProcessMind offre un server MCP che permette di utilizzare gli strumenti AI già in uso con i dati dell’organizzazione, senza dover sviluppare e mantenere codice di integrazione personalizzato.

Funzionalità del server MCP

Il server rende disponibili i contenuti relativi ai processi dell’organizzazione tramite strumenti e risorse MCP. Sono inclusi:

• Processi e modelli BPMN
• Ruoli, RACI e utenti
• Documentazione e statistiche sui processi
• Analisi AI e risposte sui Suoi processi
• Metadati dell’organizzazione e dell’ambiente

Gli strumenti effettivamente disponibili dipendono dalla configurazione dell’ambiente. Il server è pensato per attività di modellazione, documentazione e analisi; il caricamento di dati, la mappatura dei dati, le simulazioni e la gestione delle Chiavi API non sono disponibili come strumenti MCP e richiedono ancora l’utilizzo dell’API REST.

Prerequisiti

Prima di collegarsi, verifichi di disporre di:

1. un abbonamento al piano Enterprise, poiché il server MCP è una funzionalità Enterprise
2. una Chiave API con accesso agli ambienti che desidera rendere disponibili; consulti la sezione Chiavi API
3. un client compatibile con MCP, ad esempio un ambiente di sviluppo o un assistente AI che supporti server MCP remoti

Collegare il client MCP

La procedura generale è la stessa per tutti i client MCP:

1. Apra la configurazione del server MCP del client
2. Aggiunga un server remoto (HTTP) utilizzando l’URL del server MCP relativo al Suo ambiente
3. Imposti l’intestazione Authorizationx-api-key sulla Sua Chiave API
4. Salvi la configurazione e riavvii il client oppure si colleghi di nuovo
5. Verifichi la connessione chiedendo all’assistente di elencare i processi

Ecco un esempio di voce di configurazione:

{
	"mcpServers": {
		"processmind": {
			"url": "<mcp-server-url>",
			"headers": {
				"x-api-key": "<your-api-key>"
			}
		}
	}
}

Utilizzi l’URL del server MCP relativo al Suo ambiente e la Sua Chiave API nell’intestazione x-api-key. Sono supportati anche i token OAuth con credenziali client, tramite l’endpoint dei token.

Sicurezza e buone pratiche

• Mantenga segreta la chiave API: non la inserisca mai nel controllo del codice sorgente né la esponga nel codice lato client
• Limiti le chiavi in base all’ambiente: crei chiavi dedicate per l’accesso MCP, così potrà revocarle in modo indipendente
• Riveda il registro di audit: le azioni eseguite tramite MCP utilizzano la Sua chiave API e compaiono nel Registro di audit

Argomenti correlati

• Chiavi API
• Chiamate API
• Riferimento API: processi
• Riferimento API: dati
• Riferimento API: simulazioni