In questa pagina
> risorse > documentazione > api > Server MCP

Server MCP

Enterprise Enterprise Disponibile con il piano Enterprise. Le postazioni dei piani self-service non possono utilizzare questa funzionalità. Confronta i piani Disponibile nel piano Enterprise

Server MCP

Il server MCP (Model Context Protocol) consente agli assistenti AI e agli strumenti basati sull’AI di collegarsi alla Sua organizzazione ProcessMind e di lavorare direttamente con i dati dei processi. Invece di sviluppare un’integrazione personalizzata, configuri il client MCP per utilizzare il server di ProcessMind: l’assistente potrà leggere processi, modelli, dataset e risultati delle simulazioni tramite strumenti MCP standard.

Che cos’è MCP?

MCP è uno standard aperto che definisce il modo in cui le applicazioni AI, ovvero il «client», come un IDE o un assistente AI, si collegano a fonti di dati e strumenti esterni, ovvero il «server». Funziona come una porta USB-C per l’AI: un’unica connessione standard consente agli assistenti di accedere a numerosi strumenti e risorse. ProcessMind implementa un server MCP, così può utilizzare gli strumenti AI già in uso sui dati della Sua organizzazione senza scrivere e mantenere codice di integrazione personalizzato.

Funzionalità del server MCP

Il server espone gli stessi dati forniti dall’API REST, rendendoli disponibili come strumenti e risorse MCP. Sono inclusi i seguenti dati della Sua organizzazione:

  • Processi e modelli BPMN
  • Dataset e tabelle dati
  • Configurazioni e risultati delle simulazioni
  • Metadati dell’organizzazione e dell’ambiente

Gli strumenti disponibili dipendono dalla configurazione del Suo ambiente. Poiché il server utilizza la stessa API, tutto ciò che può fare tramite il riferimento API è disponibile anche tramite MCP.

Prerequisiti

Prima di effettuare il collegamento, verifichi di disporre di:

  1. Un abbonamento al piano Enterprise: il server MCP è una funzionalità Enterprise
  2. Una chiave API con accesso agli ambienti che desidera esporre: vedere Chiavi API
  3. Un client compatibile con MCP, ad esempio un IDE basato sull’AI o un assistente che supporti server MCP remoti

Collegare il client MCP

La configurazione generale è la stessa in ogni client MCP:

  1. Apra la configurazione del server MCP del client
  2. Aggiunga un server remoto (HTTP) utilizzando l’URL del server MCP del Suo ambiente
  3. Imposti l’intestazione x-api-keyheader sulla Sua chiave API
  4. Salvi la configurazione e riavvii o ricolleghi il client
  5. Verifichi la connessione chiedendo al Suo assistente di elencare i Suoi processi

Una voce di configurazione tipica è simile alla seguente:

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

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

Sicurezza e buone pratiche

  • Mantenga segreta la Sua chiave API: non esegua mai il commit nel controllo del codice sorgente e non la esponga nel codice lato client
  • Definisca l’ambito delle chiavi per ambiente: crei chiavi dedicate per l’accesso MCP, così potrà revocarle in modo indipendente
  • Riveda il registro di audit: le azioni avviate tramite MCP vengono eseguite dalla Sua chiave API e compaiono nell’Audit Log

Argomenti correlati

Documentazione correlata