Comprensione della specifica MCP

​

Cosa sono i Server MCP Personalizzati?

I server MCP personalizzati ti consentono di estendere le capacità di integrazione di Manus oltre i connettori predefiniti. Se la tua organizzazione utilizza strumenti interni, API proprietarie o servizi specializzati non coperti dai connettori MCP standard, puoi creare un server personalizzato che colleghi Manus a tali sistemi. Un server MCP personalizzato funge da ponte tra Manus e la tua infrastruttura interna, consentendo gli stessi flussi di lavoro multi-app senza interruzioni che ottieni con i connettori predefiniti, ma adattati ai tuoi strumenti e requisiti specifici.

​

Perché creare Server MCP Personalizzati?

​

Sistemi Interni

Molte organizzazioni si affidano a strumenti personalizzati, database interni o software proprietario. I server MCP personalizzati consentono a Manus di integrarsi con questi sistemi, portando i dati interni nei tuoi flussi di lavoro di AI. Esempi:

• CRM interno o database clienti
• Strumenti proprietari di gestione progetti
• Piattaforme di analisi personalizzate
• Sistemi legacy con API

​

Servizi Specializzati

Alcuni servizi di terze parti non dispongono di connettori MCP predefiniti. Se utilizzi uno strumento specializzato o un servizio di nicchia, puoi creare un server personalizzato per connetterlo a Manus. Esempi:

• Software specifico per l’industria
• Servizi regionali non coperti da connettori standard
• Piattaforme emergenti senza integrazioni ufficiali

​

Logica di Business Personalizzata

I server MCP personalizzati possono implementare logica specifica di business, trasformazioni di dati o regole di convalida che vanno oltre semplici chiamate API. Ciò ti consente di applicare politiche e flussi di lavoro organizzativi all’interno delle integrazioni Manus. Esempi:

• Flussi di lavoro di approvazione prima degli aggiornamenti dei dati
• Convalida dei dati rispetto agli standard interni
• Autenticazione personalizzata o requisiti di sicurezza
• Processi a più passaggi specifici per la tua organizzazione

​

Come funzionano i Server MCP Personalizzati

Un server MCP personalizzato è un servizio leggero che implementa la specifica del Protocollo di Contesto del Modello (Model Context Protocol). Espone endpoint che Manus può chiamare per leggere dati, eseguire azioni o implementare logica personalizzata all’interno dei tuoi sistemi.

​

Architettura

Il tuo Sistema Interno ↔Server MCP Personalizzato ↔Manus Il server MCP si posiziona tra Manus e i tuoi sistemi interni, traducendo le richieste di Manus in azioni all’interno dei tuoi strumenti e restituendo i risultati in un formato che Manus comprende.

​

Protocollo

I server MCP personalizzati implementano un protocollo standardizzato che definisce:

• Strumenti: Azioni che Manus può eseguire (ad es., “get_customer_data”, “update_project_status”)
• Risorse: Dati che Manus può leggere (ad es., documenti, record, file)
• Prompt: Modelli predefiniti per operazioni comuni

​

Creazione di un Server MCP Personalizzato

​

Prerequisiti

• Accesso API ai sistemi che desideri integrare
• Ambiente di sviluppo (Node.js, Python o qualsiasi linguaggio in grado di eseguire un web server)
• Understanding of the MCP specification (disponibile nella documentazione Manus)

​

Implementazione di Base

Un server MCP personalizzato minimo include:

1. Endpoint del server: Un servizio web che risponde alle richieste del protocollo MCP
2. Definizioni degli strumenti: Descrizioni delle azioni che Manus può eseguire
3. Autenticazione: Gestione sicura delle credenziali e delle chiavi API
4. Gestori delle richieste: Logica per eseguire azioni e restituire risultati

​

Esempio: Integrazione CRM Interno

Ecco un esempio concettuale di un server MCP personalizzato per un CRM interno: Strumenti Esposti:

• get_customer_info(customer_id): Recupera i dettagli del cliente
• update_customer_notes(customer_id, notes): Aggiungi note a un record cliente
• search_customers(query): Cerca nel database clienti
• create_follow_up_task(customer_id, task_description, due_date): Crea un’attività

Autenticazione: Chiave API o token OAuth per il CRM interno Distribuzione: Ospitato sulla tua infrastruttura o ambiente cloud sicuro Una volta distribuito, connetti questo server personalizzato a Manus e apparirà insieme ai connettori predefiniti. Puoi quindi utilizzare prompt in linguaggio naturale come:

• “Ottieni le informazioni del cliente per l’ID cliente 12345”
• “Cerca clienti nell’area di San Francisco”
• “Aggiorna le note del cliente 67890 con la nostra conversazione più recente”

​

Connessione di un Server MCP Personalizzato

​

Passaggio 1: Distribuisci il tuo Server

Ospita il tuo server MCP personalizzato sull’infrastruttura che controlli. Assicurati che sia accessibile tramite HTTPS e protetto con misure appropriate.

​

Passaggio 2: Aggiungi a Manus

In Manus, vai suImpostazioni → Integrazioni → Server MCP Personalizzati e fai clic suAggiungi Server.

​

Passaggio 3: Fornisci i Dettagli del Server

Inserisci le seguenti informazioni:

• Nome del Server: Un nome descrittivo (ad es., “CRM Interno”, “Piattaforma di Analisi”)
• URL del Server: L’endpoint HTTPS dove è ospitato il tuo server MCP
• Autenticazione: Chiave API richiesta, token Bearer o altre credenziali

