# MCP di AIsuru: quali sono e come si attivano Ora vedrai come configurare correttamente i parametri per ogni server MCP disponibile su AIsuru. ## Come configurare un MCP Per configurare un MCP nel tuo Agente: 1. Accedi al pannello di gestione del tuo Agente; 2. Dalla barra laterale, accedi alla sezione MCP; 3. Premi sull'MCP che vuoi attivare; 4. Compila i campi richiesti; 5. Clicca su "Crea MCP" per salvare la configurazione. Ora vedremo come creare un MCP ## 0. Creare un MCP personalizzato Utilizza questa procedura se l'MCP desiderato non è presente tra quelli preconfigurati. Dopo aver cliccato su Aggiungi un MCP personalizzato, si aprirà una finestra modale intitolata "Crea Nuovo MCP" potrai compilare diversi campi. #### Parametri di configurazione: * **Nome (obbligatorio):** digita un nome identificativo (es. "Custom MCP Server", "Integrazione CRM"); * **Descrizione (obbligatorio):** digita una descrizione dettagliata di cosa fa l'MCP; * **Prompt (facoltativo):** inserisci istruzioni su come l'agente deve usare questo MCP; * **Token di autenticazione (facoltativo):** incolla qui dentro il token di autenticazione dal tuo servizio esterno; * **URL (obbligatorio):** inserisci qua l'url identificativo del tuo MCP server. #### Salvare l'MCP personalizzato 1. Controlla che tutti i campi obbligatori (Nome, Descrizione, URL) siano compilati; 2. Clicca sul pulsante "Crea MCP" in basso a destra; 3. Attendi il messaggio di conferma. Per annullare: Cliccate su "Annulla" o sulla X in alto a destra. ## 1. AIsuru MCP Server Permette l'integrazione diretta con la piattaforma AIsuru, consentendo al tuo Agente di comunicare con altri agenti o funzionalità della piattaforma. Questo MCP è particolarmente utile per: * Creare architetture multi-agente; * Permettere la comunicazione tra diversi agenti; * Accedere a funzionalità avanzate della piattaforma AIsuru. #### Parametri di configurazione * **Backend URL**: ; * **Engine URL**: ; * **Tenant URL**: aisuru.com (SaaS) oppure il dominio del tuo tenant ([PaaS](/paas/vantaggi-della-paas.md)). #### Come utilizzare l'MCP di AIsuru per far conversare due Agenti se vuoi che il tuo Agente consulti un determinato agente, scrivilo nelle[ istruzioni](/ai-generativa/prompt-engineering.md), ad esempio: se vuoi contattare "Manuela" per le domande HR, scrivi nel prompt: *"Se l'utente chiede informazioni HR, rivolgi la domanda a Manuela (ID: b6fc6009-529f-42c1-91e6-5228f695fc81)"*. {% hint style="info" %} l'ID può essere recuperato in questi semplici step: * Selezione e apri il pannello laterale di un agente; * Sotto la voce impostazioni premi su "Dev docs"; * Una volta entrato in dev docs vedrai l'id del agente e un tasto per copiarlo negli appunti. {% endhint %} ## 2. Free Image Generator Il Free Image Generator permette al tuo Agente di generare immagini basate su descrizioni testuali utilizzando il servizio Pollinations.ai. Questo MCP è utile per: * Creare immagini personalizzate durante le conversazioni; * Generare contenuti visivi in base alle richieste degli utenti; * Arricchire le risposte con elementi grafici. #### Parametri di configurazione Questo MCP non richiede parametri obbligatori. La configurazione base è sufficiente per iniziare a generare immagini. #### Parametri personalizzati * **timeout**: Tempo massimo (in secondi) per generare l'immagine prima di interrompere la richiesta; * **retries**: Numero di tentativi automatici in caso di errore durante la generazione; * **defaultWidth**: Larghezza predefinita dell'immagine in pixel se non specificata dall'utente; * **defaultHeight**: Altezza predefinita dell'immagine in pixel se non specificata dall'utente; * **maxSize**: Dimensione massima consentita (in pixel) per larghezza e altezza dell'immagine. ```` ```json { "timeout": 60, "retries": 3, "defaultWidth": 1024, "defaultHeight": 1024, "maxSize": 2048 } ``` ```` {% hint style="info" %} Verifica i Termini e Condizioni del sito Pollinations.ai prima di utilizzare questo MCP in produzione. {% endhint %} ## 3. MCP Persistence Permette al tuo Agente di avere un **database personale** per salvare e recuperare informazioni in modo persistente tra le conversazioni. Questo MCP è particolarmente utile per: * Memorizzare preferenze e dati degli utenti; * Creare una knowledge base personalizzata; * Salvare cronologia e contesto tra sessioni diverse; * Gestire archivi di documenti e informazioni strutturate. #### Parametri di configurazione Questo MCP non richiede parametri obbligatori. La configurazione base è sufficiente per iniziare a generare immagini. #### Come utilizzare MCP Persistence Aggiungi istruzioni nel prompt per indicare all'Agente **cosa salvare e quando recuperare** i dati. **Esempi pratici:** ``` Salva le preferenze utente nel database ogni volta che l'utente le specifica. Prima di rispondere, cerca nel database se esistono informazioni sull'utente corrente. ``` L'Agente gestirà automaticamente le operazioni di lettura/scrittura sul database attraverso l'MCP. ## 4. MongoDB MCP Server Il MongoDB MCP Server consente al tuo Agente di connettersi a un database MongoDB ed eseguire operazioni di lettura e scrittura. Questo MCP è utile per: * Interrogare database MongoDB; * Memorizzare e recuperare dati durante le conversazioni; * Gestire dati strutturati in formato documento. #### Parametri | Parametro | Descrizione | Formato | Esempio | | ------------------- | ------------------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------- | | `Connection String` | Connection string completo di MongoDB | `mongodb://` o `mongodb+srv://` |

