Un server MCP remoto su Cloudflare offre ai client IA compatibili un’interfaccia ospitata verso strumenti selezionati. Portare online l’endpoint è il traguardo facile. Quello utile è un client che completa il compito previsto con l’autorità dell’utente corretto e un risultato che il gruppo operativo sappia spiegare.
Costruisci un server MCP remoto su Cloudflare intorno a un contratto di strumenti ristretto, identità autenticata e permessi espliciti a valle. Verifica scoperta, autorizzazione, esecuzione e recupero nei client che intendi supportare. Un endpoint MCP raggiungibile non dimostra che l’integrazione sia pronta per i record aziendali.
Immagina un assistente dei dipendenti che cerca un ordine in un sistema esistente. La prima versione legge soltanto lo stato dell’ordine. Una successiva potrebbe proporre una modifica dell’indirizzo. Sono permessi diversi con conseguenze di errore diverse, anche quando entrambi appaiono come strumenti nello stesso client.
Questa guida riguarda il confine dell’implementazione ospitata. Per la precedente decisione d’acquisto, consulta la nostra guida allo sviluppo di server MCP . Gli esempi sono progetti proposti, non affermazioni su un sistema cliente già distribuito.
Definire il contratto del server MCP remoto su Cloudflare
Cloudflare mantiene una guida ai server MCP remoti . Usa la guida attuale come punto di partenza per la distribuzione, poi blocca le dipendenze scelte e registra trasporto e client supportati. Non combinare frammenti di generazioni SDK diverse senza verificare il risultato.
Un nome utile descrive l’operazione aziendale consentita. Per la ricerca dell’ordine, gli input devono identificare l’ordine e il contesto realmente necessario. Evita di accettare database scelti dall’utente, interrogazioni arbitrarie o URL a valle soltanto per mantenere generico il server.
L’output deve distinguere ricerca completata, fonte indisponibile e operazione rifiutata. Restituire un oggetto vuoto per ogni errore spinge l’assistente a inventare una spiegazione. Restituisci un risultato delimitato che il client possa presentare accuratamente senza esporre credenziali interne o record estranei.
| Elemento del contratto | Esempio della ricerca ordini | Motivo per specificarlo |
|---|---|---|
| Input | Riferimento dell’ordine | Limita la superficie interrogabile |
| Autorità | Dipendente autenticato e ambito dell’account | Impedisce letture tra account diversi |
| Risultato | Stato, momento dell’osservazione e contesto consentito | Rende interpretabile la risposta |
| Rifiuto | Esito sicuro ed esplicito | Evita di fingere che un record negato sia assente |
| Traccia | Riferimento opaco dell’operazione | Permette indagini senza copiare il record |
Separare identità del chiamante e credenziali del servizio
Il server ospitato può richiedere una credenziale per l’API degli ordini. Questa credenziale di servizio non è l’identità del chiamante. Un server che usa credenziali potenti a valle deve comunque applicare i limiti sui record richiesti dall’utente corrente.
La documentazione di autorizzazione MCP di Cloudflare descrive il livello di autorizzazione per le connessioni remote. Segui il flusso di accesso e token del client previsto, senza presumere che un token accettato da un percorso sia appropriato per ogni destinazione.
Ricava l’ambito del cliente o dell’organizzazione da informazioni di sessione attendibili. Non permettere che un argomento dello strumento, come customer_id, allarghi l’accesso senza confrontarlo con tale ambito. L’affermazione del modello che un dipendente sia un responsabile non costituisce una decisione di autorizzazione.
Ricontrolla l’accesso durante l’esecuzione. Uno strumento scoperto in precedenza può non essere più consentito dopo un cambio di ruolo o una revoca. Registra che cosa accade a una connessione esistente e a una nuova quando tale autorità viene rimossa.
Separare configurazione di distribuzione e politica degli strumenti
Gestisci deliberatamente le configurazioni di sviluppo e produzione. Associa ogni ambiente ai sistemi a valle previsti e tieni i segreti fuori da file sorgente, prompt e descrizioni degli strumenti. Un client di prova non deve ottenere accesso alla produzione perché una configurazione copiata conserva l’endpoint sbagliato.
Usa un registro di distribuzione che identifichi revisione del sorgente, blocco delle dipendenze, ambiente e modifica di configurazione. Se una nuova descrizione induce il client a selezionare inaspettatamente un’operazione, il gruppo deve sapere esattamente che cosa sia cambiato.
Le descrizioni fanno parte dell’interfaccia del prodotto. Spiega che cosa fa lo strumento, il significato del risultato e che cosa non può stabilire. Non ordinare al modello di trattare testo esterno restituito come autorità per effettuare chiamate estranee.
Per il server degli ordini, mantieni lettura e modifica come capacità distinte. Uno strumento ampio che passa da lettura a scrittura in base a un parametro opzionale rende più difficili revisione e controllo degli accessi. Operazioni esplicite rendono più interpretabili anche le prove di compatibilità.
Verificare il percorso effettivo del client
Cloudflare documenta le prove dei client dei server remoti . Un ispettore del protocollo è utile, ma il client di produzione ha propri comportamenti di scoperta, autorizzazione e presentazione. Includi ogni client nominato nell’impegno di assistenza.
Verifica il percorso ordinario da una connessione nuova. Poi prova sessione scaduta, accesso revocato, fonte indisponibile e input malformato. Osserva ciò che vede l’utente oltre a ciò che registra il server.
| Caso di prova | Esito applicativo atteso | Prova |
|---|---|---|
| Ricerca consentita | Restituzione del contesto corretto dell’ordine | Ambito del chiamante e risultato della fonte |
| Ordine di un altro account | Accesso rifiutato | Nessun contenuto non autorizzato |
| Timeout della fonte | Spiegazione del problema di disponibilità | Riferimento dell’operazione e fase del guasto |
| Chiamante revocato | Ulteriore uso rifiutato | Esiti di connessioni vecchie e nuove |
| Input non valido | Convalida fallita prima del lavoro a valle | Rifiuto senza richiesta alla fonte |
Usa record sintetici con etichette inequivocabili. Se i dati sono troppo simili, il risultato dell’account sbagliato può sembrare plausibile e sfuggire alla revisione. Il rapporto di accettazione deve rendere evidente un errore di autorizzazione anche a chi non ha scritto il server.
Distinguere successo dello strumento e successo aziendale
Uno scambio MCP riuscito può comunque restituire uno stato dell’ordine obsoleto o un rifiuto a valle. Definisci il successo rispetto al sistema sorgente e al compito del dipendente. L’assistente non deve dire che una modifica è completa soltanto perché uno strumento è terminato senza eccezioni.
Per un futuro strumento di modifica dell’indirizzo, conserva il riferimento dell’operazione della destinazione e lo stato risultante del record. Se la risposta va persa, esamina quel riferimento prima di reinviare. Ripetere il trasporto e ripetere in sicurezza un’operazione aziendale sono questioni diverse.
Pianificare il recupero prima degli strumenti di scrittura
Inizia con accesso di sola lettura quando produce un risultato utile. Questo riduce la superficie iniziale di recupero e permette di convalidare identità e scelta degli strumenti prima di introdurre impegni.
Per le scritture specifica approvazione, scadenza, gestione dei duplicati ed esiti incerti. L’approvazione deve riferirsi alla modifica effettivamente proposta e al record destinatario. Approvare un’istruzione vaga non deve autorizzare una successiva operazione sostanzialmente diversa.
Mantieni un modo per disattivare uno strumento senza perdere le prove necessarie a riconciliare il lavoro già inviato. Rimuovere un’operazione dalla scoperta non dimostra che il lavoro accettato in precedenza si sia fermato.
Che cosa determina i costi di sviluppo e assistenza?
I principali fattori sono qualità delle API a valle, corrispondenza delle identità, varietà dei client e conseguenze di ogni operazione. Una lettura tramite API documentata è un progetto diverso da un’integrazione che coordina modifiche tra più sistemi.
Chiedi una proposta in GBP che separi impostazione del protocollo, autorizzazione, implementazione degli strumenti, accettazione e passaggio operativo. Chiedi quali ambienti e client siano inclusi. Un preventivo basso che esclude compatibilità dei client o guasti a valle non è confrontabile con una proposta completa.
| Area di lavoro | Risultato di accettazione | Fonte comune di lavoro aggiuntivo |
|---|---|---|
| Identità | Prove dei permessi dal chiamante al record | Ruoli incoerenti tra sistemi |
| Progettazione degli strumenti | Input e risultati stabili e convalidati | Semantica a valle non documentata |
| Supporto dei client | Percorsi registrati nei client nominati | Trasporto o accesso differenti |
| Recupero | Procedura provata per esiti incerti | Assenza di riferimenti delle operazioni alla destinazione |
| Manutenzione | Responsabilità e processo di aggiornamento | Dipendenze non bloccate o ambiente di prova assente |
L’hosting è solo una voce di budget. Includi log, utilizzo delle API a monte, monitoraggio, manutenzione delle dipendenze e assistenza. Verifica le tariffe attuali sul carico scelto prima di stimare costi ricorrenti; il solo numero di strumenti non stabilisce il costo d’uso.
Commissionare un endpoint gestibile da un’altra persona
Il passaggio deve permettere a un altro tecnico di distribuire il server, ruotare una credenziale di prova, riprodurre un rifiuto di accesso e tracciare una ricerca fallita. Includi client supportati, blocchi delle dipendenze e percorso per segnalare risultati errati.
Il responsabile del sistema aziendale deve approvare il significato di ogni operazione. Chi gestisce la distribuzione deve approvare recupero e processo di modifica. Coinvolgere presto queste persone evita un endpoint tecnicamente completo di cui nessuno gestisce il comportamento reale.
Possiamo delimitare il server con il nostro progetto pilota di integrazione IA . Porta API sorgente, client previsto, attività di esempio e regole di accesso. Richiedi una proposta di distribuzione MCP che includa identità, accettazione e passaggio di consegne oltre alla dimostrazione dell’endpoint.
Domande frequenti
Che cosa rende remoto un server MCP? Il server è ospitato separatamente dal client locale dell’utente ed è raggiunto tramite una connessione remota supportata. Le questioni importanti comprendono supporto del trasporto, autenticazione e modalità con cui il servizio raggiunge i sistemi aziendali collegati.
Distribuire su Cloudflare rende automaticamente sicuri gli strumenti? No. L’applicazione deve comunque convalidare gli input, stabilire l’identità del chiamante, applicare i permessi a valle e controllare l’autorità degli strumenti. L’hosting non determina quale dipendente possa leggere o modificare un record aziendale.
Un server può supportare più client IA? Può essere progettato per farlo, ma verifica ogni client nominato. Scoperta, autorizzazione e presentazione possono differire. L’impegno di assistenza deve dichiarare quali client e configurazioni siano stati verificati.
La prima versione dovrebbe includere strumenti di scrittura? Soltanto quando il primo compito utile li richiede e le regole di approvazione e recupero sono chiare. Un’operazione di sola lettura è spesso un punto di partenza pratico per convalidare identità e integrazione della fonte.
Che cosa deve accadere dopo un timeout di scrittura? Conserva il riferimento dell’operazione e ispeziona la destinazione prima di ripetere. La modifica potrebbe essere stata completata anche se la risposta è andata persa. Se non puoi accertare l’esito, assegnalo a un operatore nominato.
Che cosa comprende il passaggio di consegne MCP? Includi sorgente, blocchi delle dipendenze, configurazione degli ambienti, contratti degli strumenti, risultati di accettazione dei client, responsabilità delle credenziali e manuale di recupero. Un altro tecnico deve poter riprodurre sia un compito riuscito sia un’operazione negata.
Come stimare il costo di implementazione? Definisci prima sistemi a valle, corrispondenza delle identità, client e operazioni. Chiedi ambiti separati per analisi, implementazione, accettazione e assistenza in GBP. Un prezzo per strumento nasconde la complessità dei permessi e degli esiti aziendali incerti.