Eseguire il server MCP di ONLYOFFICE DocSpace in remoto: cosa significa e come iniziare

Il server MCP di ONLYOFFICE DocSpace è il componente che trasforma DocSpace da semplice strumento di collaborazione basato su UI in una soluzione automatizzabile e guidata dall’AI. Gli aggiornamenti recenti rendono semplicissimo eseguire il server MCP di DocSpace su una macchina remota e permettere a più app, bot o agenti AI di collegarsi in modo sicuro. Questo approccio centralizza l’automazione e semplifica le integrazioni tra team e strumenti.

Qui sotto scoprirai cos’è un server MCP remoto di DocSpace, perché eseguirlo in remoto, come collegarsi al volo, le migliori pratiche di sicurezza e casi d’uso pratici.

Cos’è un server MCP su una macchina remota?

Il server MCP remoto di DocSpace è semplicemente il server MCP di DocSpace in esecuzione su un server raggiungibile via HTTP. Espone un insieme di strumenti MCP (operazioni sui file, gestione delle stanze, generazione di documenti, ecc.) che i client — agenti AI, script di automazione o app — possono chiamare tramite HTTP.

Perché eseguire il server MCP in remoto?

Un server MCP remoto offre diversi vantaggi rispetto a uno locale. Eccone alcuni:

• Manutenzione centralizzata. Riduce il carico operativo, migliora sicurezza e coerenza e accelera aggiornamenti e risoluzione dei problemi.
• Flussi di lavoro prevedibili. Con un server MCP distribuito in remoto, la disponibilità degli strumenti è gestita centralmente. Il proprietario del server decide quali strumenti esporre, garantendo un’esperienza prevedibile per chiunque si connetta.
• Automazione coerente per ogni team. Marketing, HR, prodotto, sviluppo, amministrazione: tutti usano lo stesso set di strumenti.
• Facile per gli utenti finali. Nessuna configurazione manuale = onboarding più rapido e meno errori di configurazione.

Come funzionano le connessioni remote

Collegarsi a un server MCP remoto di DocSpace è semplice. Esegui il server MCP su qualsiasi macchina accessibile via HTTP: un’istanza cloud, una VM o un container. Poi lo colleghi al tuo DocSpace.

Dopodiché, condividi semplicemente l’URL del server MCP con il tuo team o con gli strumenti che devono accedervi, usando OAuth o chiavi API, e il server MCP gestirà tutta la comunicazione con DocSpace per loro.

Da quel momento possono eseguire attività, caricare file, creare stanze, generare documenti o avviare flussi di lavoro automatizzati senza installazioni locali o configurazioni complesse. Tutto passa attraverso un unico servizio centrale e sicuro, un punto di connessione pulito che mantiene le integrazioni semplici, scalabili e facili da gestire.

Architettura e trasporti supportati

Un server MCP remoto espone il Model Context Protocol tramite uno o più trasporti, così che i client AI possano scoprire e chiamare gli strumenti:

• Streamable HTTP, il trasporto moderno consigliato per risposte in streaming.
• Server-Sent Events (SSE), supportato per i client precedenti che si basano su SSE.

Il supporto di entrambi i trasporti aumenta la flessibilità di connessione perché estende la compatibilità a un numero maggiore di client senza abbandonare quelli precedenti.

Come collegarsi a un server MCP remoto pubblico

L’istanza pubblica è disponibile su https://mcp.onlyoffice.com/mcp per i client che supportano il trasporto moderno Streamable HTTP e su https://mcp.onlyoffice.com/sse per i client che supportano solo il trasporto SSE precedente. Quando possibile, è preferibile usare Streamable HTTP.

L’istanza pubblica supporta l’autenticazione tramite OAuth, API key, Personal Access Token (PAT), coppia nome utente/password o header “Authorization” diretto. Quando possibile, è preferibile usare l’autenticazione OAuth.

L’istanza pubblica fornisce accesso a tutti gli strumenti disponibili per impostazione predefinita. La selezione degli strumenti può essere personalizzata usando parametri di query o header personalizzati. Tuttavia, quando supportato, è preferibile usare l’interfaccia del client MCP per la configurazione degli strumenti.

Per rendere tutto più pratico, ecco alcuni esempi semplici che mostrano come i client si collegano a un server MCP remoto pubblico. Riflettono i metodi di autenticazione attualmente supportati.

OAuth con app pubblica. Connessione tramite l’app OAuth pubblica senza credenziali personalizzate: https://mcp.onlyoffice.com/mcp

OAuth con app personalizzata. Connessione usando il proprio client ID e client secret OAuth: https://mcp.onlyoffice.com/mcp (ID client e secret richiesti)

Chiave API con header. Connessione usando una chiave API e l’URL base forniti in header personalizzati:

• X-Mcp-Base-Url: https://your-instance.onlyoffice.com/
• X-Mcp-Api-Key: sk-a499e…

Chiave API con header Authorization. Connessione usando una chiave API nell’header Authorization e l’URL base come parametro di query:

• https://mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com
• Authorization: Bearer sk-a499e…

Nome utente e password nell’URL. Connessione usando credenziali codificate nell’URL e l’URL base come parametro di query:

• https://henry.milton%40onlyoffice.com:password@mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com/

Questo offre opzioni flessibili e sicure per autenticare strumenti o flussi di lavoro con l’istanza pubblica del server MCP.

Prova l’automazione dei flussi di lavoro in ONLYOFFICE DocSpace

Eseguire il server MCP di ONLYOFFICE DocSpace in remoto rende DocSpace una piattaforma di collaborazione programmabile. Grazie a OAuth, a un hosting flessibile e a connessioni semplici per strumenti e agenti, MCP funge da livello di automazione affidabile per tutta l’organizzazione.

Che tu abbia un piccolo team o una grande azienda, il server MCP ti permette di semplificare il lavoro, automatizzare le attività ripetitive e migliorare l’esperienza in DocSpace.

INIZIA OGGI