Articoli su: Strumenti e interfacce
Questo articolo è disponibile anche in:

Buildagil openCDE MCP Server

Questa funzione è una versione precedente. È quindi possibile che non funzioni come previsto o che subisca ancora delle modifiche. Per il momento, l'accesso a questa funzione è riservato esclusivamente agli amministratori del progetto.



Per informazioni generali sull'utilizzo dell'intelligenza artificiale (IA) in buildagil, consultare il seguente articolo: Intelligenza artificiale.


Si prega di tenere presente quanto indicato in Condizioni d'uso quando si utilizza il server openCDE MCP. Si prega in particolare di gestire in modo responsabile i contenuti provenienti da buildagil e di garantire un'adeguata protezione dei dati. Buildagil non ha alcuna influenza sul trattamento dei contenuti al di fuori di buildagil (compresi gli ambienti di intelligenza artificiale esterni).


Possibilità

Il server buildagil openCDE MCP consente di utilizzare i contenuti presenti in buildagil tramite l'intelligenza artificiale (IA) attraverso il Model Context Protocol (MCP). In questo modo, i contenuti possono essere cercati, interrogati e analizzati in linguaggio naturale da applicazioni di IA esterne.


Il server buildagil openCDE MCP offre, tra le altre cose, le seguenti funzionalità:

  • Ricerca dei contenuti tra più progetti o all’interno di un singolo progetto
  • Visualizzare gli incarichi personali
  • Visualizzare le informazioni sul progetto
  • Visualizza incarichi e temi
  • Recuperare i documenti
  • Recuperare i metadati relativi ai documenti
  • Visualizzare le riunioni
  • Visualizza i traguardi fondamentali
  • Recupera utente
  • Utilizzare i link da buildagil


Le funzionalità vengono costantemente ampliate, come ad esempio la possibilità di visualizzare collegamenti, allegati, verbali delle riunioni e versioni dei documenti, nonché di creare o modificare contenuti.


Utilizzo

Il server buildagil openCDE MCP può essere utilizzato con qualsiasi ambiente di IA esterno che supporti lo standard MCP. Di seguito viene descritta la connessione con alcuni ambienti selezionati:


In altri ambienti di IA, è possibile stabilire la connessione tramite l'URL del server https://openapi.buildagil.com/mcp.


È possibile aprire e utilizzare un'applicazione IA esterna direttamente da buildagil tramite l'assistente IA. Per ulteriori informazioni al riguardo, consultare il seguente articolo: Assistente IA


Limitazioni

Sono supportati solo documenti con una dimensione massima di 50 MB. Per ogni documento vengono letti i primi 400'000 caratteri, in modo che la quantità di dati sia elaborabile dall'IA. Viene analizzato esclusivamente il testo; immagini e grafici non vengono presi in considerazione.


Sono supportati i seguenti tipi di documenti:

  • Documenti: PDF, DOCX, DOCM, ODT
  • Presentazioni: PPTX, ODP
  • Fogli di calcolo: XLSX, XLSM, CSV
  • Modelli: IFC
  • E-mail: EML, MSG
  • File di testo: TXT, JSON, XML, MD, HTML, HTM


Per tutti i tipi di documento non supportati (ad es. ONE, DOC, XLS, PPT, DWG, ZIP) vengono restituiti i metadati.


Autenticazione

L'autenticazione si basa sulla Microsoft Identity Platform e avviene tramite il flusso di codice di autorizzazione OAuth 2.0 con accesso basato sull'utente. Ogni accesso è associato a un singolo utente. Per ulteriori informazioni sul flusso di autorizzazione tramite codice, consultare il seguente articolo: Piattaforma di identità Microsoft e flusso di autorizzazione OAuth 2.0.


Per l'autenticazione sul server buildagil openCDE MCP, si prega di contattare l'assistenza indicando un URL di callback per ricevere l'ID client e il segreto client.


Visibilità e autorizzazioni

Per il recupero e la modifica dei contenuti tramite il server buildagil openCDE MCP si applicano le stesse impostazioni di visibilità e autorizzazioni basate sull'utente in vigore su buildagil. Maggiori dettagli sono disponibili all'indirizzo Visibilità e autorizzazioni.


L'accesso a buildagil tramite il server buildagil openCDE MCP può essere limitato in base al progetto. A tal fine, si prega di contattare l'assistenza. Nel prossimo futuro questa opzione sarà disponibile nelle impostazioni del progetto.


Dintorni

Per il server buildagil openCDE MCP è disponibile esclusivamente un ambiente di produzione.


Limiti di frequenza

Il server buildagil openCDE MCP utilizza un sistema di limitazione della velocità dinamico basato sugli utenti. In caso di utilizzo elevato, è possibile che la velocità venga limitata in base agli utenti.


Condizioni d'uso

Il server MCP viene messo a disposizione per gli scopi sopra descritti secondo il principio del “fair use”. Funzioni, strutture dei dati, endpoint e limitazioni tecniche o relative all’utilizzo possono essere adattati o modificati nell’ambito dell’ulteriore sviluppo. Le modifiche pianificate e attuate vengono pubblicate nel Novità e aggiornamenti.


Gli utenti del server MCP sono responsabili della conservazione sicura delle credenziali di accesso e dei token, nonché dell'utilizzo sicuro e corretto del server MCP. È vietato eludere i meccanismi di sicurezza, le restrizioni di accesso e i limiti di frequenza.


Gli utenti sono inoltre tenuti a gestire in modo responsabile e adeguato i dati ricevuti tramite il server MCP e a rispettare in ogni momento tutti i requisiti legali, di sicurezza e di protezione dei dati. Buildagil non ha alcuna influenza sul trattamento dei dati al di fuori di buildagil (compresi gli ambienti di IA esterni). Gli utenti sono inoltre responsabili di tutte le azioni avviate tramite il server MCP, indipendentemente dal fatto che siano avviate manualmente o in modo automatizzato (anche tramite IA).


Per il resto, si applicano le disposizioni contenute in Condizioni generali di utilizzo di buildagil.

Aggiornato il: 18/11/2026