Vai al contenuto

Strumenti MCP

Server di strumenti esterni dietro la stessa chiusa di conformità, con permessi per chiave negati per default.

Registra server di strumenti MCP esterni (HTTP, SSE o stdio) nella Console con tag di residenza; i segreti di autenticazione sono sigillati nel vault delle credenziali e mai restituiti. I servizi MCP seguono la policy di residenza, non l'elenco dei fornitori di modelli del DPA firmato.

Tools & MCP: gestisci i server e gli accessi governati agli strumenti.
Tools & MCP: gestisci i server e gli accessi governati agli strumenti.Interfaccia in inglese · dati dimostrativi illustrativi. Apri l’immagine a dimensione intera.

Ogni chiamata a strumento supera la stessa chiusa di una chat completion: Ispezione (protezione dei dati sugli argomenti), Instradamento (residenza sul server), Sigillo (catena di audit), Misurazione (rate e budget). Le concessioni degli strumenti sono per chiave e negate per impostazione predefinita. Sluis risponde anche a POST /v1/mcp come server MCP esso stesso, esponendo esattamente gli strumenti concessi alla chiave chiamante.

Chiamare gli strumenti dal tuo codice

Usa POST /v1/mcp con una chiave API per vedere gli strumenti che quella chiave può usare. Eseguire uno strumento è una chiamata separata.

  • Elenca: tools/list restituisce gli strumenti concessi alla tua chiave. Un server viene escluso quando la residenza non lo consente, manca il suo accesso o non si riesce a recuperare l’elenco dei suoi strumenti.
  • Chiedi: tools/call non esegue nulla. Restituisce needs_confirmation con lo strumento, gli argomenti e il punto in cui eseguirlo.
  • Esegui: invia gli argomenti dello strumento come corpo della richiesta a POST /v1/mcp/servers/{id}/tools/{tool}/call. Questa chiamata passa da Ispezione, Instradamento, Sigillo e Misurazione.
  • Uno strumento non concesso alla tua chiave fallisce con l’errore -32000, parametri errati con -32602 e un metodo sconosciuto con -32601. Gli errori JSON-RPC tornano con HTTP 200; una richiesta malformata restituisce HTTP 400.
  • I server stdio eseguono solo i programmi che l’operatore ha inserito nella allowlist SLUIS_MCP_STDIO_ALLOW, fino a 16 alla volta.
# list the tools this key is granted (deny-by-default)
curl https://api.sluis.ai/v1/mcp \
  -H "Authorization: Bearer $SLUIS_KEY" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

Autenticazione MCP: due direzioni

Accedere a Sluis da un client MCP

OAuth in ingresso su /agent/mcp collega un client MCP a Sluis tramite browser. In questa configurazione non si incolla alcuna chiave, e le chiavi per le chiamate ai modelli restano invariate.

  1. Aggiungi Sluis nel tuo client, come negli esempi qui sotto. Il client trova Sluis tramite i documenti di discovery pubblicati e si registra da solo, se lo supporta.
  2. Il client apre il browser sulla pagina di consenso, /console/mcp-authorize. Mostra il client, l’organizzazione e gli strumenti raggiungibili.
  3. Approva o nega l’accesso nell’organizzazione desiderata.
  • Sluis crea o riutilizza automaticamente una credenziale personale per gli strumenti di questo client.
  • Restano validi i collegamenti dei plugin, i permessi sugli strumenti e le policy. Il solo consenso non concede alcuno strumento.
  • L’organizzazione deve avere Agent Harness attivo.
  • I token di accesso durano un’ora. I refresh token ruotano a ogni utilizzo.
  • Revoca un client in Agent Harness › Client collegati. Vengono disconnessi i suoi token e la sua chiave agente personale.
  • Questo è separato dall’accesso esterno user_oauth.
claude mcp add --transport http sluis https://<gateway>/agent/mcp

Esempi di configurazione, non una matrice di interoperabilità verificata. Questi esempi non dimostrano interoperabilità con Claude, Codex o fornitori esterni.

Credenziali statiche del server

Usa headers per intestazioni fisse. Il valore precedente oauth indica un token bearer statico nel vault, non un accesso tramite browser.

Modalità account