mongodb://localhost:27017/
mongodb+srv://user:/

| | `Database Name` | Nome del database da utilizzare | Stringa alfanumerica | `aisuru_test`, `production_db` | #### Come ottenere i parametri 1. **Dopo la registrazione**, crea un cluster (scegli il piano M0 Free); 2. Clicca su **"Connect"** sul tuo cluster; 3. Scegli **"Connect your application";** 4. Seleziona **Driver**: Node.js o Python; 5. Copia il **Connection String**: ``` mongodb+srv://:@cluster0.xxxxx.mongodb.net/ ``` 6. Sostituisci `` con la password del tuo database user; 7. **Database Name**: scegli tu (es. `test_db`, `aisuru`). #### Parametri personalizzati * **timeout**: Tempo massimo per completare un'operazione (ms); * **maxPoolSize**: Numero massimo di connessioni simultanee nel pool; * **minPoolSize**: Numero minimo di connessioni sempre attive; * **retryWrites**: Riprova automaticamente le scritture fallite; * **readPreference**: Da quale nodo leggere i dati (primary/secondary/nearest); * **maxIdleTimeMS**: Tempo massimo di inattività prima di chiudere una connessione (ms); * **serverSelectionTimeoutMS**: Tempo massimo per trovare un server disponibile (ms). ````json ```json { "timeout": 30000, "maxPoolSize": 10, "minPoolSize": 2, "retryWrites": true, "readPreference": "primary", "maxIdleTimeMS": 60000, "serverSelectionTimeoutMS": 30000 } ``` ```` ## 5. AIsuru Data Analysis AIsuru Data Analysis è un MCP JavaScript che supporta l'analisi di dati con ambiente di esecuzione isolato. Consente al tuo Agente di eseguire codice JavaScript/TypeScript per analisi complesse, elaborazioni e business intelligence. Questo MCP è utile per: * Analizzare dataset complessi; * Eseguire calcoli e aggregazioni; * Elaborare dati in tempo reale durante le conversazioni. #### Parametri di configurazione Questo MCP non richiede parametri obbligatori nella configurazione base. L'ambiente di esecuzione viene fornito automaticamente. #### Parametri personalizzati * **timeout**: Tempo massimo operazione (secondi); * **allowedFormats**: Formati file accettati. ````json ```json { "timeout": 120, "allowedFormats": ["json", "csv", "xlsx"] } ``` ```` #### Note importanti * Il codice viene eseguito in un ambiente isolato (isolated-vm); * Il timeout massimo è limitato a 128MB; * L'accesso a URL esterni è limitato; * Il codice può gestire sia espressioni semplici che codice complesso con variabili e refactoring; * Verifica sempre i limiti di memoria e timeout prima di utilizzare questo MCP per analisi intensive. ## 6. PostgreSQL MCP Server Il PostgreSQL MCP Server consente al tuo Agente di connettersi a database PostgreSQL ed eseguire operazioni di lettura e scrittura. Questo MCP è utile per: * Interrogare database relazionali PostgreSQL; * Eseguire query SQL complesse; * Gestire dati strutturati in tabelle relazionali. #### Parametri obbligatori | Parametro | Descrizione | Formato | Esempio | | ------------------- | ------------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `Connection String` | Connection string completo PostgreSQL | `postgresql://user:pass@host:port/db` |