​

Passaggio 4: Testa la Connessione

Manus verificherà di potersi connettere al tuo server e recuperare l’elenco degli strumenti disponibili.

​

Passaggio 5: Inizia a Utilizzare

Una volta connessi, i tuoi strumenti personalizzati appariranno nelle integrazioni disponibili di Manus. Puoi farvi riferimento nei prompt proprio come faresti con i connettori predefiniti.

​

Considerazioni sulla Sicurezza

​

Autenticazione

I server MCP personalizzati dovrebbero implementare un’autenticazione robusta:

• Utilizza chiavi API, token OAuth o altri metodi sicuri
• Non esporre mai le credenziali negli URL o nei log
• Ruota regolarmente le credenziali

​

Autorizzazione

Implementa controlli di autorizzazione appropriati:

• Verifica che l’utente richiedente abbia l’autorizzazione per accedere ai dati
• Applica il Controllo degli Accessi Basato sui Ruoli (RBAC) ove applicabile
• Registra tutti i tentativi di accesso per l’audit

​

Trasferimento Dati

• Utilizza HTTPS per tutte le comunicazioni
• Crittografa i dati sensibili a riposo e in transito
• Implementa la limitazione della frequenza (rate limiting) per prevenire abusi

​

Sicurezza della Rete

• Distribuisci il server MCP all’interno del perimetro della tua rete sicura
• Utilizza firewall e controlli di accesso per limitare chi può raggiungere il server
• Per integrazioni altamente sensibili, considera l’utilizzo di VPN o connessioni di rete dedicate

​

Best Practice

​

Progettazione degli Strumenti

Mantieni gli strumenti focalizzati: Ogni strumento dovrebbe eseguire un’azione chiara. Invece di un singolo strumento “manage_customer”, creane di separati per “get_customer”, “update_customer” e “delete_customer”. Fornisci descrizioni chiare: Manus utilizza le descrizioni degli strumenti per capire quando utilizzare ciascuno strumento. Scrivi descrizioni chiare e specifiche che spieghino cosa fa lo strumento e quando è applicabile. Gestisci gli errori in modo elegante: Restituisci messaggi di errore significativi che aiutino Manus (e l’utente) a capire cosa è andato storto e come risolverlo.

​

Prestazioni

Ottimizza il tempo di risposta: Manus attende la risposta del server MCP. Mantieni le operazioni veloci memorizzando i dati nella cache, utilizzando query efficienti ed evitando elaborazioni non necessarie. Implementa i timeout: Imposta timeout ragionevoli per le chiamate API per evitare che Manus attenda indefinitamente se il tuo sistema interno è lento o non risponde. Utilizza operazioni asincrone per attività a lunga esecuzione: Se un’operazione richiede più di qualche secondo, considera di restituire immediatamente un ID attività e di fornire uno strumento separato per verificarne lo stato.

​

Monitoraggio

Registra tutte le richieste: Tieni traccia di ciò che Manus sta richiedendo e di come sta rispondendo il tuo server. Ciò aiuta a eseguire il debug e a comprendere i modelli di utilizzo. Monitora le prestazioni: Tieni traccia dei tempi di risposta, dei tassi di errore e del volume di utilizzo per identificare i problemi prima che abbiano un impatto sugli utenti. Imposta avvisi: Ricevi una notifica se il tuo server MCP smette di rispondere o inizia a restituire errori.

​

Esempi di Casi d’Uso

​

Base di Conoscenza Interna

Scenario: La tua organizzazione dispone di una wiki interna o di una base di conoscenza contenente politiche aziendali, procedure e documentazione. Server MCP Personalizzato: Fornisce strumenti per cercare nella base di conoscenza, recuperare articoli specifici e trovare documentazione correlata. Flusso di Lavoro Manus: “Cerca nella nostra base di conoscenza interna la politica di rimborso spese e riassumi i punti chiave.”

---

​

Piattaforma di Analisi Personalizzata

Scenario: Hai una piattaforma di analisi proprietaria che tiene traccia di metriche aziendali non disponibili negli strumenti standard. Server MCP Personalizzato: Espone strumenti per interrogare le metriche, generare report e recuperare dati storici. Flusso di Lavoro Manus: “Estrai i dati sui costi di acquisizione dei clienti per il Q4 e crea un’analisi delle tendenze confrontandoli con il Q3.”

---

​

Integrazione di Sistemi Legacy

Scenario: La tua organizzazione si affida a un sistema legacy senza API o integrazioni moderne. Server MCP Personalizzato: Funge da wrapper attorno al sistema legacy, traducendo le chiamate API moderne in un formato compreso dal sistema legacy. Flusso di Lavoro Manus: “Verifica i livelli di inventario per il prodotto SKU 98765 nel sistema legacy e, se lo stock è inferiore a 100 unità, crea una richiesta di riordino.”

---

​

Flussi di Lavoro di Approvazione a Più Passaggi

Scenario: La tua organizzazione richiede flussi di lavoro di approvazione per determinate azioni (ad es. richieste di budget, accesso ai dati). Server MCP Personalizzato: Implementa strumenti per creare richieste di approvazione, verificarne lo stato ed eseguire azioni approvate. Flusso di Lavoro Manus: “Crea una richiesta di budget di $50.000 per la campagna di marketing e notifica il team finanziario per l’approvazione.”

​

Domande Frequenti