> ## Documentation Index > Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # MCP > Collega Claude Desktop o un altro client MCP a Flowglad, trova l'URL dell'organizzazione, applica un template e leggi la gestione dei dati. Collega a Flowglad un agente compatibile con MCP per lavorare con le conoscenze di business e il contesto operativo della tua organizzazione. Il connettore può trovare e modificare Pages, leggere file e record connessi, creare Tasks, gestire Skills riutilizzabili e creare o eseguire Automations. Gli strumenti disponibili dipendono dall'identità connessa, dai permessi concessi e dalle funzionalità del prodotto abilitate. ## Applicare un template Quando `templates.apply` è disponibile in `tools/list`, fornisci un `templateId` pubblicato e uno `spaceId` esistente per creare tutte le risorse del template. Applications, Automations e le normali copie di File appartengono a quello Space; le Skills appartengono all'organizzazione. I file usano i nomi configurati nella radice dello Space e non sovrascrivono mai i file esistenti. Un conflitto di nomi fa fallire quel componente, mentre i componenti indipendenti possono proseguire. Il completamento di un file indica che i byte e i metadati sono stati salvati in modo permanente; non attende l'indicizzazione. Facoltativamente, fornisci `connections` come array di oggetti `{ connector, connectionId }`, con al massimo una connessione per provider. Le connessioni fornite devono essere accessibili, compatibili e, se richiesto, già assegnate allo Space. Le connessioni omesse lasciano le risorse in attesa di configurazione. La risposta consiglia le connessioni idonee oppure, se non ce ne sono di disponibili, la creazione di una connessione. La creazione viene eseguita in un unico task Trigger.dev in ordine di dipendenza, con gli esiti dei componenti registrati nei metadati e nell'output del task. I tentativi automatici dell'intero task sono disabilitati; un task non riuscito o interrotto può lasciare risorse parziali. La risposta conferma che la creazione è stata messa in coda e include i componenti pianificati e i consigli sulle connessioni; non conferma che la creazione delle risorse sia terminata. Usa gli strumenti list/get delle risorse per trovarle e ispezionarle. Le risorse create correttamente rimangono anche se un altro componente fallisce. L'applicazione di un template rimanda la verifica eseguibile e non attiva né esegue le relative risorse. Ogni chiamata di apply crea nuove copie, anche in caso di nuovi tentativi. Usa gli strumenti delle risorse per ispezionare ciò che è stato creato. ## Prima di connetterti Ti servono: * Un account Flowglad con accesso all'organizzazione che vuoi usare. * L'URL MCP di produzione della tua organizzazione. * Un agente o client che supporti un server MCP remoto tramite Streamable HTTP e OAuth. * I permessi di organizzazione e di Space necessari per il lavoro che intendi svolgere. * Eventuali Connection sorgente o file già disponibili nello Space pertinente. La sezione dei prezzi pubblicata sulla [homepage di Flowglad](https://www.flowglad.com/) include MCP nei piani Free, Plus e Max. Restano comunque validi i permessi di organizzazione e di Space, la concessione OAuth e l'accesso alle sorgenti connesse. Le connessioni a sistemi di business esterni devono essere configurate in Flowglad ed esposte allo Space previsto prima che l'agente possa usarle. Consulta [Connettori](/docs/it/connectors.md) e [Spaces](/docs/it/spaces.md). ## Trova l'URL della tua organizzazione Il connettore di produzione usa un URL specifico per l'organizzazione: ```text theme={null} https://dashboard.flowglad.com/api/mcp/orgs/{orgId} ``` Sostituisci `{orgId}` con l'ID effettivo della tua organizzazione Flowglad. Mantieni l'ID completo, incluso il prefisso `org_`. Non inserire le parentesi graffe né un ID di organizzazione inventato. In Flowglad, apri **Settings** → **MCP** → **Add MCP Connection** → **Claude** → **Website**. Copia l'URL MCP dell'organizzazione mostrato lì. Usa le istruzioni **Website** per un URL remoto; la scheda separata **Desktop app** contiene le istruzioni di configurazione da riga di comando. Se non riesci ad accedere a queste impostazioni, chiedi al tuo amministratore Flowglad o al [supporto](mailto:support@flowglad.com). Usa l'URL dell'organizzazione per questo connettore. Un URL specifico di una connessione può esporre un insieme di strumenti più ristretto e non è intercambiabile con l'URL dell'organizzazione descritto qui. ## Connettersi da Claude Desktop Guarda il [video di configurazione di Claude Desktop](https://youtu.be/6qqSnrqDJ2o) oppure segui i passaggi seguenti. [Come collegare Flowglad a Claude Desktop](https://www.youtube.com/embed/6qqSnrqDJ2o) Usa il flusso dei connettori personalizzati di Claude Desktop per aggiungere Flowglad e autorizzare l'accesso al tuo account. **1. Apri il modulo del connettore personalizzato.** In Claude Desktop, vai su **Customize** → **Connectors** → **+ Add** → **Add Custom Connector**. **2. Aggiungi il connettore Flowglad.** Inserisci **Flowglad** come nome del connettore oppure scegli un altro nome. Incolla l'URL MCP completo della tua organizzazione nel campo URL. Puoi copiarlo da [Settings > MCP](https://dashboard.flowglad.com/settings/mcp). Dovrebbe avere questo aspetto: `https://dashboard.flowglad.com/api/mcp/orgs/org_...` Non modificare nessun'altra impostazione del connettore. Seleziona **Add** per continuare. In alcune versioni Claude Desktop può etichettare questo pulsante come **Continue**. **3. Concedi a Claude l'accesso a Flowglad.** Prosegui nel flusso di connessione per autorizzare Claude ad accedere al tuo account Flowglad. Quando richiesto, accedi, conferma l'organizzazione Flowglad prevista e rivedi l'accesso richiesto prima di autorizzarlo. Al termine del flusso, torna a Claude Desktop e verifica che la connessione Flowglad sia disponibile. Chiedi a Claude di controllare la connessione Flowglad e di elencare gli Spaces a cui puoi accedere. OAuth Dynamic Client Registration è il metodo di connessione previsto. Non aggiungere password, token di accesso, chiavi API o client secret all'URL del server. Queste istruzioni descrivono come collegare Flowglad direttamente come connettore personalizzato; la disponibilità nella directory è una questione separata. ## Collegare un altro client MCP Aggiungi lo stesso URL dell'organizzazione come server MCP remoto Streamable HTTP. Completa il flusso OAuth del client con il tuo account Flowglad, quindi verifica l'organizzazione e gli strumenti disponibili. Il supporto varia a seconda del client. Una connessione al server riuscita non significa che il client importi automaticamente le Skills di Flowglad. L'estensione di discovery delle Skills e lo strumento `skills.list` sono interfacce diverse. Consulta [Skills](/docs/it/skills.md) per il comportamento supportato di discovery e gestione dei pacchetti. ## Gestione dei dati L'uso dell'MCP di Flowglad è regolato dalla [Privacy Policy di Flowglad](https://www.flowglad.com/privacy-policy). Gli amministratori dell'organizzazione possono vedere tutte le chiamate agli strumenti MCP effettuate verso la propria organizzazione in [Settings > Audit](https://dashboard.flowglad.com/settings/audit). ## Risoluzione dei problemi | Sintomo | Passaggio successivo | | - | - | | La connessione fallisce prima dell'accesso | Controlla l'URL HTTPS completo e l'ID dell'organizzazione. Verifica che il client supporti MCP remoto con OAuth. | | L'accesso riesce ma il lavoro non è disponibile | Controlla l'organizzazione selezionata, la membership dello Space, la concessione MCP e le Connection disponibili nello Space. | | Uno strumento di scrittura non è disponibile o viene negato | Verifica i permessi di organizzazione e di Space richiesti. Riconnettiti se è necessario uno scope OAuth appena concesso. | | Un provider connesso non può essere letto | Verifica che la sua autorizzazione sia attiva e che la Connection sia esposta allo Space previsto. | | Una Page o un file non viene trovato | Verifica lo Space corretto, il suo accesso diretto e collegato e che la sorgente sia ancora disponibile. | | Un'operazione restituisce un ID di job o di run | Controlla lo stato finale del ciclo di vita o della run prima di segnalare il successo o di riprovare. | | Una scrittura va in timeout | Verifica se è stata completata prima di riprovare. Alcune operazioni creano un nuovo record o accodano lavoro a ogni chiamata. | | L'accesso scade o viene revocato | Riconnettiti tramite OAuth e verifica l'organizzazione e la concessione previste. Se la riconnessione continua a fallire, contatta il supporto. | Per informazioni generali sulla sicurezza, consulta [Sicurezza](/docs/it/security.md) e il nostro [Trust Center](https://trust.flowglad.com). In caso di problemi di connessione, [contattaci](mailto:support@flowglad.com). Quando contatti il supporto, includi l'orario, il client, lo strumento interessato, il codice di errore sicuro e l'ID della richiesta, se disponibile. Non includere mai password, bearer token, cookie, URL firmati di upload/download o dati dei clienti. ## Related topics - [Skill](/docs/it/skills.md) - [Benvenuto](/docs/it/agents/introduction.md) - [Automations](/docs/it/automations.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.