postgresql://postgres:pass\@localhost:5432/mydb
postgresql://postgres::5432/postgres

| #### Parametri opzionali | Parametro | Descrizione | Default | Valori possibili | | ------------------------- | ---------------------------------------------- | ------------ | ------------------------------------------------------------------- | | `Access Mode` | Modalità di accesso al database | `read-write` | `read-write`, `read-only` | | `Ssl Mode` | Modalità SSL per la connessione | `prefer` | `disable`, `allow`, `prefer`, `require`, `verify-ca`, `verify-full` | | `Ssl Cert Path` | Percorso del certificato client SSL | - | `/path/to/client-cert.pem` | | `Ssl Key Path` | Percorso della chiave privata SSL | - | `/path/to/client-key.pem` | | `Ssl Ca Path` | Percorso del CA certificate | - | `/path/to/ca-cert.pem` | | `Ssl Reject Unauthorized` | Rifiuta connessioni con certificati non validi | `true` | `true`, `false` | #### Come ottenere i parametri 1. **Dopo la registrazione**, crea un nuovo progetto; 2. Vai su **Settings** (icona ingranaggio) → **Database;** 3. Copia la **Connection string** in formato URI: ``` postgresql://postgres:[YOUR-PASSWORD]@db.xxxxx.supabase.co:5432/postgres ``` 4. **Ssl Mode**: usa `require` (Supabase richiede SSL); **Nota su Supabase Connection Pooler**: * **Porta 5432**: Connessione diretta (per transazioni e operazioni complesse); * **Porta 6543**: Connection pooler (per applicazioni con molte connessioni simultanee). #### Parametri personalizzati * **poolSize**: Numero totale di connessioni nel pool; * **connectionTimeout**: Tempo massimo per stabilire una connessione (secondi); * **idleTimeout**: Tempo massimo di inattività connessioni (secondi); * **queryTimeout**: Tempo massimo per eseguire una query (secondi); * **statementTimeout**: Tempo massimo per uno statement SQL (ms); * **applicationName**: Nome identificativo dell'applicazione. ````json ```json { "poolSize": 20, "connectionTimeout": 30, "idleTimeout": 60, "queryTimeout": 60, "statementTimeout": 60000, "applicationName": "aisuru_mcp" } ``` ```` ## 7. n8n Workflow Server L'n8n Workflow Server permette al tuo Agente di accedere ai tools reali dei workflow n8n tramite supergateway. n8n è una piattaforma di automazione che consente di creare workflow complessi connettendo diversi servizi. Questo MCP è utile per: * Integrare workflow n8n esistenti; * Automatizzare processi complessi; * Collegare il tuo Agente a centinaia di servizi supportati da n8n. #### Parametri obbligatori | Parametro | Descrizione | Formato | Esempio | | -------------- | ------------------------------ | ----------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `Workflow Url` | URL del webhook o endpoint n8n | `https://` URL completo |