Per OAuth interattivo, la modalità account decide quale identità Sluis usa con il server degli strumenti.

  • Organizzazione (account_mode=organization): un’identità condivisa che un amministratore collega esplicitamente tramite OAuth. Non riutilizza mai una credenziale personale.
  • Ogni utente (account_mode=user): solo la connessione personale del membro che agisce.
  • L’autenticazione è separata: OAuth interattivo usa user_oauth, e il valore precedente oauth resta un token bearer statico.

Connessioni personali ai servizi esterni

In modalità Ogni utente, ogni membro accede da sé al servizio esterno.

  1. Un amministratore concede il server a Workspace. I server aggiunti dagli amministratori richiedono prima questo passaggio.
  2. Ogni membro accede in Impostazioni › Connessioni.
  • Una connessione non aggira permessi sugli strumenti, residenza, protezione dei dati o budget.
  • Gli amministratori possono vedere lo stato e revocare connessioni, ma non usare l’identità di un altro membro.
  • Le chiamate senza identità utente, comprese le chiavi dell’organizzazione, vengono rifiutate in modalità Ogni utente.
  • Se non ti sei collegato, o il servizio non accetta più il tuo accesso, lo strumento restituisce connect_required e la risposta mostra un’azione Collega per quel server. Nulla viene eseguito con un’altra identità.

Disattivare o attivare gli strumenti MCP

Proprietari e amministratori attivano o disattivano gli strumenti MCP nelle conversazioni Workspace nella configurazione Workspace della console. La stessa impostazione è il booleano mcp_enabled su GET/PUT /chat/settings.

  • È true per impostazione predefinita: per le nuove organizzazioni, le impostazioni precedenti e un campo assente. Ometterlo da un PUT conserva il valore attuale, incluso false.
  • Con false, Workspace non scopre strumenti MCP e ne rifiuta l’esecuzione, anche per strumenti già scoperti in conversazioni esistenti, Agenti e sotto-agenti.
  • Registrazioni, approvazioni, permessi e credenziali vengono conservati.
  • Gli accessi esterni /agent/mcp, /v1/mcp e il Playground della console restano invariati.
  • La policy di registrazione dei server personali resta indipendente e valida per tutta l’organizzazione.

Proposte MCP personali

Le proposte MCP personali sono Disattivate per impostazione predefinita. Gli amministratori scelgono una di due impostazioni.

  • Disattivato sospende i server personali esistenti. Non blocca l’accesso ai server aggiunti dagli amministratori.
  • Richiedi approvazione amministrativa consente ai membri di proporre server privati, riservati a chi li richiede.

Ogni richiesta passa da una revisione.

  • Una richiesta indica solo il server e il suo endpoint. Finché è in attesa non contatta il server e non concede strumenti.
  • Gli amministratori esaminano esplicitamente strumenti, residenza e autenticazione. L’approvazione non concede mai accesso wildcard e non rende un server disponibile all’organizzazione.
  • L’approvazione fissa la configurazione esaminata e un elenco esplicito di nomi di strumenti, disponibili solo al richiedente. Il richiedente poi accede in Connessioni se il server usa OAuth.
  • I server privati supportano none (senza accesso esterno) oppure OAuth interattivo, non segreti statici personali.
  • Rimuovere una richiesta approvata revoca il server e le sue connessioni.

Conferma delle modifiche ai dati

Workspace distingue gli strumenti che leggono da quelli che modificano dati.

  • Si usa l’etichetta di sola lettura del connettore (readOnlyHint) quando la invia.
  • Uno strumento senza etichetta conta come modificante, a meno che un amministratore lo contrassegni come di sola lettura nelle impostazioni del connettore.

Prima che uno strumento modificante venga eseguito

Il membro vede in una scheda il connettore, lo strumento e gli argomenti esatti e sceglie Esegui o Non eseguire.

  • Nessuna risposta entro cinque minuti, la chiusura della chat o Stop valgono come rifiuto, e il modello viene informato che l’utente ha rifiutato.
  • In un’esecuzione pianificata di un agente non c’è nessuno a cui chiedere, quindi lì un connettore che chiede non esegue mai uno strumento modificante.

Impostazioni amministratore per connettore

  • Non chiedere mai: viene registrato nel registro di audit e mostrato sul connettore. Gli strumenti di sola lettura non chiedono mai.
  • Solo strumenti di lettura: il modello di IA non riceve alcuno strumento che modifica dati. Usalo, ad esempio, per un connettore con account condiviso.