| #### Parametri opzionali | Parametro | Descrizione | Default | Esempio | | ------------------- | --------------------------------------------------- | ------- | ------------------------------------------ | | `Workflow Name` | Nome identificativo del workflow | - | `process_orders`, `sync_customers` | | `Supergateway Args` | Argomenti aggiuntivi per supergateway NPX | - | Parametri specifici per esecuzione via NPX | | `Auth Token` | Token di autenticazione (se il webhook lo richiede) | - | `Bearer token123...` | #### Come ottenere i parametri **Opzione A: n8n Cloud** 1. **Dopo la registrazione** e login su n8n Cloud 2. **Crea un workflow** con un nodo **Webhook** 3. Nel nodo Webhook: * Clicca su **"Webhook URLs"** * Copia l'**URL di produzione** o **test** #### **Parametri personalizzati:** * **timeout**: Tempo massimo per una richiesta (secondi); * **retries**: Numero di tentativi in caso di fallimento; * **retryDelay**: Pausa tra un tentativo e l'altro (ms); * **headers**: Header HTTP personalizzati da inviare. ````json ```json { "timeout": 60, "retries": 3, "retryDelay": 1000, "headers": { "X-Custom-Header": "value" } } ``` ```` ## 8. Fetch Url Fetch Url è uno strumento per recuperare informazioni da un link e convertirle in formato HTML, o markdown. Questo MCP è utile per: * Estrarre contenuti da pagine web; * Recuperare dati da API pubbliche; * Convertire contenuti web in formati elaborabili dall'Agente. #### Parametri di configurazione Questo MCP non richiede parametri obbligatori. La configurazione base permette di recuperare contenuti da qualsiasi URL pubblico. #### Note importanti Per maggiori informazioni sul funzionamento di questo MCP, consulta la documentazione su GitHub: `https://github.com/modelcontextprotocol/servers/tree/main/src/fetch`. ## 9. Microsoft SQL Server MCP Il Microsoft SQL Server MCP consente al tuo Agente di connettersi a database Microsoft SQL Server e Azure SQL. Supporta query SQL, gestione schema, metriche e sicurezza enterprise. Questo MCP è utile per: * Interrogare database SQL Server; * Eseguire query complesse su database enterprise; * Gestire dati in ambienti Microsoft Azure. #### Parametri obbligatori | Parametro | Descrizione | Formato | Esempio | | ------------- | --------------------------- | ------------------------------------------------------- | --------------------------------- | | `DB_HOST` | Indirizzo del server SQL | `nomeserver.database.windows.net` (Azure) o `localhost` | `aisuru-sql.database.windows.net` | | `DB_DATABASE` | Nome del database | Stringa alfanumerica | `aisuru_db`, `production` | | `DB_USER` | Username per autenticazione | `admin` o `admin@servername` | `sqladmin` | | `DB_PASSWORD` | Password dell'utente | Stringa complessa | `MySecureP@ssw0rd123!` | #### **Parametri opzionali** | Parametro | Descrizione | Default | Valori possibili | | ----------------------------- | ------------------------------- | ------- | ------------------- | | `DB_PORT` | Porta del server SQL | `1433` | Qualsiasi porta TCP | | `DB_ENCRYPT` | Abilita crittografia TLS/SSL | `true` | `true`, `false` | | `DB_TRUST_SERVER_CERTIFICATE` | Accetta certificati self-signed | `false` | `true`, `false` | | `CONNECTION_TIMEOUT` | Timeout connessione in secondi | `15` | 5-120 | | `REQUEST_TIMEOUT` | Timeout query in secondi | `15` | 5-300 | | `POOL_SIZE` | Dimensione connection pool | `10` | 1-100 | #### Come ottenere i parametri **Opzione A: Azure SQL Database (Cloud)** 1. **Dopo aver creato** un Azure SQL Database; 2. Vai su **Azure Portal** → **SQL databases** → seleziona il tuo database; 3. Nel menu laterale, clicca su **Connection strings;** 4. Troverai una stringa tipo: ``` Server=tcp:myserver.database.windows.net,1433; Initial Catalog=mydatabase; User ID=sqladmin; Password={your_password}; Encrypt=True; ``` 5. **Estrai i parametri**: * `DB_HOST`: `myserver.database.windows.net` * `DB_DATABASE`: `mydatabase` * `DB_USER`: `sqladmin` * `DB_PASSWORD`: la password che hai impostato * `DB_PORT`: `1433` (o lascia vuoto, usa default) * `DB_ENCRYPT`: `true` * `DB_TRUST_SERVER_CERTIFICATE`: `false` #### Parametri personalizzati * **connectionTimeout**: Tempo massimo per connettersi (secondi); * **requestTimeout**: Tempo massimo per una richiesta (secondi); * **poolSize**: Numero di connessioni nel pool; * **enableArithAbort**: Abilita interruzione calcoli aritmetici errati; * **trustServerCertificate**: Accetta certificati SSL self-signed. ````json ```json { "connectionTimeout": 15, "requestTimeout": 30, "poolSize": 10, "enableArithAbort": true, "options": { "trustServerCertificate": false, "enableArithAbort": true } } ``` ```` ## 10. Monday.com MCP Server Il Monday.com MCP Server consente al tuo Agente di interagire con la piattaforma Monday.com per gestire progetti, task e collaborazione del team. Questo MCP è utile per: * Creare e aggiornare task in Monday.com; * Recuperare informazioni su progetti; * Automatizzare la gestione del lavoro. #### Parametri | Parametro | Descrizione | Formato | Esempio | | ---------------- | --------------------------------------- | -------------------------- | ---------------------------------- | | `Workspace Name` | Nome del workspace Monday.com | Stringa | `Main Workspace`, `Marketing Team` | | `Api Key` | API token di autenticazione | Stringa alfanumerica lunga | `eyJhbGciOiJIUzI1NiJ9...` | | `Token Param` | Nome del parametro per passare il token | Stringa | `Authorization`, `api_token` | #### Come ottenere i parametri 1. **Dopo la registrazione** e login su Monday.com 2. **Workspace Name**: * Guarda nella sidebar a sinistra; * Vedrai il nome del workspace corrente (es. "Main Workspace", "Marketing Team"); * Usa esattamente quel nome; 3. **Api Key** (API Token): * Clicca sulla tua **foto profilo** (in basso a sinistra); * Seleziona **Admin** (se sei admin) o **Developers;** * Nel menu laterale, vai su **Developers** → **Token API;** * Oppure vai direttamente a: ; * Nella sezione **"Token API"**: * Clicca su **"Generate"** per creare un nuovo token ; * Oppure **"Show"** per vedere un token esistente; * Copia il token (inizia spesso con `eyJ...`); {% hint style="warning" %} **IMPORTANTE**: Salva il token in modo sicuro! {% endhint %} 1. **Token Param**: * Questo specifica come passare il token nelle richieste API; * Per Monday.com, usa: **`Authorization;`** * Il formato standard è: `Authorization: Bearer {token};` #### Esempio di configurazione completa ``` Workspace Name: Main Workspace Api Key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWI... Token Param: Authorization ``` #### Sicurezza API Token * L'API token ha **gli stessi permessi** dell'utente che lo ha generato; * Può accedere a tutte le board e workspace dell'utente; * Non condividere mai il token pubblicamente; * Ruota il token periodicamente per sicurezza; #### Informazioni aggiuntive **Trovare Workspace ID** (per riferimento): * URL: `https://mycompany.monday.com/workspaces/12345678` * L'ID è `12345678` **Trovare Board ID** (per riferimento): * URL: `https://mycompany.monday.com/boards/123456789` * L'ID è `123456789` #### Parametri personalizzati * **apiVersion**: Versione API da utilizzare; * **timeout**: Tempo massimo richieste (secondi); * **retries**: Tentativi in caso di errore; * **maxQueries**: Limite complessità query GraphQL; * **resetInterval**: Intervallo reset limite complessità (secondi). ````json ```json { "apiVersion": "2024-01", "timeout": 60, "retries": 3, "complexity": { "maxQueries": 100, "resetInterval": 60 } } ``` ```` ## 11. Salesforce MCP Server Il Salesforce MCP Server consente al tuo Agente di interagire con Salesforce tramite NPX. Permette di accedere ai dati e alle funzionalità di Salesforce utilizzando OAuth 2.0 Client Credentials. Questo MCP è utile per: * Recuperare informazioni da Salesforce CRM; * Aggiornare record e opportunità; * Automatizzare processi di vendita. #### **Parametri** | Parametro | Descrizione | Formato | Esempio | | ---------------------------- | ------------------------------------------------------ | ------------------------------------- | ----------------------------------- | | `Salesforce Client Id` | L'identificativo client OAuth 2.0 per l'autenticazione | `client_id_string` | `3MVG9xyz123abc...` | | `Salesforce Client Secret` | Il segreto client OAuth 2.0 | `client_secret_string` | `a1b2c3d4e5f6...` | | `Salesforce Instance Url` | L'URL della tua istanza Salesforce | `https://yourinstance.salesforce.com` | `https://company.my.salesforce.com` | | `Salesforce Connection Type` | Il tipo di connessione Salesforce da utilizzare | `oauth2` | `oauth2` | | | | | | #### **Parametri opzionali** | Parametro | Descrizione | Default | Esempio | | -------------------------- | --------------------------------------------------------------------------- | ------- | ------------------------------------------------------- | | `Parametri personalizzati` | Parametri aggiuntivi in formato JSON per timeout, retry, versione API, ecc. | `-` | `{"timeout": 30, "retries": 3, "api_version": "v58.0"}` | #### Parametri personalizzati * **apiVersion**: Versione API Salesforce; * **timeout**: Tempo massimo richieste (secondi); * **retries**: Tentativi in caso di errore; * **loginUrl**: URL di autenticazione (diverso per sandbox); * **maxRecords**: Numero massimo record per query. ```` ```json { "apiVersion": "v60.0", "timeout": 60, "retries": 3, "loginUrl": "https://login.salesforce.com", "maxRecords": 2000 } ``` ```` ## 12. Wikipedia L'MCP Wikipedia permette al tuo Agente di accedere direttamente ai contenuti di Wikipedia per recuperare informazioni enciclopediche. Questo MCP è utile per: * Arricchire le risposte con informazioni enciclopediche; * Fornire contesto su persone, luoghi o eventi; * Accedere a conoscenze verificate e strutturate. #### Parametri di configurazione Questo MCP non richiede parametri obbligatori. L'accesso a Wikipedia è pubblico e non necessita di autenticazione. #### Parametri personalizzati * **timeout**: Tempo massimo richieste (secondi); * **language**: Codice lingua Wikipedia (it, en, es, fr...); * **maxResults**: Numero massimo risultati ricerca; * **autoSuggest**: Abilita suggerimenti automatici ricerca. ```` ```json { "timeout": 30, "language": "it", "maxResults": 10, "autoSuggest": true } ``` ```` #### Note importanti L'Agente può utilizzare Wikipedia per recuperare informazioni aggiornate durante le conversazioni. I contenuti sono soggetti alle licenze e ai termini d'uso di Wikipedia. ## 13. Zapier MCP Server Il Zapier MCP Server consente al tuo Agente di accedere ai tools reali di Zapier tramite supergateway. Zapier permette di automatizzare workflow connettendo migliaia di applicazioni diverse. Questo MCP è utile per: * integrare Zapier nel tuo Agente; * automatizzare processi tra diverse applicazioni; * collegare servizi che non hanno MCP dedicati. {% hint style="warning" %} Al interno del pannello di configurazione del tuo MCP su [Zapier MCP](https://mcp.zapier.com/) ricordati di:
* Inserire "other" nella sezione riguardante il Client; * Andando nella sezione "connect" devi mettere come transport "SSE" {% endhint %} #### Parametri obbligatori | Parametro | Descrizione | Formato | Esempio | | -------------------- | --------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------- | | `Zapier Webhook Url` | L'URL completo del webhook Zapier | `https://` URL completo | `https://hooks.zapier.com/hooks/catch/123456/abcdef/`\
\
`http://localhost:5678/webhook/test` | #### **Parametri opzionali** | Parametro | Descrizione | Default | Esempio | | ------------------- | --------------------------------------------------- | ------- | ------------------------------------------ | | `Automation Name` | Nome identificativo dell'automazione Zapier | `-` | `process_orders`, `sync_customers` | | `Supergateway Args` | Argomenti aggiuntivi per supergateway NPX | `-` | Parametri specifici per esecuzione via NPX | | `Auth Token` | Token di autenticazione (se il webhook lo richiede) | `-` | `Bearer token123...` | #### Parametri personalizzati * **timeout**: Tempo massimo per una richiesta (secondi); * **retries**: Numero di tentativi in caso di fallimento; * **retryDelay**: Pausa tra un tentativo e l'altro (ms); * **headers**: Header HTTP personalizzati da inviare. ```` ```json { "timeout": 60, "retries": 3, "retryDelay": 1000, "headers": { "X-Custom-Header": "value" } } ``` ```` ### Best practices Quando configuri gli MCP per il tuo Agente, considera questi suggerimenti: * **Sicurezza**: non condividere mai API key, password o token di autenticazione. Utilizza sempre connessioni sicure (HTTPS, SSL/TLS) quando disponibili; * **Testing**: prova sempre la configurazione dell'MCP in un ambiente di test prima di utilizzarlo in produzione; * **Limitazioni**: verifica i limiti di rate (numero di richieste per minuto/ora) dei servizi esterni per evitare blocchi; * **Errori**: implementa una gestione degli errori appropriata nelle istruzioni dell'Agente per gestire eventuali problemi di connessione; * **Documentazione**: consulta sempre la documentazione ufficiale dei servizi esterni per comprendere le funzionalità disponibili e i requisiti di configurazione; * **Parametri personalizzati**: utilizza i parametri personalizzati in formato JSON per configurazioni avanzate, ma verifica sempre che siano supportati dall'MCP specifico. ### Limitazioni Gli MCP hanno alcune limitazioni da considerare: * **Timeout**: ogni richiesta a un MCP ha un timeout massimo oltre il quale viene interrotta; * **Rate limiting**: i servizi esterni potrebbero limitare il numero di richieste in un determinato periodo; * **Sicurezza dei dati**: i dati passati attraverso gli MCP potrebbero essere visibili ai servizi esterni. Non utilizzare MCP per dati sensibili senza verificare le policy di privacy del servizio; * **Disponibilità**: gli MCP dipendono dalla disponibilità dei servizi esterni. Se un servizio è offline, l'MCP non funzionerà; * **Versioni API**: alcuni servizi potrebbero deprecare versioni API. Mantieni aggiornata la configurazione degli MCP. ### Risoluzione problemi comuni #### L'MCP non si connette Verifica che: * Tutti i parametri obbligatori siano compilati correttamente; * Le credenziali (API key, password, token) siano valide e non scadute; * Gli URL siano corretti e raggiungibili; * Il servizio esterno sia online e funzionante. #### L'Agente non utilizza l'MCP Assicurati che: * L'MCP sia stato salvato correttamente dopo la configurazione; * Le istruzioni dell'Agente includano indicazioni su quando e come utilizzare l'MCP; * La richiesta dell'utente sia effettivamente gestibile dall'MCP configurato. #### Errori di autenticazione Controlla che: * Le credenziali siano state copiate correttamente senza spazi aggiuntivi; * Le API key non siano scadute o revocate; * I permessi associati alle credenziali includano le operazioni richieste. #### Timeout o lentezza Considera di: * Aumentare il valore del parametro `timeout` nei parametri personalizzati; * Verificare la connessione di rete; * Ottimizzare le query o le richieste per ridurre i tempi di elaborazione. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aisuru.com/avanzate/integrazioni/model-context-protocol-mcp-su-aisuru/mcp-di-aisuru-quali-sono-e-come-si-attivano.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.